Windows 下安装 OpenClaw 并接入飞书机器人指南

接入飞书机器人

插件安装

openclaw plugins install @m1heng-clawd/feishu

此步骤可与后续飞书平台配置并行进行。

飞书开放平台配置

1. 创建应用：登录飞书开放平台，创建企业自建应用，填写名称与描述。
2. 添加能力：在应用详情页左侧导航栏添加'机器人'能力。
3. 获取凭证：进入'凭证与基础信息'，记录 App ID 和 App Secret。
4. 权限配置：在'权限管理'页面批量导入以下 JSON 权限：

{"scopes":{"tenant":["aily:file:read","aily:file:write","contact:user.employee_id:readonly","im:chat.access_event.bot_p2p_chat:read","im:chat.members:bot_access","im:message","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message:readonly","im:message:send_as_bot","im:resource"],"user":["aily:file:read","aily:file:write","im:chat.access_event.bot_p2p_chat:read"]}}

5. 事件订阅：
   • 选择'使用长连接接收事件'并保存。
   • 点击'添加事件'，搜索并勾选 im.message.receive_v1。

   • 注意：若报错'未建立长连接'，请检查 OpenClaw 网关状态并等待 1-2 分钟重试。

凭证绑定

方式一：命令行配置

openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
openclaw gateway restart

方式二：Web UI 配置

访问控制台 http://127.0.0.1:18789/，在通道设置中填入上述凭证。

发布与配对

1. 在飞书开放平台提交应用版本审批。
2. 在飞书客户端添加机器人，发送任意消息获取配对码。
3. 在 OpenClaw 控制台或命令行执行配对：

openclaw pairing approve feishu 配对码

配对成功后，即可在群聊或私聊中与机器人交互。

常用排错命令

遇到异常时，优先使用以下命令自查：

常见问题

插件安装失败？ 先重启网关 openclaw gateway restart，再查看日志 openclaw logs follow 定位原因。

飞书显示未建立长连接？ 通常因网关未启动或端口被防火墙拦截。确认 openclaw gateway status 为运行中，并检查 18789 端口。

收不到消息？ 检查三点：是否添加了 im.message.receive_v1 事件、应用版本是否发布、是否完成配对。

Node.js 版本不兼容？ 确保版本为 22+，执行 node --version 核对，低版本可通过 nvm 切换。

进阶技巧：发送图片

OpenClaw 默认工具在飞书发送本地图片时可能仅返回路径。可通过 TOOLS.md 机制扩展能力：在工作区 TOOLS.md 文件中加入自然语言指令，指导 AI 调用 curl 分步获取 token、上传图片并发送。每次启动时 AI 会读取该文件更新技能集。