Windows 环境部署 OpenClaw 并接入飞书机器人实战

四、飞书机器人配置

1. 安装插件

openclaw plugins install @m1heng-clawd/feishu

安装期间可继续配置飞书开放平台。

2. 创建应用

登录飞书开放平台，创建企业自建应用，填写名称与描述后提交。

3. 添加能力与权限

• 在应用详情页左侧添加'机器人'能力。
• 进入'凭证与基础信息'，记录 App ID 和 App Secret。
• 在'权限管理'中批量导入以下 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"]}}

此配置涵盖机器人所需的 8 项核心权限。

4. 事件订阅

进入'事件与回调'页面：

• 订阅方式选择'使用长连接接收事件'并保存。
• 注意：若报错'未建立长连接'，说明网关未运行，请先执行 openclaw gateway restart 等待 1-2 分钟。
• 添加事件 im.message.receive_v1，否则机器人无法接收消息。

5. 凭证绑定

在 OpenClaw 中配置飞书凭证（命令行示例）：

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

也可通过 Web 控制台 Channels 页面填入。

6. 发布与配对

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

openclaw pairing approve feishu 配对码

配对成功后，即可在飞书中与 AI 交互，或将其拉入群组共享使用。

五、排错与进阶

常用诊断命令

常见问题

• 插件安装失败：重启网关后重试，配合日志定位。
• 长连接报错：检查网关状态及防火墙是否拦截 18789 端口。
• 收不到消息：确认已添加 im.message.receive_v1 事件且应用已发布。
• Node.js 版本低：执行 nvm install 22 切换版本。

进阶技巧：发送图片

飞书原生支持有限，可通过 TOOLS.md 扩展能力。在工作区 TOOLS.md 中添加如下说明，AI 启动时会自动读取：

# 飞书发图片方法
用 exec 工具执行 curl 调飞书 API，分三步：
1. 获取 tenant_access_token
2. 上传图片获取 image_key
3. 发送图片消息
具体命令参考飞书开放平台文档。

这种自然语言说明书机制是 OpenClaw 的核心设计，灵活且易于维护。

总结

按照上述步骤，你已在 Windows 上完成了 OpenClaw 部署与飞书集成。虽然流程稍多，但掌握后能实现高效的聊天窗口指令自动化。遇到疑难杂症时，善用 openclaw logs follow 查看日志，通常能解决 90% 的问题。