Windows 10 环境下 OpenClaw 安装全攻略：从零到一避坑指南

• AI科技 •

1. 前言

OpenClaw 是一款强大的 AI 网关工具，可以将各种 AI 模型（OpenAI, DeepSeek, Claude 等）集成到 Telegram、Discord 等平台。但在全新的 Windows 机器上安装，往往会遇到权限、依赖包以及网络环境的“多重毒打”。本文记录了我在 Win10 上安装 OpenClaw 并实现与公司 VPN 并存的完整过程。

2. 准备工作（必备组件）

在开始安装 OpenClaw 之前，请务必先安装以下三个核心组件。缺少任何一个都会导致后续报错。

  1. Node.js: 前往 nodejs.org 下载最新的 LTS 或 Current 版本并默认安装。
  2. Git for Windows: 前往 git-scm.com 下载并安装。安装时一路点击 “Next” 即可。
    • 坑点：npm 安装插件时需要 git 环境，不装会报 ENOENT: spawn git。
  3. Microsoft Visual C++ Redistributable:
    • 官方下载链接 (X64)
    • 坑点：OpenClaw 依赖本地 AI 组件 node-llama-cpp，没这个库会报内存崩溃错误 3221225477。

3. 第一阶段：安装与环境初始化

以管理员身份打开 PowerShell，按顺序执行以下步骤：

3.1 解除 PowerShell 脚本限制

Windows 默认禁止运行脚本，先解锁：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

3.2 使用 npm 安装 OpenClaw

建议使用国内镜像源以保证下载完整性：

npm install -g openclaw --registry=https://registry.npmmirror.com

提示：如果安装过程中卡住，请保持 V2ray 开启。如果报错，请尝试先执行 npm cache clean --force。

4. 第二阶段：向导配置 (Onboard)

输入以下命令进入初始化向导：

openclaw onboard --install-daemon

关键配置项建议：

  • Model Provider: 如果使用 New API 或 One API 中转站，选择 OpenAI (Codex OAuth + API key)。
  • Base URL: 必须带 /v1，例如 https://api.yourdomain.com/v1。
  • Endpoint ID: 起个好记的名字，如 my-deepseek。
  • Skills & Hooks: 初次安装建议全部选 Skip for now，待系统跑通后再去网页端开启。
  • Install Daemon: 务必选 Yes，这会让 OpenClaw 注册为 Windows 后台服务。

5. 第三阶段：进阶避坑——与公司 VPN 共存

痛点： 开启 V2ray 的 TUN 模式会和公司内网 VPN 冲突，且会拦截 127.0.0.1 导致无法访问 OpenClaw 管理页面。

解决方案：通过系统环境变量实现独立代理。

  1. 设置环境变量（在 PowerShell 执行）：
[Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://127.0.0.1:10809", "Machine")
[Environment]::SetEnvironmentVariable("HTTP_PROXY", "http://127.0.0.1:10809", "Machine")

(注：10808 是 V2ray 的默认 HTTP 端口。)

  1. 重启电脑：这一步非常重要，环境变量重启后生效。
  2. 日常使用逻辑：
    • 开启 V2ray（普通模式，关闭 TUN，关闭系统代理）。
    • 连接公司 VPN。
    • OpenClaw 会自动通过 10809 端口找 V2ray 上网，互不干扰。

6. 常见故障处理 (Troubleshooting)

Q1: 网页显示“离线”或“身份验证失败”？

原因：V2ray 拦截了本地流量或 Token 过期。
解决：

  1. 确保 V2ray 设置中勾选了“绕过局域网”或“绕过 127.0.0.1”。
  2. 执行 openclaw dashboard，系统会自动打开带正确 Token 的新链接。

Q2: 机器人不回群组消息，只回私聊？

原因：默认群组策略为白名单模式。
解决：

  1. 打开 C:\Users\用户名\.openclaw\config.json。
  2. 将 "groupPolicy": "allowlist" 修改为 "groupPolicy": "open"。
  3. 执行 openclaw gateway stop 然后 openclaw gateway 重启。

Q3: DeepSeek 回复非常慢？

建议：

  1. 确保在网页端开启了 Streaming (流式输出)。
  2. 检查 New API 中转站是否拥堵。
  3. 尝试更换为轻量级模型，如 deepseek-ai/deepseek-r1-distill-qwen-32b。

7. 总结

在 Windows 上折腾 OpenClaw，核心在于环境补丁（C++、Git）和网络隔离（环境变量代理）。一旦配好，通过 Telegram 机器人（指令 /settings）几乎可以完成所有日常操作，非常方便。

最后的小贴士： 遇到任何不确定的状态，先跑一下 openclaw status，它会告诉你哪里出了问题。

发布前记得检查你的 API Key 和 Bot Token 别泄露了哦！

下一篇 2025-07-13