飞书频道配置

飞书（Lark）自 OpenClaw 2026.2 起内置支持，使用 WebSocket 事件订阅模式，不需要公网 URL。

预计耗时

完成全部配置约需 15-20 分钟。

第一步：创建飞书应用

1. 登录 飞书开放平台
2. 点击 创建企业自建应用
3. 输入应用名称和描述
4. 创建完成后，在应用的 凭证与基础信息 页面获取：
   • App ID
   • App Secret

第二步：配置应用能力

1. 在应用管理页面，进入 添加应用能力

2. 添加 机器人 能力

3. 进入 权限管理，申请以下权限：

   • im:message — 获取与发送消息
   • im:message.group_at_msg — 接收群聊 @机器人消息
   • im:resource — 获取消息中的资源文件
   • contact:user.base — 获取用户基本信息

4. 进入 事件与回调，选择 使用长连接方式接收事件（WebSocket 模式）

5. 添加以下事件订阅：

   • im.message.receive_v1 — 接收消息

第三步：发布应用

1. 在应用管理页面，点击 版本管理与发布
2. 创建版本并提交审核
3. 管理员审核通过后，应用即可上线

审核提示

企业自建应用的审核通常很快（企业管理员自行审核）。如果你是管理员，可以直接在飞书管理后台审核通过。

第四步：使用 OpenClaw 接入

推荐使用 openclaw onboard 交互式命令完成配置：

openclaw onboard

在向导中选择 Feishu 频道，按提示输入 App ID 和 App Secret。

也可以手动编辑 openclaw.yaml：

channels:
  feishu:
    enabled: true
    appId: "cli_xxxxxxxxxx"
    appSecret: "xxxxxxxxxxxxxxxxxxxxxxxx"

第五步：重启 Gateway 并验证

openclaw restart

在飞书中搜索你创建的 Bot，发送一条消息，确认能收到回复。

配置选项

配置项	说明	默认值
allowedUsers	允许对话的用户 ID 白名单	所有人
allowedGroups	允许 Bot 响应的群组 ID 列表	所有群组
systemPrompt	该频道专用的系统提示词	全局默认
model	该频道使用的 AI 模型	全局默认

支持的消息类型

• 文本消息
• 图片消息
• 富文本消息
• 文件 / 附件
• 卡片消息（用于结构化回复）

社区替代方案

AlexAnys/feishu-openclaw

如果你不想使用内置的飞书集成，社区维护的 AlexAnys/feishu-openclaw bridge 提供了另一种接入方式，支持更多自定义配置选项。

openclaw plugin install feishu-openclaw

openclaw-china 统一插件

飞书也可通过 BytePioneer-AI/openclaw-china 统一插件接入：

openclaw plugin install openclaw-china

统一插件同时覆盖飞书、钉钉、QQ、企业微信和微信，适合需要同时接入多个中国平台的场景。

常见问题

Bot 在群聊中不回复？

1. 确认已添加 im:message.group_at_msg 权限
2. 确认已订阅 im.message.receive_v1 事件
3. 在群聊中需要 @Bot 才会触发回复（参见群聊消息处理）

提示"应用未启用"？

确认应用已通过审核并发布上线。在飞书管理后台查看应用状态。

收到"权限不足"错误？

返回飞书开放平台，检查权限是否申请完整，并确认管理员已审批通过。