Channel - 飞书（Feishu/Lark）

飞书/Lark 是一体化协作平台。OpenClaw 通过 WebSocket 连接飞书 bot，支持 DM 和群聊，状态为生产就绪。

要求：OpenClaw >= 2026.4.25

快速开始

# 启动 channel 配置向导
openclaw channels login --channel feishu
 
# 重启 gateway
openclaw gateway restart

向导支持两种方式：手动粘贴 App ID + App Secret，或 QR 扫码自动创建 bot。

访问控制

DM 策略（dmPolicy）

值	行为
`pairing`	未知用户收到配对码，通过 CLI 审批
`allowlist`	仅 `allowFrom` 中的用户可聊（默认：仅 bot owner）
`open`	`allowFrom` 包含 `"*"` 时允许公开 DM
`disabled`	禁用所有 DM

# 审批配对请求
openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

群聊策略（groupPolicy）

值	行为
`open`	响应所有群消息
`allowlist`	仅响应 `groupAllowFrom` 或显式配置的群（默认）
`disabled`	禁用所有群消息

默认需要 @mention（requireMention: true）。

获取 ID

群 ID（chat_id，格式 oc_xxx）：飞书群设置页面查看
用户 ID（open_id，格式 ou_xxx）：启动 gateway 后查看日志或 openclaw pairing list feishu

配置示例

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
      groups: {
        oc_xxx: { requireMention: false },
      },
    },
  },
}

高级配置

多账号

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: { appId: "cli_xxx", appSecret: "xxx" },
        backup: { appId: "cli_yyy", appSecret: "yyy", enabled: false },
      },
    },
  },
}

流式回复（Streaming）

飞书支持通过交互式卡片实时更新回复：

{
  channels: {
    feishu: {
      streaming: true,      // 默认 true
      blockStreaming: true,  // 完成块流式输出
    },
  },
}

配额优化

{
  channels: {
    feishu: {
      typingIndicator: false,    // 跳过 typing reaction 调用
      resolveSenderNames: false, // 跳过发送者 profile 查询
    },
  },
}

支持的消息类型

接收：文本、富文本、图片、文件、音频、视频、贴纸

发送：文本、图片、文件、音频、视频、交互式卡片（含流式更新）

关键配置参数

参数	说明	默认值
`connectionMode`	`websocket` 或 `webhook`	`websocket`
`textChunkLimit`	消息分块大小	`2000`
`mediaMaxMb`	媒体大小限制	`30`
`streaming`	流式卡片输出	`true`

Wiki AI

目录