OpenClaw 全平台安装部署教程（Windows/macOS/云服务器）

步骤 3：安装 OpenClaw

npm install -g openclaw@latest --registry=https://registry.npmmirror.com
openclaw --version # 验证

三、交互式配置向导（关键）

执行以下命令启动配置向导（Windows 需管理员身份）：

openclaw onboard --install-daemon

配置步骤（全平台通用）

1. 安全警告确认： 界面显示 OpenClaw 安全提示（beta 版、权限风险等），选择 Yes 继续（本地使用风险极低）。
2. 初始化模式： 选 QuickStart（快速开始，后续可通过 openclaw configure 改配置）。
3. 现有配置处理： 若提示「Existing config detected」，选 Use existing values 保留现有配置。
4. 模型/授权服务商选择：
   • 对接云端模型（如 MiniMax/Kimi/OpenAI）：选对应服务商，填写真实 API Key；
   • 对接本地模型（如 Ollama）：先选任意云端模型（如 MiniMax）占位，后续改配置文件（见下文）。
5. API Key 提供方式： 选 Paste API key now，随便填字符串（本地 Ollama 无需真实 Key，仅用于过验证）。
6. 聊天渠道配置： 选 Skip for now（暂时跳过 Telegram/WhatsApp 等渠道，本地使用无需配置）。
7. 技能配置： 选 No（跳过技能安装，后续需要再装）。
8. 钩子功能配置： 选 Skip for now（跳过扩展钩子，新手无需配置）。

四、Windows 环境常见问题及解决（踩坑实录）

问题 1：配置向导按回车无反应

现象

选中 Skip for now 后按回车，界面无任何变化。

原因

命令行交互界面需先「选中选项」再提交，而非直接回车。

解决

1. 用方向键（↑/↓）将光标移到目标选项（如 Skip for now）；
2. 按空格打勾（选项前出现 [x]）；
3. 再按回车提交。

问题 2：Gateway 服务启动失败（核心）

现象

执行 openclaw status 提示：

Gateway: unreachable (connect failed: connect ECONNREFUSED 127.0.0.1:18789)
Gateway service: Scheduled Task installed · missing · unknown (系统找不到指定文件)

原因

Windows 计划任务适配问题，OpenClaw 默认的服务安装命令失效。

解决

放弃系统服务方式，手动启动网关：

# 1. 直接启动网关（窗口保持打开，关闭则网关停止）
openclaw gateway run
# 2. 新开 CMD 窗口，启动仪表盘
openclaw dashboard

问题 3：Dashboard 自动打开失败

现象

执行 openclaw dashboard 提示「Copied to clipboard. Opened in your browser.」但浏览器无反应。

原因

Windows 浏览器默认设置未关联，OpenClaw 自动调起失败。

解决

手动复制提示中的 URL（如 http://127.0.0.1:18789/#token=xxx）到浏览器地址栏，直接访问即可。

五、对接本地 Ollama 模型（进阶）

若需对接本地 Ollama，需修改配置文件：

1. 找到配置文件路径：C:\Users\你的用户名\.openclaw\openclaw.json（Windows）；
2. 保存后重启网关：关闭之前的网关窗口，重新执行 openclaw gateway run。

用记事本打开，替换 model 段落：

{
  "model": {
    "provider": "openai",
    "name": "llama3",
    "apiBase": "http://localhost:11434/v1",
    "apiKey": "ollama-local"
  }
}

六、访问 Web Dashboard

• 本地部署：直接访问 http://127.0.0.1:18789；
• 云服务器部署：需配置反向代理/端口映射，或直接访问 http://服务器 IP:18789（确保 18789 端口开放）。