OpenClaw 简介
OpenClaw（曾用名 ClawdBot、MoltBot）是一款开源个人 AI 助手。其名称曾经历变更，因版权及传播问题最终定名为 OpenClaw。
一、什么是 OpenClaw？
OpenClaw 是一款开源个人 AI 助手，与传统 AI 聊天机器人的区别在于：
- 真正的执行能力：不仅能回答问题，还能实际操作电脑
- 24/7 全天候待命：在用户离线时也能主动完成任务
- 完全开源免费：数据完全掌控在自己手中
- 支持多种通讯平台：支持 WhatsApp、Telegram、Discord、Slack、iMessage 等，国内支持飞书、钉钉等即时通讯软件
它不只是回答问题的聊天机器人，而是能在电脑上动手操作。例如整理邮件、退订广告、预约行程或查找 Bug。你可以用钉钉、飞书、WhatsApp 等各类即时通讯软件指挥它。
二、安装 Node.js
执行一键安装命令可自动安装 Node.js，但为防止意外，建议先手动安装。
官方下载地址：https://nodejs.org/
三、开始安装
1. 设置 PowerShell 执行权限
以管理员身份运行 PowerShell：
- 按
Win键，搜索 PowerShell - 右键点击 Windows PowerShell
- 选择 以管理员身份运行
点击 是 确认。
在管理员 PowerShell 窗口中，依次执行以下两条命令：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
安全提示：这些命令只会影响您自己的账户，不会影响系统安全或其他用户。
2. 执行一键安装命令
复制以下命令，粘贴到 PowerShell 窗口中，按 Enter 执行：
iwr -useb https://openclaw.ai/install.ps1 | iex
安装过程会自动完成：
- 检测系统环境
- 安装必要依赖（Node.js 等）
- 下载 OpenClaw 核心文件
- 配置环境变量
- 启动配置向导
注意：如果命令执行后报错，请确保已安装 Node.js 环境，版本建议在 v22.x 以上。若不懂如何安装，请参考 Node.js 官网文档。
四、初始配置向导
安装完成后，会自动进入配置向导（openclaw onboard）。
1. 风险告知
系统会提示使用 OpenClaw 可能存在的风险，询问是否继续。按向左方向键 ←，选择 Yes，按 Enter 回车确认。
2. 选择 QuickStart 模式
选择快速启动模式。
3. 配置 AI 模型 API Key
OpenClaw 需要连接到大语言模型才能工作。建议选择国内大模型以降低 Token 成本。
如果没有 API Key，请访问智谱开放平台注册账号获取：https://www.bigmodel.cn/
输入自己的 API Key。
4. 选择 AI 模型
选择默认的 GLM-4 模型（智谱当前旗舰模型）。
5. 连接即时通讯平台
配置完 AI 模型后，OpenClaw 会询问要连接哪个通讯平台。
OpenClaw 原生支持 WhatsApp、Telegram、Discord 等，国内用户可选择飞书、钉钉。此处演示跳过，后续通过 UI 界面配置飞书。
6. 选择 Skills
选择 No，暂不配置，后续通过 UI 界面进行配置。
7. 是否开启 Hooks
操作步骤：先敲 空格 选中当前项，再敲回车键。
8. 启动服务并打开 UI 界面
此时会自动打开一个命令窗口来启动服务。
等待约 30 秒左右，回到设置窗口，选择 Open the Web UI，打开 OpenClaw 的 Web UI 界面。
浏览器自动打开 Web UI 界面。
9. 测试
在界面中进行初步测试。
五、接入飞书机器人
需要先前往飞书平台创建机器人。
1. 来到飞书开发者后台
飞书开放平台地址：https://open.feishu.cn
点击右上角进入 开发者后台。
2. 创建应用
点击创建新应用。
3. 填写应用信息
填写应用名称等信息。
4. 获取应用凭证
获取 AppID 和 AppSecret。
5. 给应用添加机器人
在应用中添加机器人组件。
6. 给应用配置权限
开通即时通讯相关的权限。
7. 创建版本并发布
创建版本并提交审批。
审批通过后，发布为在线应用。
8. 安装飞书插件
打开 PowerShell，输入以下命令安装飞书插件：
openclaw plugins install @m1heng-clawd/feishu
安装成功后，打开新的命令窗口，输入命令：openclaw config。
选择渠道，选择配置链接。
输入飞书的 AppID 和 AppSecret。
域名选择中国区域。
接受群组聊天。
选择完成，确认开启。
重启服务使配置生效。
9. 回到飞书后台设置事件回调
选择 使用长连接接收事件。
添加接收消息事件。
开通获取通讯录基本信息的权限。
重新发布版本为在线应用。
现在可以在飞书中与 AI 助手对话了。
10. 在飞书中与 OpenClaw 对话
在飞书客户端或手机 APP 上即可与机器人交互。
六、访问 Web 控制面板
配置完成后，PowerShell 窗口底部会显示控制面板链接，格式类似：
Control UI: http://127.0.0.1:18789
- 复制完整链接
- 在浏览器中打开
- 即可看到可视化 UI 管理界面
七、常用命令速查
| 命令 | 功能 |
|---|---|
openclaw onboard | 重新进入配置向导 |
openclaw status | 查看运行状态 |
openclaw health | 健康检查 |
openclaw gateway start | 启动服务 |
openclaw gateway stop | 停止服务 |
openclaw update | 更新到最新版本 |
openclaw doctor | 诊断问题 |
openclaw uninstall | 卸载 OpenClaw |
八、常见问题解答
Q1: 安装飞书插件提示：spawn npm ENOENT
问题原因：可能是 OpenClaw 的一个 bug。
解决步骤：定位问题代码并修改 spawn 调用。
文件路径：
C:\Users\Administrator\AppData\Roaming\fnm\node-versions\v22.14.0\installation\node_modules\openclaw\dist\process\exec.js
找到 runCommandWithTimeout 函数中的 spawn 调用，修改如下：
修改前：
const stdio = resolveCommandStdio({ hasInput, preferInherit: true });
const child = spawn(argv[0], argv.slice(1), { stdio, cwd, env: resolvedEnv, windowsVerbatimArguments });
修改后：
const stdio = resolveCommandStdio({ hasInput, preferInherit: true });
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 });
Q2: 提示'openclaw 命令找不到'
解决方法：
- 关闭所有 PowerShell 窗口
- 重新打开 PowerShell
- 如还不行，执行
exec bash或重启电脑
Q3: 安装卡住不动
解决方法：
- 按
Ctrl + C中断当前操作 - 执行
openclaw doctor检查问题 - 如提示网络问题，检查防火墙设置
Q4: API Key 配置错误
解决方法：
- 执行
openclaw onboard - 选择重新配置 API Key
- 确保密钥格式正确
Q5: 端口 18789 被占用
解决方法：
openclaw gateway --port 18790
使用其他端口启动服务。
九、成本说明
OpenClaw 软件本身完全免费，主要成本来自 AI 模型 API 调用，可选择国产大模型降低成本。
结语
OpenClaw 代表了个人 AI 助理的未来趋势——从'聊天工具'进化为'执行工具'。虽然配置过程有一定门槛，但一旦完成设置，您将拥有一个 24/7 待命的超级助手。
