关于 OpenClaw
曾用名：ClawdBot → MoltBot → OpenClaw（同一软件，勿混淆） 适用系统：Windows 10/11
OpenClaw 是一款开源个人 AI 助手，GitHub 星标已超 10 万。与普通聊天机器人的核心区别在于它具备真正的执行能力，不仅能回答问题，还能实际操作电脑，且支持 24/7 全天候待命。数据完全掌控在自己手中，支持国内平台如飞书、钉钉接入。
环境准备
建议提前手动安装 Node.js（版本 v22.x 以上），可加快后续安装速度并减少意外。 官方下载地址
安装 OpenClaw
配置 PowerShell 执行策略
以管理员身份运行 PowerShell，依次执行以下命令：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy Bypass -Scope Process
执行一键安装
iwr -useb https://openclaw.ai/install.ps1 | iex
安装过程会自动完成环境检测、依赖安装、文件下载及环境变量配置，随后进入配置向导。
初始配置向导
- 风险告知：按左方向键 ← 选择
Yes，回车确认继续。 - 模式选择：选择 QuickStart 模式。
- API Key 配置：推荐使用国内智谱 GLM 模型，成本低且门槛低。注册地址 bigmodel.cn，注册后获取 API Key 填入。
- 模型选择：选择
GLM-4.7或其他已有 Key 的模型。 - 跳过通讯平台：飞书配置较复杂，此处选
Skip，后续单独配置。 - 跳过 Skills 配置：选
No，后续通过 UI 界面配置。 - 开启 Hooks：按空格键选中，再按回车确认。
- 启动服务：等待约 30 秒，选择
Open the Web UI，浏览器自动打开管理界面 http://127.0.0.1:18789。
接入飞书机器人
创建飞书应用
- 打开飞书开放平台 open.feishu.cn。
- 点击右上角进入开发者后台，点击创建应用，填写名称和描述。
- 记录 App ID 和 App Secret。
添加机器人能力
在应用详情页找到添加应用能力，选择并添加机器人。
配置权限
在权限管理页面，开通即时通讯相关权限：
- 获取与发送单聊、群组消息
- 读取用户基本信息
- 获取通讯录基本信息
发布版本
- 在版本管理中创建新版本并提交发布，状态为在线应用。
- 前往飞书客户端完成审批。
安装插件
打开 PowerShell，执行：
openclaw plugins install @m1heng-clawd/feishu
配置插件
新开一个 PowerShell 窗口，执行 openclaw config，按向导依次完成：
- 选择渠道：飞书
- 选择配置链接：对应链接
- 填写凭证：App ID 和 App Secret
- 选择域名：中国区域
- 接受群组聊天：确认开启
- 完成配置：Yes → Open → 继续
配置完成后重启服务使配置生效：
openclaw gateway stop
openclaw gateway start
设置事件回调
- 回到飞书开放平台 → 应用详情 → 事件订阅。
- 选择使用长连接接收事件，点击添加事件，添加接收消息事件。
- 重新发布版本。
开始使用
打开飞书客户端，找到创建的机器人，直接发消息即可指挥 OpenClaw。
常用命令速查
| 命令 | 功能 |
|---|---|
openclaw onboard | 重新进入配置向导 |
openclaw status | 查看运行状态 |
openclaw health | 健康检查 |
openclaw gateway start | 启动服务 |
openclaw gateway stop | 停止服务 |
openclaw update | 更新到最新版本 |
openclaw doctor | 诊断问题 |
openclaw uninstall | 卸载 OpenClaw |
常见问题
Q：安装飞书插件提示 spawn npm ENOENT
这是 Windows 上的已知 bug。找到文件 C:\Users\你的用户名\AppData\Roaming\fnm\node-versions\v22.x.x\installation\node_modules\openclaw\dist\process\exec.js。
找到 runCommandWithTimeout 函数中的 spawn 调用，在其前面添加 Windows npm 兼容处理：
let command = argv[0];
let useShell = false;
if(process.platform === "win32" && path.basename(command) === "npm"){
useShell = true;
}
const child = spawn(command, argv.slice(1),{
stdio, cwd, env: resolvedEnv, shell: useShell
});
Q：提示"openclaw 命令找不到"
关闭所有 PowerShell 窗口，重新打开后重试。如仍不行，重启电脑。
Q：安装卡住不动
按 Ctrl+C 中断，执行 openclaw doctor 检查问题，确认防火墙设置是否阻止了网络请求。
Q：端口 18789 被占用
openclaw gateway --port 18790
换用其他端口启动服务。
费用说明
- OpenClaw 软件本身：完全免费
- 主要费用来源：AI 模型 API 调用（推荐使用智谱 GLM 等国内模型，成本更低）