OpenClaw 跨平台安装部署与常见问题解决

推荐使用 nvm 管理 Node 版本，更稳定：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
# 安装 Node.js 22 LTS
nvm install 22
nvm use 22

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 或系统找不到指定文件。

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

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

# 1. 直接启动网关（窗口保持打开，关闭则网关停止）
openclaw gateway run

# 2. 新开 CMD 窗口，启动仪表盘
openclaw dashboard

问题 3：Dashboard 自动打开失败

现象：执行 openclaw dashboard 提示已复制到剪贴板，但浏览器无反应。

原因：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"
}

注：name 为你的 Ollama 模型名（如 qwen2/phi3），apiKey 随便填，Ollama 不验证。

访问 Web Dashboard

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