夜雨聆风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 编写，不同版本命令可能略有差异。
