Windows 安装 OpenClaw 实战指南

Windows 安装 OpenClaw 实战指南

这篇文章记录我在 Windows 上安装和使用 OpenClaw 的完整流程。
目标：安装成功 -> 跑起 Gateway -> 打开控制台 -> 配置可用大模型。

最终安装效果图
打开openclaw http://127.0.0.1:18789/#token=xxx

---

一、安装前准备

OpenClaw 在 Windows 上最关键的依赖是 Node.js 22+。
Python 不是 OpenClaw 本体必须依赖（除非你还有其他 Python 项目需求）。

先检查版本：

node -v
npm -v

如果 Node 版本小于 22，先升级后再继续。

---

二、安装 OpenClaw

推荐安装命令：

npm install -g openclaw@latest

安装后验证：

openclaw --version

---

三、初始化向导（必须）

执行：

openclaw onboard --install-daemon

向导建议选择：

1. Onboarding mode: Manual
2. Set up: Local gateway (this machine)
3. Model/Auth: 选择你的模型提供商（OpenAI / Anthropic / Ollama / 自定义兼容）
4. Gateway auth: 开启 token（推荐）

---

四、启动与验证 Gateway

openclaw gateway status
openclaw dashboard

默认控制台地址一般是：

• http://127.0.0.1:18789/

---

五、如何配置“使用哪个大模型”

方案 1：OpenAI API Key

$env:OPENAI_API_KEY="sk-xxx"
openclaw onboard --auth-choice openai-api-key

方案 2：自定义 OpenAI 兼容地址（第三方网关/代理）

建议用单行命令，避免 PowerShell 换行转义问题：

$env:CUSTOM_API_KEY="your-key"; openclaw onboard --auth-choice custom-api-key --custom-compatibility openai --custom-provider-id myproxy --custom-base-url "https://your-endpoint/v1" --custom-model-id "gpt-4o"

方案 3：本地模型（Ollama）

$env:OLLAMA_API_KEY="ollama-local"

然后在模型里选择类似：

• ollama/llama3.3
• ollama/qwen2.5-coder:32b

---

六、常见报错与解决

报错：unauthorized: gateway token missing

现象：Dashboard 能打开，但聊天页提示未授权。
原因：Control UI 没有携带/保存 Gateway Token。

处理步骤：

1. 重新执行 openclaw dashboard，用命令返回的完整 URL 打开
2. 在 Control UI 设置中填入 Gateway Token 并保存
3. 刷新页面
4. 仍失败时，重新执行：

openclaw onboard --install-daemon

---

七、日常运维命令

openclaw doctor
openclaw gateway status
openclaw logs follow
openclaw dashboard

---

总结

Windows 下 OpenClaw 稳定运行，关键就三件事：

1. Node.js 版本正确（22+）
2. 首次 onboarding 配置完整（尤其 gateway token）
3. 模型提供商 key 和 base_url 配置正确

把这三点做好，OpenClaw 基本就能顺利用起来。