OpenClaw 安装与飞书机器人接入指南
简介
OpenClaw（曾用名 ClawdBot、MoltBot）是一款开源个人 AI 助手。与传统聊天机器人不同，它具备真正的执行能力，能操作电脑完成任务，支持 24/7 全天候待命，数据完全由用户掌控。
支持多种通讯平台，包括 WhatsApp、Telegram、Discord 以及国内的飞书、钉钉等。
一、环境准备
1. 安装 Node.js
建议先安装 Node.js 环境以确保安装顺利。推荐使用 Node v22.x 以上版本。
官方下载地址：https://nodejs.org/
2. 设置 PowerShell 执行权限
以管理员身份运行 PowerShell：
- 按
Win键，搜索 PowerShell。 - 右键点击 Windows PowerShell，选择 以管理员身份运行。
- 在窗口中依次执行以下命令：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
注意：这些命令仅影响当前用户账户。
二、开始安装
复制以下命令，粘贴到 PowerShell 窗口中，按 Enter 执行：
iwr -useb https://openclaw.ai/install.ps1 | iex
安装过程会自动检测系统环境、安装依赖、下载核心文件并启动配置向导。
提示：如果报错，请确保已正确安装 Node.js 环境。
三、初始配置向导
安装完成后，自动进入 openclaw onboard 配置向导。
1. 风险告知
按向左方向键 ← 选择 Yes，按回车确认。
2. 选择 QuickStart 模式
选择默认模式继续。
3. 配置 AI 模型 API Key
OpenClaw 需要连接大语言模型。建议选择国内模型以降低 Token 成本，例如智谱 GLM。
前往官网注册账号获取 API Key：https://www.bigmodel.cn
输入您的 API Key。
4. 选择 AI 模型
选择默认的 GLM 4.7 或其他可用模型。
5. 连接即时通讯平台
此处可选择跳过，后续通过 UI 界面或插件单独配置飞书。
6. 选择 Skills
暂不配置，后续通过 UI 界面进行。
7. 是否开启 Hooks
按空格选中，回车确认。
8. 启动服务并打开 UI 界面
服务启动后，等待约 30 秒，在设置窗口选择 Open the Web UI 打开浏览器管理界面。
四、接入飞书机器人
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. 测试对话
在飞书客户端或 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
原因：可能是 Windows 下 npm 调用问题。
解决：定位代码文件 ...\node_modules\openclaw\dist\process\exec.js，修改 spawn 调用，增加 shell: true 参数处理 Windows 环境。
Q2: 提示'openclaw 命令找不到'
解决：关闭所有 PowerShell 窗口，重新打开；或执行 exec bash 后重试。
Q3: 端口 18789 被占用
解决：使用其他端口启动服务，例如：
openclaw gateway --port 18790
八、成本说明
软件本身免费，主要成本来自 AI 模型 API 调用，可选择国产大模型降低成本。
结语
OpenClaw 将 AI 从'聊天工具'进化为'执行工具'。虽然配置有一定门槛，但一旦完成设置，您将拥有一个 24/7 待命的超级助手。