飞书频道配置

飞书（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 — 获取用户基本信息

批量导入权限

如果你使用飞书官方插件的完整能力（数字分身模式），可以在权限管理页面使用 批量导入 功能，将以下 JSON 粘贴到导入框中一次性添加所有权限（点击下方展开查看）。

点击展开完整权限 JSON

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document:readonly",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "application:application:self_manage",
      "cardkit:card:write",
      "cardkit:card:read"
    ],
    "user": [
      "contact:user.employee_id:readonly",
      "offline_access",
      "base:app:copy",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:record:create",
      "base:record:delete",
      "base:record:retrieve",
      "base:record:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "base:app:create",
      "base:app:update",
      "base:app:read",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "calendar:calendar.free_busy:read",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document:copy",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "im:message:readonly",
      "search:docs:read",
      "search:message",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "task:comment:read",
      "task:comment:write",
      "task:task:read",
      "task:task:write",
      "task:task:writeonly",
      "task:tasklist:read",
      "task:tasklist:write",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only"
    ]
  }
}

4. 进入 事件与回调，选择 使用长连接方式接收事件（WebSocket 模式）
5. 添加以下事件订阅：
   • im.message.receive_v1 — 接收消息

第三步：发布应用

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

审核提示

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

飞书官方插件能力

飞书官方插件以数字分身模式运行——它使用你的用户身份操作，而不是作为第三方机器人。这意味着插件可以像你本人一样读写文档、管理日程、操作多维表格。

能力类别	具体功能
消息	读取群聊/单聊历史、消息发送与回复、消息搜索、图片/文件下载
文档	创建云文档、更新云文档、读取文档内容
多维表格	创建/管理多维表格、数据表、字段、记录（增删改查、批量操作、高级筛选）、视图
日历日程	日历管理、日程创建/查询/修改/删除/搜索、参会人管理、忙闲查询
任务	任务创建/查询/更新/完成、清单管理、子任务、评论

数字分身模式注意

由于插件以你的身份操作，请确保你清楚授予的权限范围。建议在测试环境中先行验证，再在生产环境中使用。

第四步：使用 OpenClaw 接入

有三种方式完成飞书频道配置：

方式一：交互式向导（推荐）

openclaw onboard

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

方式二：命令行快速添加

openclaw channels add --channel feishu --app-id "cli_xxxxxxxxxx" --app-secret "xxxxxxxxxxxxxxxxxxxxxxxx"

方式三：手动编辑配置文件

编辑 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 才会触发回复（参见群聊消息处理）

提示"应用未启用"？

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

收到"权限不足"错误？

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