Install Guide
安装引导
适合第一次部署 OpenClaw，希望在一页内完成环境检查、安装方式选择、向导启动和初步验证。默认推荐 Node 22+ + openclaw onboard 的标准路径。
安装前确认
先确认运行环境，避免安装成功但 CLI、服务或渠道运行异常。
Node 22 或更新版本
OpenClaw 核心运行在 TypeScript + Node 之上。Bun 对 WhatsApp / Telegram 仍有兼容性问题，不建议用于 Gateway 网关。
优先使用 WSL2
Windows 原生路径问题更多。推荐在 WSL2 内执行 Linux 安装流程，并把服务也装在 WSL2 中。
CLI 足够，构建 App 需 Xcode / CLT
如果你只跑 CLI + Gateway，Node 即可；只有在你准备构建 macOS 配套应用时才需要额外工具链。
Brave Search API 与 Docker
网页搜索能力推荐配置 Brave Search API；Docker 仅在你需要容器化或特定 e2e 工作流时再装。
安装方式
如果你只是要稳定使用，优先脚本安装；如果你要参与开发或热重载，再走源码安装。
一键安装
最短路径，适合新手与日常部署。
curl -fsSL https://openclaw.ai/install.sh | bashnpm / pnpm 安装
适合已经有 Node 环境且更喜欢包管理器的场景。
npm install -g openclaw@latest
pnpm add -g openclaw@latest源码构建
适合你要跟踪最新代码、修改 Gateway 或本地调试。
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build标准安装顺序
如果你不确定下一步点什么，按这个流程推进即可。
1. 检查环境
确认 node -v 达到 22+，并确定你的部署位置是本机、WSL2、Linux 主机还是 VPS。
2. 完成安装
执行安装脚本或 npm / pnpm 全局安装，让 openclaw 命令可用。
3. 启动新手向导
运行 openclaw onboard --install-daemon，配置模型认证、Gateway、渠道与后台服务。
4. 验证控制界面
运行 openclaw gateway status 或 openclaw dashboard，确认你能连上本地或远程 Gateway。
5. 绑定渠道或继续使用 Dashboard
如果你需要 WhatsApp / Telegram / Discord 等消息入口，再进入渠道配置；否则可以先直接在 Control UI 开始聊天。