为什么选择飞书？
飞书，国际版称为 Lark，是字节跳动旗下的企业协作平台——在中国的科技公司、创业公司中被广泛使用，在东南亚的使用也日益增多。自 OpenClaw v2026.2.2 起，飞书成为平台首个官方支持的国内聊天客户端。
- •不需要公网 URL——不用 ngrok、不用域名、不用 webhook 服务器
- •防火墙内也能工作——连接是从你的机器向外发起的
- •低延迟——实时双向通信
- •富内容支持——文本、图片、文件、音频、视频和表情
前置条件
- •OpenClaw v2026.2.2 或更高版本
- •一个飞书/Lark 企业账号（免费版即可）
- •管理员权限以在飞书开放平台创建应用
第一步：创建飞书应用
- 1.前往飞书开放平台（国际租户请访问 Lark Developer Console）
- 2.点击创建企业自建应用
- 3.设置应用名称（如 "OpenClaw Agent"）和描述
- 4.上传图标（OpenClaw 龙虾 Logo 很合适）
- 5.在凭证页面复制 App ID（格式：
cli_xxx）和 App Secret
第二步：配置应用权限
在应用的权限设置中，开启以下权限：
| 权限 | 用途 |
|---|---|
im:message | 收发消息 |
im:message.group_at_msg | 接收群聊中的 @提及 |
im:resource | 访问图片和文件 |
contact:user.id:readonly | 识别用户身份 |
添加权限后，点击发布提交审核。在大多数企业租户中，自建应用会自动审批通过。
第三步：启用事件订阅
- 1.在应用设置中，进入事件订阅
- 2.选择 WebSocket 模式（长连接）——这一步至关重要。请勿使用 webhook 模式，因为那需要公网 URL。
- 3.订阅以下事件：
第四步：配置 OpenClaw
将飞书凭证添加到 OpenClaw 配置中。编辑 ~/.openclaw/.env：
FEISHU_APP_ID=cli_xxxxxxxxxxxxx
FEISHU_APP_SECRET=your_app_secret_here
或者使用 OpenClaw 配置文件（~/.openclaw/config.yaml）：
channels:
feishu:
enabled: true
appId: cli_xxxxxxxxxxxxx
appSecret: your_app_secret_here
重启 OpenClaw：
openclaw restart
你应该会看到一条日志消息，确认飞书 WebSocket 连接已建立。
第五步：测试连接
打开飞书，在聊天列表中找到你的应用（搜索第一步中设置的应用名称）。发送一条消息：
> 你好！
- •文本消息
- •图片（如果使用支持视觉的模型，代理可以分析图片）
- •文件（代理可以阅读文档）
- •语音消息（会被转录为文本后处理）
群聊配置
OpenClaw 支持飞书群聊，提供三种访问模式：
| 模式 | 行为 |
|---|---|
open（默认） | 任何群成员 @机器人都可以触发 |
allowlist | 即使 @提及，也只有白名单用户可以交互 |
disabled | 完全忽略群消息 |
在 config.yaml 中配置：
channels:
feishu:
groupAccess: open # or "allowlist" or "disabled"
allowedUsers: # only used with "allowlist" mode
- user_id_1
- user_id_2
在群聊中，代理只在被 @提及时回复，避免在繁忙频道中产生噪音。
流式回复
OpenClaw 支持在飞书中使用交互卡片进行 AI 回复的流式输出。代理不会等待完整回复生成，而是先发送一个初始卡片，然后随着 AI 生成文本实时更新内容。这为长回复提供了更好的用户体验。
流式输出默认启用。要禁用它：
channels:
feishu:
streaming: false
支持的消息类型
| 方向 | 支持的类型 |
|---|---|
| 入站（用户 -> 代理） | 文本、富文本（post）、图片、文件、音频、视频、表情 |
| 出站（代理 -> 用户） | 文本、图片、文件、音频、交互卡片 |
故障排除
"App not found" 错误：确保应用已在你的飞书租户中发布并审批通过。企业租户中的自建应用通常会自动审批，但某些组织需要管理员审批。
代理没有回复：检查 OpenClaw 日志（openclaw logs）是否有 WebSocket 连接错误。确认 App ID 和 App Secret 是否正确。
群聊中收不到消息：确保机器人已被添加到群组中，且用户正确地 @了机器人。检查 groupAccess 设置。
连接断开：WebSocket 连接会自动重连。如果频繁断开，请检查网络稳定性或防火墙设置。
使用社区桥接（备选方案）
如果你需要原生集成之外的功能，社区维护的 feishu-openclaw bridge（作者 AlexAnys）提供了自定义消息格式化和高级群管理等额外能力。搭建大约需要 5 分钟，无需公网服务器。
如需完整文档，请参阅官方飞书通道指南。