[特殊字符] Windows 安装 OpenClaw（龙虾）完整指南 – 踩坑版

OpenClaw 是免费开源项目，任何要求收费的都是骗子。AI 模型调用会消耗 Token，注意用量（通义千问新用户 100 万免费额度足够折腾很久）。遇到问题先看 Gateway 窗口的日志，90% 的错误都在那里有提示。祝你的龙虾干活麻利，听话不啰嗦！🦞。

莫不寒

414人浏览 · 2026-04-24 16:06:46

莫不寒 · 2026-04-24 16:06:46 发布

本文基于真实安装过程整理，帮你避开我遇到的所有坑。
软件本身完全免费，只需要准备一个 AI 模型的 API Key（推荐通义千问，国内网络友好）。

📦 一、准备工作

1.1 系统要求

Windows 10 / 11（64位）
管理员权限（部分操作需要）

1.2 安装 Node.js（如果还没装）

OpenClaw 依赖 Node.js 环境。
👉 下载地址：https://nodejs.org（选择 LTS 版本）
安装时一路默认即可，确保勾选“自动安装必要工具”。

1.3 获取 AI 模型 API Key（免费额度）

OpenClaw 本身免费，但需要调用大模型 API。
推荐：阿里云百炼（通义千问） – 新用户送 100 万 Token，国内网络稳定。

打开阿里云百炼控制台
用阿里账号登录，开通服务
左侧「API Key管理」→ 创建 API Key
⚠️ 复制保存好（格式：sk-xxxx）

其他可选：DeepSeek（原送500万Token，现已停止赠送，需充值）、智谱、MiniMax 等。

🖥️ 二、安装 OpenClaw

2.1 以管理员身份打开 PowerShell

右键点击「开始」→「Windows PowerShell (管理员)」
这一步非常重要，否则后续键鼠控制可能失败。

2.2 执行官方安装命令

powershell -c "irm https://openclaw.ai/install.ps1 | iex"

踩坑提醒：

如果出现 ECONNRESET 网络错误，先切换 npm 镜像源（国内用户）：
```
npm config set registry https://registry.npmmirror.com
npm cache clean --force
```
安装完成后会提示 OpenClaw installed successfully。

🧠 三、配置 AI 模型（以通义千问为例）

3.1 首次启动配置向导

openclaw onboard

跟着提示：

选择 DeepSeek 或直接跳过（我们用命令手动配）
一路选择 Skip for now（跳过搜索、技能依赖安装等，以后随时可加）

踩坑提醒：官方配置向导默认用 DeepSeek，但国内网络常连不上，且新用户不再送免费额度。
👉 建议直接手动配置通义千问，跳过向导的折磨。

3.2 手动修改配置文件（推荐）

配置文件位置：%USERPROFILE%\.openclaw\openclaw.json

用记事本打开：

notepad $env:USERPROFILE\.openclaw\openclaw.json

替换成以下完整内容（记得填入你的 API Key）：

{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\你的用户名\\.openclaw\\workspace",
      "models": {
        "qwen/qwen-plus": { "alias": "Qwen Plus" }
      },
      "model": { "primary": "qwen/qwen-plus" }
    }
  },
  "gateway": {
    "mode": "local",
    "pairing": { "autoApprove": ["127.0.0.1", "::1", "localhost"] },
    "auth": {
      "mode": "token",
      "token": "你的网关令牌（可随机生成）"
    },
    "port": 18789,
    "bind": "loopback",
    "controlUi": {
      "allowInsecureAuth": true,
      "allowedOrigins": ["http://127.0.0.1:18789", "http://localhost:18789"]
    }
  },
  "models": {
    "providers": {
      "qwen": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "api": "openai-completions",
        "apiKey": "sk-你的通义千问API Key",
        "models": [
          {
            "id": "qwen-plus",
            "name": "Qwen Plus",
            "reasoning": false,
            "maxTokens": 2048,
            "temperature": 0.3
          }
        ]
      }
    }
  }
}

如何获取网关令牌？
运行 openclaw doctor --generate-gateway-token 生成一个，复制粘贴到配置文件的 token 字段。

保存文件。

🚀 四、启动并测试

4.1 启动 Gateway（不要关闭）

openclaw gateway

看到类似 [gateway] ready 和 agent model: qwen/qwen-plus 即成功。

4.2 打开聊天界面（TUI）

新开一个 PowerShell 窗口，运行：

openclaw chat

进入黑底蓝字界面，输入 你好，如果能回复，说明一切正常。

踩坑提醒：

如果报 Connection error，多半是模型 API Key 无效或网络不通，检查通义千问额度。
如果报 pairing required，是因为你从浏览器访问 Web 控制台，但我们在 TUI 中使用，完全不用管。

🌐 五、Web 控制台（可选，但容易踩坑）

如果你想要图形界面，访问 http://127.0.0.1:18789/?token=你的网关令牌。

常见坑与解决：

origin not allowed：浏览器地址必须带上 ?token=...。
pairing required：即使设置了 autoApprove，仍可能因为代理头（X-Forwarded-For）被拦截。
解决方案：
- 在 gateway 中添加 "trustedProxies": ["127.0.0.1", "::1"]
- 或者直接禁用配对："pairing": { "enabled": false }（仅本地测试用）
WebSocket 连接失败：确保 Gateway 窗口一直开着，不要关。

真心建议：TUI 完全够用，不碰 Web 控制台省去 90% 的烦恼。

🔧 六、常见问题与踩坑汇总

现象	原因	解决办法
安装时 `ECONNRESET`	npm 源被墙	`npm config set registry https://registry.npmmirror.com`
Gateway 启动后模型仍是 deepseek	配置文件未正确修改	手动编辑 `openclaw.json`，重启 Gateway
`openclaw gateway restart` 报错 `SIGUSR1`	Windows 不支持该信号	手动 Ctrl+C 停止，再重新运行 `openclaw gateway`
TUI 中模型回复巨长	`maxTokens` 默认 65536	在配置文件中将 `maxTokens` 改为 1024 或 2048
回复全是英文	系统 prompt 默认英文	在聊天中输入 `/set language chinese`，或修改配置文件添加 `prompt` 字段
飞书接入后无响应	未发布应用或事件类型错误	必须选择「长连接」模式，并添加 `im.message.receive_v1` 事件
键鼠无法控制	权限不足	始终以管理员身份运行 PowerShell；关闭安全软件
Web 页面一直要求配对	代理头污染	要么用 TUI，要么在配置中禁用配对 `enabled: false`

🎉 七、开始使用

现在你可以在 TUI 里直接给它下达指令了：

帮我整理桌面文件，按类型分类
打开浏览器搜索 OpenClaw 教程
列出 C 盘下所有的 PDF 文件

如果想接入飞书，用命令行配置（不需要 Web 页面）：

openclaw config set channels.feishu.appId "cli_你的AppID"
openclaw config set channels.feishu.appSecret "你的AppSecret"
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.connectionMode websocket
openclaw gateway restart

然后在飞书开放平台配置「长连接」，搜索机器人并配对即可。