[OpenClaw 文档]帮助--Node 运行时

2026年 6月 16日 OpenClaw SE_You

.ocdoc h2 { margin-top:2em; padding-bottom:.3em; border-bottom:2px solid #FF5A36; color:#FF5A36; }
.ocdoc h3 { margin-top:1.5em; color:#333; }
.ocdoc pre { background:#1e1e2e; color:#cdd6f4; padding:16px; border-radius:8px; overflow-x:auto; font-size:14px; line-height:1.6; }
.ocdoc code { font-family:'JetBrains Mono','Fira Code',Consolas,monospace; }
.ocdoc pre code { background:none; padding:0; color:inherit; }
.ocdoc :not(pre)>code { background:#f0f0f0; padding:2px 6px; border-radius:3px; font-size:.9em; color:#d63384; }
.ocdoc table { border-collapse:collapse; margin:1em 0; }
.ocdoc th,.ocdoc td { border:1px solid #ddd; padding:8px 12px; }
.ocdoc th { background:#f5f5f5; }
.ocdoc blockquote { border-left:4px solid #FF5A36; padding:.5em 1em; background:#fff7f4; color:#555; margin:1em 0; }
.ocdoc .page-sep { margin:2.5em 0; border:none; border-top:1px dashed #ccc; }
.ocdoc .page-title { color:#444; font-size:1.3em; margin-top:1em; padding:.4em .6em; background:#fafafa; border-left:4px solid #FF5A36; }
.ocdoc .src-link { font-size:.85em; color:#888; margin-top:2em; padding-top:1em; border-top:1px solid #e0e0e0; }
.ocdoc .toc-box { background:#f8f9fa; padding:1em 1.5em; border-radius:6px; margin:1em 0; }

本文档汇总了 OpenClaw 官方文档站帮助 > Node 运行时 子模块下的全部 1 篇内容，源自 docs.openclaw.ai/zh-CN。

📄 Node.js

原文：https://docs.openclaw.ai/zh-CN/install/node

OpenClaw 要求使用 Node 22.16 或更新版本。Node 24 是安装、CI 和发布工作流的默认且推荐的运行时。Node 22 仍通过 active LTS 系列受支持。安装脚本会自动检测并安装 Node - 本页适用于你想自行设置 Node，并确保所有内容正确连接时（版本、PATH、全局安装）。

检查你的版本

node -v

如果输出 v24.x.x 或更高版本，说明你正在使用推荐的默认版本。如果输出 v22.16.x 或更高版本，说明你正在使用受支持的 Node 22 LTS 路径，但我们仍建议在方便时升级到 Node 24。如果未安装 Node，或版本太旧，请从下面选择一种安装方法。

安装 Node

Homebrew（推荐）：

```bash
brew install node
```

或从 [nodejs.org](https://nodejs.org/) 下载 macOS 安装程序。

Ubuntu / Debian：

```bash
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs
```

**Fedora / RHEL：**

```bash
sudo dnf install nodejs
```

或使用版本管理器（见下文）。

winget（推荐）：

```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey：**

```powershell
choco install nodejs-lts
```

或从 [nodejs.org](https://nodejs.org/) 下载 Windows 安装程序。

版本管理器可让你轻松在多个 Node 版本之间切换。常用选项：

fnm - 快速、跨平台
nvm - 在 macOS/Linux 上广泛使用
mise - 多语言（Node、Python、Ruby 等）

fnm 示例：

fnm install 24
fnm use 24

确保你的版本管理器已在 shell 启动文件（~/.zshrc 或 ~/.bashrc）中初始化。如果没有初始化，新的终端会话中可能找不到 openclaw，因为 PATH 不会包含 Node 的 bin 目录。

故障排除

`openclaw: command not found`

这几乎总是表示 npm 的全局 bin 目录不在你的 PATH 中。

bash npm prefix -g

bash echo "$PATH"

在输出中查找 `<npm-prefix>/bin`（macOS/Linux）或 `<npm-prefix>`（Windows）。

添加到 ~/.zshrc 或 ~/.bashrc：

    ```bash
    export PATH="$(npm prefix -g)/bin:$PATH"
    ```

    然后打开一个新终端（或在 zsh 中运行 `rehash` / 在 bash 中运行 `hash -r`）。
  </Tab>
  <Tab title="Windows">
    通过 Settings → System → Environment Variables，将 `npm prefix -g` 的输出添加到系统 PATH。
  </Tab>
</Tabs>

`npm install -g` 上的权限错误（Linux）

如果你看到 EACCES 错误，请将 npm 的全局前缀切换到用户可写目录：

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

将 export PATH=... 这一行添加到你的 ~/.bashrc 或 ~/.zshrc，使其永久生效。