# Bun

> 用于安装和运行包脚本的 Bun 工作流；运行时需要 Node

- 网址：https://funcoding.ai/agents/openclaw/install/bun/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/install/bun

---
<div class="callout callout-warning">

Bun 无法运行 OpenClaw CLI 或 Gateway 网关，因为它不提供所需的 `node:sqlite` API。请为所有 OpenClaw 运行时命令安装受支持的 Node 版本。

</div>

Bun 仍可用作可选的依赖安装程序和软件包脚本运行器。默认软件包管理器仍为 `pnpm`，它受到完全支持，并由文档工具使用。Bun 无法使用 `pnpm-lock.yaml`，并会忽略它。

## 安装

**安装依赖**

```sh
bun install
```

`bun.lock` / `bun.lockb` 已被 git 忽略，因此不会造成仓库变更。要完全跳过锁文件写入：

```sh
bun install --no-save
```

**构建和测试**

```sh
bun run build
bun run vitest run
```

启动 OpenClaw 本身的命令仍必须通过 Node 运行。

## 生命周期脚本

除非明确设为可信，否则 Bun 会阻止依赖项的生命周期脚本。对于此仓库，通常被阻止的脚本并非必需：

- `baileys` `preinstall`：检查 Node 主版本是否 >= 20（OpenClaw 要求 Node 22.22.3+、24.15+ 或 25.9+，推荐使用 Node 24）
- `protobufjs` `postinstall`：输出有关不兼容版本方案的警告（不生成构建工件）

如果遇到需要这些脚本的运行时问题，请明确将它们设为可信：

```sh
bun pm trust baileys protobufjs
```

## 注意事项

某些软件包脚本在内部硬编码了 `pnpm`（例如 `check:docs`、`ui:*`、`protocol:check`）。通过 `bun run` 运行它们时，仍会调用 shell 来执行 `pnpm`，因此直接通过 `pnpm` 运行这些脚本即可。

## 相关内容

- [安装概览](https://funcoding.ai/agents/openclaw/install/)
- [Node.js](https://funcoding.ai/agents/openclaw/install/node/)
- [更新](https://funcoding.ai/agents/openclaw/install/updating/)