OpenClaw 安装与飞书机器人接入实战
项目背景
OpenClaw（曾用名 ClawdBot、MoltBot）是一款开源个人 AI 助手。名称变更主要源于早期版权纠纷及域名保护问题，目前统一为 OpenClaw。
它与传统聊天机器人的区别在于具备执行能力。不仅能回答问题，还能操作电脑、处理邮件、管理日程等。支持多种通讯平台，包括 WhatsApp、Telegram 以及国内的飞书、钉钉等。
环境准备
虽然安装脚本会自动检测依赖，但建议提前安装 Node.js 以确保稳定性。
- 官方下载地址：https://nodejs.org/zh-cn/download
- 推荐版本：Node v22.x 以上
安装步骤
1. 设置 PowerShell 执行权限
以管理员身份运行 PowerShell：
- 按
Win键，搜索 PowerShell - 右键点击 Windows PowerShell
- 选择 以管理员身份运行
在窗口中依次执行以下两条命令（注意分开执行）：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy Process Bypass
说明：第一条允许当前用户运行本地和下载的脚本；第二条确保进程级权限不受限。这些命令仅影响当前账户，不会危及系统安全。
2. 执行一键安装
复制以下命令粘贴到 PowerShell 窗口并回车：
iwr https://openclaw.ai/install.ps1 | iex
安装过程将自动完成环境检测、依赖安装、核心文件下载及环境变量配置。
注意：若遇到报错，请检查 Node.js 版本是否满足要求。如仍无法解决，可手动从官网下载安装包。
初始配置向导
安装完成后，系统会自动启动配置向导（openclaw onboard）。
1. 风险告知
向导会提示潜在风险，确认继续请按方向键选择 Yes 并回车。
2. 选择模式
选择 QuickStart 模式即可快速进入配置流程。
3. 配置 AI 模型 API Key
OpenClaw 需要连接大语言模型。由于部分国外模型成本较高，国内用户推荐使用智谱 GLM 系列。
- 获取 Key：访问 https://www.bigmodel.cn 注册账号并申请 API Key。
- 输入 Key：在向导中输入您的密钥。
4. 选择模型
默认选择 GLM 4.7 或其他旗舰模型即可。
5. 连接通讯平台
此时会询问连接哪个平台。原生支持 WhatsApp、Telegram 等，国内用户可选择跳过，后续通过插件接入飞书。
6. 功能模块 (Skills)
暂时选择 No，后续可通过 Web UI 界面灵活配置。
7. Hooks 设置
根据需求开启 Hooks，通常保持默认或按需勾选。
8. 启动服务
配置完成后，服务会自动启动。等待约 30 秒后，在向导中选择 Open the Web UI 打开管理界面。
浏览器将自动跳转至控制面板，格式通常为 http://127.0.0.1:18789。
接入飞书机器人
若需使用飞书指挥 OpenClaw，需先在飞书开放平台创建应用。
1. 创建应用
访问飞书开放平台 https://open.feishu.cn，点击右上角进入开发者后台，创建新应用。
2. 填写信息
按指引填写应用名称、描述等信息，获取 AppID 和 AppSecret。
3. 添加机器人
在应用开发页面添加机器人组件，并配置所需权限（如消息接收、通讯录读取等）。
4. 发布审批
提交版本并发布，等待企业审批通过。
5. 安装飞书插件
回到 PowerShell，安装飞书插件：
openclaw plugins install @m1heng-clawd/feishu
6. 配置插件
新建命令窗口，输入 openclaw config，按向导选择渠道为飞书，填入 AppID 和 AppSecret，域名选择中国区。
7. 设置事件回调
返回飞书开发者后台，找到应用详情，配置事件订阅。
- 选择
使用长连接接收事件 - 添加
消息接收事件 - 重新发布版本
8. 重启服务
配置完成后重启 OpenClaw 服务，即可在飞书中与 AI 助手对话。
常用命令速查
| 命令 | 功能 |
|---|---|
openclaw onboard | 重新进入配置向导 |
openclaw status | 查看运行状态 |
openclaw health | 健康检查 |
openclaw gateway start | 启动服务 |
openclaw gateway stop | 停止服务 |
openclaw update | 更新到最新版本 |
openclaw doctor | 诊断问题 |
openclaw uninstall | 卸载 OpenClaw |
常见问题解答
Q1: 安装飞书插件提示 spawn npm ENOENT
原因：Windows 下 npm 调用可能存在兼容性问题。
解决：修改源码中的 exec.js 文件。
路径示例：C:\Users\Administrator\AppData\Roaming\fnm\node-versions\v22.14.0\installation\node_modules\openclaw\dist\process\exec.js
找到 spawn 调用处，增加 shell: true 参数：
const child = spawn(command, argv.slice(1), {
stdio,
cwd,
env: resolvedEnv,
shell: true // Windows 下必须启用 shell
});
Q2: 提示'openclaw 命令找不到'
解决：
- 关闭所有终端窗口
- 重新打开 PowerShell
- 若无效，尝试执行
exec bash或重启电脑刷新环境变量
Q3: 端口 18789 被占用
解决：指定其他端口启动：
openclaw gateway --port 18790
结语
OpenClaw 将 AI 从'聊天工具'进化为'执行工具'。虽然初期配置有一定门槛，但一旦部署成功，它将是一个 24/7 待命的超级助理。
