Windows 环境安装 OpenClaw 完整教程

📌 15 分钟搞定，AI 助手跑起来

01 为什么需要这篇教程？

OpenClaw 的官方文档主要面向 Linux/Mac 用户，但很多开发者日常使用的是 Windows。

Windows 安装 OpenClaw 有几个特有的坑：

❌ Node.js 版本不兼容
❌ 环境变量配置复杂
❌ 权限问题导致 Gateway 启动失败
❌ 中文路径引发各种报错

这篇教程就是帮你避开所有坑，一次性安装成功。

02 前置准备

系统要求

项目	要求
操作系统	Windows 10/11（64 位）
内存	至少 4GB（推荐 8GB+）
磁盘空间	至少 5GB 可用空间
网络	需要访问 npm 和 GitHub

必装软件

1️⃣ 安装 Node.js（v20+）

步骤：

访问官网：https://nodejs.org/^[1]
下载 LTS 版本（推荐 v20.x 或 v22.x）
运行安装程序，保持默认选项
安装完成后，打开命令提示符验证：

node -v
npm -v

✅ 看到版本号说明安装成功

⚠️ 重要：不要用 Windows 自带的 PowerShell 管理员模式，普通用户权限即可

2️⃣ 安装 Git（可选但推荐）

步骤：

访问官网：https://git-scm.com/download/win^[2]
下载并安装
验证安装：

git --version

03 安装 OpenClaw

方式一：npm 全局安装（推荐）

打开命令提示符（cmd），执行：

npm install -g openclaw

安装完成后验证：

openclaw --version

✅ 看到版本号说明安装成功

方式二：源码安装（高级用户）

适合需要修改源码或开发技能的用户：

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git

# 进入目录
cd openclaw

# 安装依赖
npm install

# 全局链接
npm link

04 配置 OpenClaw

1️⃣ 创建工作区

# 创建工作目录
mkdir openclaw-workspace
cd openclaw-workspace

# 初始化工作区
openclaw init

2️⃣ 配置 Gateway

Gateway 是 OpenClaw 的核心服务，负责消息收发。

配置文件位置： ~/.openclaw/config.json

Windows 路径示例： C:\Users\你的用户名\.openclaw\config.json

最小配置：

{
  "gateway": {
    "port": 3000,
    "host": "localhost"
  },
  "channels": [
    {
      "type": "feishu",
      "appId": "你的 AppID",
      "appSecret": "你的 AppSecret"
    }
  ]
}

🔑 获取 Feishu 配置：在飞书开放平台创建应用，获取 AppID 和 AppSecret

3️⃣ 配置环境变量（可选）

如果需要在任何目录使用 openclaw 命令，确保 npm 全局目录在 PATH 中：

右键此电脑 → 属性 → 高级系统设置
点击环境变量
在系统变量中找到 Path
添加：C:\Users\你的用户名\AppData\Roaming\npm

05 启动 Gateway

启动命令

openclaw gateway start

验证启动成功

openclaw gateway status

✅ 看到 running 状态说明启动成功

常见问题

❌ 问题 1：端口被占用

错误信息： Error: Port 3000 is already in use

解决方案：

# 方法 1：关闭占用端口的程序
netstat -ano | findstr :3000
taskkill /F /PID <进程 ID>

# 方法 2：更换端口
openclaw gateway start --port 3001

❌ 问题 2：权限不足

错误信息： EACCES: permission denied

解决方案：

不要用管理员身份运行 cmd
确保工作区目录有写入权限
检查杀毒软件是否拦截

❌ 问题 3：中文路径报错

错误信息： 各种奇怪的编码错误

解决方案：

工作区目录不要包含中文
推荐使用：C:\openclaw-workspace

06 安装技能

OpenClaw 的能力来自技能（Skills）。

查看可用技能

openclaw skills list

安装技能

# 从 ClawHub 安装
openclaw skills install <技能名>

# 示例：安装天气技能
openclaw skills install weather

验证技能

openclaw skills list --bindings

07 测试运行

发送测试消息

配置完成后，在飞书群组中 @你的机器人，发送：

你好

如果机器人回复，说明安装成功！🎉

查看日志

# 实时查看日志
openclaw logs --follow

# 查看最近 100 条
openclaw logs --limit 100

08 常用命令速查

命令	说明
`openclaw --version`	查看版本
`openclaw gateway start`	启动 Gateway
`openclaw gateway stop`	停止 Gateway
`openclaw gateway restart`	重启 Gateway
`openclaw gateway status`	查看状态
`openclaw skills list`	查看技能
`openclaw skills install <name>`	安装技能
`openclaw logs --follow`	实时日志
`openclaw doctor`	诊断问题

09 安全提醒与注意事项

🔐 敏感信息保护

AppSecret 和 API Key 不要泄露：

❌ 不要上传到 GitHub 等公开仓库
❌ 不要在群聊中直接发送完整密钥
✅ 使用环境变量或加密存储
✅ 定期轮换密钥

⚠️ 网络安全建议

Gateway 暴露风险：

默认情况下 Gateway 只监听 localhost
如需远程访问，建议通过 Tailscale 等内网穿透工具
不要直接将 Gateway 端口映射到公网

🛡️ 权限最小化原则

运行权限：

✅ 使用普通用户权限运行（不要用管理员）
✅ 工作区目录设置合适的访问权限
✅ 技能安装前检查来源和权限

📦 技能安装注意事项

只安装可信来源的技能：

优先从 ClawHub 官方市场安装
检查技能的权限要求
警惕需要敏感权限的技能（如文件读写、网络访问）

🔄 定期更新

保持系统和技能最新：

# 更新 OpenClaw
npm update -g openclaw

# 同步技能到最新版本
openclaw skills sync

📋 备份建议

定期备份配置文件：

~/.openclaw/config.json
工作区重要文件
自定义技能配置

10 资源链接

资源	链接
OpenClaw 官网	https://openclaw.ai^[3]
GitHub 仓库	https://github.com/openclaw/openclaw^[4]
官方文档	https://docs.openclaw.ai^[5]
技能市场	https://clawhub.com^[6]
社区 Discord	https://discord.com/invite/clawd^[7]

总结

Windows 安装 OpenClaw 的关键点：

✅ Node.js 版本选 LTS（v20+）
✅ 工作区目录用英文路径
✅ 普通用户权限运行 cmd
✅ 配置好飞书 AppID/AppSecret
✅ 用 openclaw doctor 诊断问题

按照本教程，15 分钟内即可完成安装并开始使用！

本文基于 OpenClaw v1.x 编写，不同版本命令可能略有差异。