飞书与 Lark

创建应用、开通事件和权限，配置长连接、卡片回复及媒体下载。

This page has not been translated into English yet. The original Chinese version is shown below.

飞书渠道通过组织内应用的机器人能力接收消息。App ID 对应 clientId，App Secret 对应 clientSecret；应用配置完成后还需创建版本、发布并获得批准。

平台准备

在飞书开放平台创建应用并添加机器人能力。
在事件与回调中选择长连接，订阅 im.message.receive_v1。
开通 im:message、im:message:send_as_bot、im:resource，分别供消息读写、机器人发送和消息资源访问使用。
发布应用，再将机器人添加到需要使用的会话。

contact:user.basic_profile:readonly 与 im:chat:readonly 是可选权限。专章把它们用于联系人显示名称；通用概述仍描述部分标签回退到 ID，因此名称显示应以实际版本返回的数据为准。缺少这两项权限不阻止基本消息往来。

长连接配置

默认通过出站 WebSocket 接收事件，不要求公网回调地址。以下示例只开放配对私聊，群保持关闭；凭据来自启动进程环境。

{
  "channels": {
    "feishu-work": {
      "type": "feishu",
      "clientId": "$FEISHU_APP_ID",
      "clientSecret": "$FEISHU_APP_SECRET",
      "privatePolicy": "pairing",
      "groupPolicy": "disabled",
      "sessionScope": "user",
      "cwd": "/path/to/project",
      "collapsible": false
    }
  }
}

qwen channel start feishu-work

需要 HTTP 事件回调时，可配置 webhookPort 切换模式，并按平台设置 verificationToken 和 encryptKey；这些字段应补到带有 clientId、clientSecret 的完整渠道配置中。不要把仅演示回调字段的片段当成可独立启动的配置。

卡片与群会话

回复采用 Card v2 流式更新，PATCH 间隔为 1.5 秒，提供 Stop 控件；处理时显示 On It 表情。collapsible 默认 false，启用后使用折叠展示，阈值为 500 字符。

群准入和 requireMention 按通用规则配置。每条消息可以有独立卡片，但 agent 历史、忙时调度和谁能停止任务仍由 sessionScope、dispatch 与 operators 决定，卡片独立不代表工作区或共享会话隔离。

引用和附件

支持引用文本、富文本和卡片内容；读取卡片引用需要相应的 card_msg_content_type=user_card_content 能力与权限。消息图片和文件通过带认证的 OpenAPI 下载，渠道指南给出的单文件限制为 50 MB。

富文本 post 会提取文本，其中嵌入的图片不会作为图片附件自动传入。单独图片消息仍需视觉模型。机器人完全收不到消息时，先核对应用发布状态、事件订阅和权限，再核对 Qwen Code 的准入设置。