安装

内容来源：OpenClaw 官方安装文档，已按中文使用场景整理。

推荐安装（Installer Script）

官方推荐方式，自动检测系统环境、按需安装 Node 并启动 onboarding。

macOS / Linux / WSL2：

curl -fsSL https://openclaw.ai/install.sh | bash

如果希望跳过 onboarding：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

系统要求

• Node：推荐 Node 24，最低 Node 22.16+（安装脚本会自动处理）
• 操作系统：macOS、Linux、Windows（含原生 Windows 与 WSL2，官方推荐 WSL2 更稳定）
• pnpm：仅在从源码构建时需要

替代安装方式

1. npm / pnpm 全局安装

如果已自行管理 Node 环境：

npm install -g openclaw@latest
openclaw onboard --install-daemon

2. 从源码安装（适合贡献者）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon

也可以不执行 pnpm link --global，直接在仓库目录内用 pnpm openclaw ... 运行。

3. 从 GitHub main 安装

npm install -g github:openclaw/openclaw#main

安装后验证

openclaw --version      # 确认 CLI 可用
openclaw doctor         # 检查配置问题
openclaw gateway status # 验证 Gateway 是否运行

常见问题：openclaw not found

安装成功但命令找不到时，依次排查：

node -v           # Node 是否已安装？
npm prefix -g     # 全局包安装路径
echo "$PATH"      # 全局 bin 是否在 PATH 中？

若 $(npm prefix -g)/bin 不在 $PATH 里，在 ~/.zshrc 或 ~/.bashrc 中加入：

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

重新打开终端后生效。Windows PowerShell 用户及更多参数说明请参阅官方原文。