跳转到内容
最近更新

OpenClaw 飞书 / Lark 接入指南

当你需要把 OpenClaw 放进飞书或 Lark 团队环境时，这份指南就是更合适的起点。和 Telegram 相比，飞书路径更依赖应用权限、插件兼容性和连接模式，因此更适合组织内部工作流，而不是随手验证。

为什么飞书 / Lark 的接入方式不同

  • 你需要的是企业自建应用，而不仅是一个机器人 token
  • 权限、事件订阅和连接模式与运行时配置同样重要
  • 一般建议先用 WebSocket 模式跑通，再考虑 Webhook 模式

Step 1：创建企业自建应用

  • 在 Open Platform 创建应用并拿到 App ID / App Secret
  • 开启消息事件、机器人能力等必要权限

Step 2：安装飞书插件

Command
openclaw plugins install @m1heng-clawd/feishu

Step 3：配置 WebSocket 模式

Command
openclaw config set channels.feishu.appId "YOUR_APP_ID"openclaw config set channels.feishu.appSecret "YOUR_APP_SECRET"openclaw config set channels.feishu.enabled trueopenclaw config set channels.feishu.connectionMode websocket

Step 4：重启 gateway

Command
openclaw gateway restart

Step 5：在聊天里验证

  • 把机器人加入群聊或私聊
  • 发送 @机器人 现在几点？

常见飞书 / Lark 问题

  • 个人账号限制 -> 优先使用企业管理员账号
  • 插件不兼容 -> 更新 OpenClaw 或手动安装插件
  • 收不到事件 -> 检查权限、密钥与 WebSocket 连接状态
  • 运行时或中继问题 -> 对照 /docs/troubleshooting 和 /docs/advanced-config

Webhook 模式（需要公网 HTTPS）

如果你需要事件订阅 Webhook 模式，请继续查看 /docs/feishu-webhook-tunnel。

相关链接