安装 OpenClaw
使用官方脚本、PowerShell 安装程序或 npm 安装 openclaw CLI,然后通过初始化向导创建配置、网关 token 和后台服务。
通过 npm 安装需要 Node.js 24.16+ 或 26.1+;安装脚本会为你安装 Node。建议至少配备 1 vCPU、1 GB RAM 和 500 MB 磁盘空间。
在 macOS、Linux 或 WSL2 上运行安装程序
脚本会在需要时安装 Node(macOS 上安装 Node 26,Linux 上安装 Node 24 LTS)和 openclaw CLI,然后启动初始化向导。如需跳过向导进行安装,请将命令改为通过管道传入 bash -s -- --no-onboard,而不是直接传入 bash。
shell curl -fsSL https://openclaw.ai/install.sh | bash或在 Windows 上使用 PowerShell
在原生 Windows 环境中,打开 PowerShell 窗口并运行 PowerShell 安装程序。也可以使用原生 Windows Hub 应用;在 WSL2 中则可以改用第 1 步中的 shell 脚本。
PowerShell iwr -useb https://openclaw.ai/install.ps1 | iex或使用 npm 安装
如果你自行管理 Node,请全局安装此软件包。npm 12 和 11.16+ 需要添加 --allow-scripts=openclaw;npm 11.15 或更早版本则不要添加此标志。运行 onboard --install-daemon 会启动向导并安装服务:在 macOS 上安装 LaunchAgent,在 Linux 和 WSL2 上安装 systemd 用户服务,在 Windows 上安装计划任务。
shell npm install -g openclaw@latest --allow-scripts=openclaw openclaw onboard --install-daemon检查安装
openclaw --version 会显示已安装的版本,openclaw doctor 会运行健康检查,openclaw gateway status 会报告网关服务是否正在运行。版本号采用日期格式,形式为 YYYY.M.N。
shell openclaw --version openclaw doctor openclaw gateway status保持最新
openclaw update 会安装最新版本。使用 --channel 可在 stable、extended-stable、beta 和 dev 通道之间切换;使用 --dry-run 可预览更新而不实际应用。你也可以使用 openclaw update status 和 openclaw update repair。
shell openclaw update openclaw update --channel beta openclaw update --dry-run
初始化向导会生成网关 token,并将网关绑定到 127.0.0.1:18789。连接聊天渠道前,请先阅读安全加固指南。