OpenClaw 飞书对接完全指南：10分钟搭建企业AI助手(2026最新)

飞书是字节跳动旗下的企业协作平台，在国内互联网、科技、教育等行业拥有数千万用户。相比Telegram和Discord需要翻墙才能使用，飞书在国内可直接访问，是国内企业部署AI助手的最佳选择。

OpenClaw从2026.2.2版本开始官方支持飞书，采用WebSocket长连接模式接收消息，不需要公网IP或内网穿透，直接在本地运行即可。

前置条件

在开始之前，请确保：

1. OpenClaw已安装并正常运行 - 执行openclaw gateway status显示running
2. 飞书开发者权限 - 个人版飞书直接登录开放平台即可，公司版需联系管理员分配开发者角色
3. Node.js 22+

飞书端配置

第一步：创建飞书应用

1. 访问飞书开放平台
2. 点击「创建应用」→「企业自建应用」
3. 填写应用名称、描述和图标
4. 进入「凭证与基础信息」，保存App ID和App Secret

第二步：配置权限

进入「开发配置」→「权限管理」，开通以下权限：

• im:chat:readonly - 读取群聊信息
• im:chat:create - 创建群聊
• im:chat:member:readonly - 读取群成员
• im:message:send_as_bot - 以机器人身份发消息
• im:message:receive - 接收消息
• im:resource:download - 下载文件

第三步：创建事件订阅

1. 进入「事件订阅」
2. 点击「创建订阅」
3. 添加以下事件：
   • im.message.receive_v1 - 接收消息
4. 设置订阅URL（OpenClaw端配置完成后填入）

第四步：发布应用

配置完成后，返回应用概览，点击「发布应用」让应用上线。

OpenClaw端配置

第一步：安装飞书插件

openclaw plugins install @openclaw/feishu

验证安装：

openclaw plugins list

第二步：启动Web界面配置

openclaw dashboard

访问 http://127.0.0.1:18789/ ，在Channels页面添加Feishu渠道，输入App ID和App Secret。

或者使用命令行：

openclaw channels add

按提示选择Feishu，输入飞书应用的凭证信息。

第三步：配置事件订阅URL

回到飞书开放平台的事件订阅页面，URL填写：

http://127.0.0.1:18789/channels/feishu/webhook

如果是生产环境，需要使用公网域名或内网穿透服务。

第四步：验证连接

重启网关：

openclaw gateway restart

查看日志：

openclaw logs --follow

在飞书中搜索你的机器人账号，开始聊天测试。

常见问题

Q: 飞书机器人收不到消息？
A: 检查：1) 应用是否已发布；2) 事件订阅是否添加了im.message.receive_v1；3) 网关是否正常运行

Q: WebSocket连接失败？
A: 确认飞书应用已正确配置回调URL，本地网络可以访问飞书API

Q: 如何在群聊中使用？
A: 将机器人添加到群聊，然后在群里@机器人即可对话

总结

飞书接入OpenClaw非常简单，核心步骤：

1. 飞书开放平台创建应用并配置权限
2. 安装OpenClaw飞书插件
3. 配置App ID和Secret
4. 开始使用！

这样你就可以在飞书中直接使用AI助手了，无论是查询数据、生成报告还是管理日程，都能轻松搞定！

参考资料：OpenClaw官方飞书文档、飞书开放平台