OpenClaw 安装

本页目标

学完这一页，你能够安装 OpenClaw、完成模型 onboarding，并用状态命令确认 Gateway 已运行。

开始前

准备 macOS、Linux、WSL2 或 Windows PowerShell。OpenClaw 要求 Node.js 22.19+、23.11+ 或 24+，官方安装器可自动处理 Node。onboarding 还需要一个可用的模型提供商登录或 API key；不要把密钥写进教程、截图或聊天记录。

验证说明

验证说明： 下列命令已逐项对照官方安装、Getting Started 与 Windows 文档，但本次未实际下载安装器、依赖或 daemon，也未完成模型 OAuth/API key 和 Gateway 启动。端口与成功条件来自官方说明，不是本机运行结果。

跟着做

为避免默认安装器自动打开向导后又重复 onboarding，这里使用官方 --no-onboard 选项，再显式安装 Gateway 服务。

macOS、Linux 或 WSL2 的 Bash：

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

Windows PowerShell：

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
openclaw onboard --install-daemon
openclaw gateway status

在 onboarding 中选择模型提供商并按遮罩提示完成认证。初次只使用本地 Control UI 时，可以跳过 Telegram、WhatsApp 等可选渠道，之后再用 openclaw configure 添加。

结果检查

官方 Getting Started 以 openclaw gateway status 显示 Gateway 正在监听 18789 端口作为检查点。若命令不存在，先重开终端并检查 PATH；若服务未运行，重新执行 onboarding，阅读失败原因后再继续。

常见问题

Windows 也可使用 Windows Hub；官方支持 Windows 10 20H2+ 和 Windows 11。需要更接近 Linux 的 Gateway 运行环境时，可选择 WSL2。

练习

本页小结

安装由官方脚本、显式 onboarding 和状态检查三步组成。先完成本地 Gateway 与模型认证，消息渠道和更多工具可以以后再配置。