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

1. 前言

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

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

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

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

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

第一步：设置 Windows 全局环境变量（永久生效）
为了让 OpenClaw 所有的模块（包括 Telegram、Gemini、搜索插件等）都走 V2ray，我们需要在 Win10 系统里设置代理变量。

以管理员身份打开 PowerShell，解除 PowerShell 脚本限制并安装。
安装包接近1GB需要时间，耐心等待。

这条指令合成了：解除脚本限制 + 切换国内源。

powershell -NoProfile -ExecutionPolicy Bypass -Command "Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force; npm config set registry https://registry.npmmirror.com --global; iwr -useb https://openclaw.ai/install.ps1 | iex"

3. 设置 Windows 全局环境变量（永久生效）

为了让 OpenClaw 所有的模块（包括 Telegram、Gemini、搜索插件等）都走 V2ray，我们需要在 Win10 系统里设置代理变量。

【环境变量-系统变量】区域，点击 “新建”，分别添加以下三个变量：

name	value
HTTP_PROXY	http://127.0.0.1:10808
HTTPS_PROXY	http://127.0.0.1:10808
ALL_PROXY	socks5://127.0.0.1:10808

点击确定，保存所有设置。
验证：$env:HTTP_PROXY

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

系统维护与诊断：

openclaw onboard        初始化向导
openclaw doctor            自动诊断
openclaw doctor --fix    自动修复
openclaw status            查看当前的全局运行健康状况
openclaw update            更新OpenClaw
openclaw logs --follow    实时查看运行日志

网关管理：

openclaw gateway start    启动网关服务。
openclaw gateway restart    重启网关
openclaw gateway stop      停止网关服务。
openclaw gateway install    将网关安装为系统服务开机自启

模型管理：

openclaw models list    列出所有已配置和可用的模型
openclaw models status    检查模型连接状态和配额使用情况
openclaw models set <model_id>    设置当前默认的主力模型
openclaw models auth add    交互式添加新的模型供应商API Key。

5. skill配置

名称	描述	指令
Skill Vetter (必选)	针对人工智能代理的安全优先技能审查。在从 ClawdHub、GitHub 或其他来源安装任何技能之前，请使用此功能。它会检查是否存在危险信号、权限范围和可疑模式。	npx clawhub@latest install skill-vetter
self-improving-agent(必选)	记录经验教训、错误和纠正措施，以实现持续改进	git clone https://github.com/peterskoett/self-improving-agent.git ~/.openclaw/workspace/skills/self-improving-agent
Multi Search Engine(必选)	支持集成17个搜索引擎（8个中国搜索引擎+9个全球搜索引擎）。支持高级搜索运算符、时间筛选、站内搜索、隐私保护搜索引擎以及WolframAlpha知识库查询。无需API密钥	npx clawhub@latest install multi-search

6. 谷歌浏览器配置 (可选)

配置文件通常位于： ~/.openclaw/openclaw.json

其它配置：

开启谷歌浏览器mcp,访问并勾选：

chrome://inspect/#remote-debugging

openclaw.json配置文件添加：

"browser": {
  "enabled": true,
  "defaultProfile": "user",
  "profiles": {
    "user": {
      "driver": "existing-session",
      "attachOnly": true,
      "color": "#00AA00"
    }
  }
},