From 4471e8ef4d5b04ab3433d52032587dd1004435d4 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 13 Apr 2026 10:05:55 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/channels/feishu.md | 660 ++++++++-------------------------- 1 file changed, 156 insertions(+), 504 deletions(-) diff --git a/docs/zh-CN/channels/feishu.md b/docs/zh-CN/channels/feishu.md index b3fe9a6c6..2044737c9 100644 --- a/docs/zh-CN/channels/feishu.md +++ b/docs/zh-CN/channels/feishu.md @@ -1,306 +1,44 @@ --- read_when: - - 你想连接一个 Feishu/Lark 机器人 + - 你想要连接一个 Feishu/Lark 机器人 - 你正在配置 Feishu 渠道 -summary: Feishu 机器人概览、功能与配置 +summary: Feishu 机器人概览、功能和配置 title: Feishu x-i18n: - generated_at: "2026-04-05T08:14:50Z" + generated_at: "2026-04-13T10:05:19Z" model: gpt-5.4 provider: openai - source_hash: 4e39b6dfe3a3aa4ebbdb992975e570e4f1b5e79f3b400a555fc373a0d1889952 + source_hash: 77fcf95a3fab534ed898bc157d76bf8bdfa8bf8a918d6af84c0db19890916c1a source_path: channels/feishu.md workflow: 15 --- -# Feishu 机器人 +# Feishu / Lark -Feishu（Lark）是企业用于消息和协作的团队聊天平台。此插件通过平台的 WebSocket 事件订阅将 OpenClaw 连接到 Feishu/Lark 机器人，因此无需暴露公共 webhook URL 即可接收消息。 +Feishu/Lark 是一个一体化协作平台，团队可以在其中聊天、共享文档、管理日历，并协同完成工作。 ---- - -## 内置插件 - -Feishu 随当前的 OpenClaw 版本一同内置提供，因此无需单独安装插件。 - -如果你使用的是较旧的构建版本，或使用了不包含内置 Feishu 的自定义安装，请手动安装： - -```bash -openclaw plugins install @openclaw/feishu -``` +**状态：** 机器人私信 + 群聊已可用于生产环境。WebSocket 是默认模式；webhook 模式为可选。 --- ## 快速开始 -有两种方式可添加 Feishu 渠道： - -### 方法 1：新手引导（推荐） - -如果你刚安装 OpenClaw，请运行新手引导： - -```bash -openclaw onboard -``` - -向导会引导你完成以下步骤： - -1. 创建一个 Feishu 应用并收集凭证 -2. 在 OpenClaw 中配置应用凭证 -3. 启动 Gateway 网关 - -✅ **配置完成后**，检查 Gateway 网关状态： - -- `openclaw gateway status` -- `openclaw logs --follow` - -### 方法 2：CLI 设置 - -如果你已经完成初始安装，可通过 CLI 添加该渠道： - -```bash -openclaw channels add -``` - -选择 **Feishu**，然后输入 App ID 和 App Secret。 - -✅ **配置完成后**，管理 Gateway 网关： - -- `openclaw gateway status` -- `openclaw gateway restart` -- `openclaw logs --follow` - ---- - -## 第 1 步：创建一个 Feishu 应用 - -### 1. 打开 Feishu 开放平台 - -访问 [Feishu Open Platform](https://open.feishu.cn/app) 并登录。 - -Lark（全球版）租户应使用 [https://open.larksuite.com/app](https://open.larksuite.com/app)，并在 Feishu 配置中设置 `domain: "lark"`。 - -### 2. 创建应用 - -1. 点击 **Create enterprise app** -2. 填写应用名称和描述 -3. 选择应用图标 - -![Create enterprise app](/images/feishu-step2-create-app.png) - -### 3. 复制凭证 - -在 **Credentials & Basic Info** 中，复制： - -- **App ID**（格式：`cli_xxx`） -- **App Secret** - -❗ **重要：** 请妥善保管 App Secret，不要泄露。 - -![Get credentials](/images/feishu-step3-credentials.png) - -### 4. 配置权限 - -在 **Permissions** 页面中，点击 **Batch import** 并粘贴： - -```json -{ - "scopes": { - "tenant": [ - "aily:file:read", - "aily:file:write", - "application:application.app_message_stats.overview:readonly", - "application:application:self_manage", - "application:bot.menu:write", - "cardkit:card:read", - "cardkit:card:write", - "contact:user.employee_id:readonly", - "corehr:file:download", - "event:ip_list", - "im:chat.access_event.bot_p2p_chat:read", - "im:chat.members:bot_access", - "im:message", - "im:message.group_at_msg:readonly", - "im:message.p2p_msg:readonly", - "im:message:readonly", - "im:message:send_as_bot", - "im:resource" - ], - "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"] - } -} -``` - -![Configure permissions](/images/feishu-step4-permissions.png) - -### 5. 启用机器人能力 - -在 **App Capability** > **Bot** 中： - -1. 启用机器人能力 -2. 设置机器人名称 - -![Enable bot capability](/images/feishu-step5-bot-capability.png) - -### 6. 配置事件订阅 - -⚠️ **重要：** 在设置事件订阅前，请确认： - -1. 你已经为 Feishu 运行过 `openclaw channels add` -2. Gateway 网关正在运行（`openclaw gateway status`） - -在 **Event Subscription** 中： - -1. 选择 **Use long connection to receive events**（WebSocket） -2. 添加事件：`im.message.receive_v1` -3. （可选）对于 Drive 评论工作流，还可添加：`drive.notice.comment_add_v1` - -⚠️ 如果 Gateway 网关未运行，长连接设置可能无法保存。 - -![Configure event subscription](/images/feishu-step6-event-subscription.png) - -### 7. 发布应用 - -1. 在 **Version Management & Release** 中创建一个版本 -2. 提交审核并发布 -3. 等待管理员批准（企业应用通常会自动批准） - ---- - -## 第 2 步：配置 OpenClaw - -### 使用向导配置（推荐） - -```bash -openclaw channels add -``` - -选择 **Feishu** 并粘贴你的 App ID 和 App Secret。 - -### 通过配置文件配置 - -编辑 `~/.openclaw/openclaw.json`： - -```json5 -{ - channels: { - feishu: { - enabled: true, - dmPolicy: "pairing", - accounts: { - main: { - appId: "cli_xxx", - appSecret: "xxx", - name: "My AI assistant", - }, - }, - }, - }, -} -``` - -如果你使用 `connectionMode: "webhook"`，请同时设置 `verificationToken` 和 `encryptKey`。Feishu webhook 服务器默认绑定到 `127.0.0.1`；只有在你明确需要不同绑定地址时才设置 `webhookHost`。 - -#### Verification Token 和 Encrypt Key（webhook 模式） - -使用 webhook 模式时，请在配置中同时设置 `channels.feishu.verificationToken` 和 `channels.feishu.encryptKey`。获取这些值的方法如下： - -1. 在 Feishu 开放平台中打开你的应用 -2. 前往 **Development** → **Events & Callbacks**（开发配置 → 事件与回调） -3. 打开 **Encryption** 选项卡（加密策略） -4. 复制 **Verification Token** 和 **Encrypt Key** - -下图展示了 **Verification Token** 的位置。**Encrypt Key** 位于同一个 **Encryption** 区域中。 - -![Verification Token location](/images/feishu-verification-token.png) - -### 通过环境变量配置 - -```bash -export FEISHU_APP_ID="cli_xxx" -export FEISHU_APP_SECRET="xxx" -``` - -### Lark（全球版）域名 - -如果你的租户在 Lark（国际版）上，请将域名设置为 `lark`（或完整域名字串）。你可以在 `channels.feishu.domain` 顶层设置，或按账户设置（`channels.feishu.accounts..domain`）。 - -```json5 -{ - channels: { - feishu: { - domain: "lark", - accounts: { - main: { - appId: "cli_xxx", - appSecret: "xxx", - }, - }, - }, - }, -} -``` - -### 配额优化标志 - -你可以使用两个可选标志来减少 Feishu API 使用量： - -- `typingIndicator`（默认 `true`）：设为 `false` 时，跳过“正在输入”反应调用。 -- `resolveSenderNames`（默认 `true`）：设为 `false` 时，跳过发送者资料查询调用。 - -你可以在顶层或按账户设置它们： - -```json5 -{ - channels: { - feishu: { - typingIndicator: false, - resolveSenderNames: false, - accounts: { - main: { - appId: "cli_xxx", - appSecret: "xxx", - typingIndicator: true, - resolveSenderNames: false, - }, - }, - }, - }, -} -``` - ---- - -## 第 3 步：启动并测试 - -### 1. 启动 Gateway 网关 - -```bash -openclaw gateway -``` - -### 2. 发送测试消息 - -在 Feishu 中找到你的机器人并发送一条消息。 - -### 3. 批准配对 - -默认情况下，机器人会回复一个配对码。批准它： - -```bash -openclaw pairing approve feishu -``` - -批准后，你就可以正常聊天了。 - ---- - -## 概览 - -- **Feishu 机器人渠道**：由 Gateway 网关管理的 Feishu 机器人 -- **确定性路由**：回复始终返回到 Feishu -- **会话隔离**：私信共享主会话；群组相互隔离 -- **WebSocket 连接**：通过 Feishu SDK 建立长连接，无需公共 URL +> **需要 OpenClaw 2026.4.10 或更高版本。** 运行 `openclaw --version` 进行检查。使用 `openclaw update` 升级。 + + + + ```bash + openclaw channels login --channel feishu + ``` + 使用你的 Feishu/Lark 移动应用扫描二维码，以自动创建一个 Feishu/Lark 机器人。 + + + + ```bash + openclaw gateway restart + ``` + + --- @@ -308,38 +46,43 @@ openclaw pairing approve feishu ### 私信 -- **默认值**：`dmPolicy: "pairing"`（未知用户会收到配对码） -- **批准配对**： +配置 `dmPolicy` 以控制谁可以向机器人发送私信： - ```bash - openclaw pairing list feishu - openclaw pairing approve feishu - ``` +- `"pairing"` — 未知用户会收到配对码；通过 CLI 批准 +- `"allowlist"` — 只有列在 `allowFrom` 中的用户可以聊天（默认：仅机器人所有者） +- `"open"` — 允许所有用户 +- `"disabled"` — 禁用所有私信 -- **Allowlist 模式**：设置 `channels.feishu.allowFrom`，填入允许的 Open ID +**批准配对请求：** + +```bash +openclaw pairing list feishu +openclaw pairing approve feishu +``` ### 群聊 -**1. 群组策略**（`channels.feishu.groupPolicy`）： +**群组策略**（`channels.feishu.groupPolicy`）： -- `"open"` = 允许群组中的所有人 -- `"allowlist"` = 仅允许 `groupAllowFrom` -- `"disabled"` = 禁用群消息 +| Value | 行为 | +| ------------- | ---------------------------------- | +| `"open"` | 响应群组中的所有消息 | +| `"allowlist"` | 仅响应 `groupAllowFrom` 中的群组 | +| `"disabled"` | 禁用所有群组消息 | 默认值：`allowlist` -**2. @ 提及要求**（`channels.feishu.requireMention`，可通过 `channels.feishu.groups..requireMention` 覆盖）： +**提及要求**（`channels.feishu.requireMention`）： -- 显式 `true` = 必须 @mention -- 显式 `false` = 无需提及即可回复 -- 未设置且 `groupPolicy: "open"` 时 = 默认为 `false` -- 未设置且 `groupPolicy` 不是 `"open"` 时 = 默认为 `true` +- `true` — 必须 @提及（默认） +- `false` — 无需 @提及也会响应 +- 按群组覆盖：`channels.feishu.groups..requireMention` --- ## 群组配置示例 -### 允许所有群组，无需 @mention（开放群组的默认值） +### 允许所有群组，不需要 @提及 ```json5 { @@ -351,7 +94,7 @@ openclaw pairing approve feishu } ``` -### 允许所有群组，但仍要求 @mention +### 允许所有群组，但仍然要求 @提及 ```json5 { @@ -371,16 +114,14 @@ openclaw pairing approve feishu channels: { feishu: { groupPolicy: "allowlist", - // Feishu 群组 ID（chat_id）形如：oc_xxx + // 群组 ID 类似于：oc_xxx groupAllowFrom: ["oc_xxx", "oc_yyy"], }, }, } ``` -### 限制群组中哪些发送者可以发消息（发送者 allowlist） - -除了允许群组本身之外，该群中的**所有消息**还会受到发送者 open_id 的限制：只有列在 `groups..allowFrom` 中的用户，其消息才会被处理；其他成员的消息会被忽略（这是完整的发送者级限制，而不只是针对 `/reset` 或 `/new` 这类控制命令）。 +### 限制群组内的发送者 ```json5 { @@ -390,7 +131,7 @@ openclaw pairing approve feishu groupAllowFrom: ["oc_xxx"], groups: { oc_xxx: { - // Feishu 用户 ID（open_id）形如：ou_xxx + // 用户 open_id 类似于：ou_xxx allowFrom: ["ou_user1", "ou_user2"], }, }, @@ -401,35 +142,23 @@ openclaw pairing approve feishu --- - +## 获取群组/用户 ID -## 获取群组 / 用户 ID +### 群组 ID（`chat_id`，格式：`oc_xxx`） -### 群组 ID（chat_id） +在 Feishu/Lark 中打开群组，点击右上角的菜单图标，然后进入**设置**。群组 ID（`chat_id`）会显示在设置页面中。 -群组 ID 形如 `oc_xxx`。 +![Get Group ID](/images/feishu-get-group-id.png) -**方法 1（推荐）** +### 用户 ID（`open_id`，格式：`ou_xxx`） -1. 启动 Gateway 网关，并在群组中 @mention 机器人 -2. 运行 `openclaw logs --follow` 并查找 `chat_id` +启动 Gateway 网关，向机器人发送一条私信，然后查看日志： -**方法 2** +```bash +openclaw logs --follow +``` -使用 Feishu API 调试器列出群聊。 - -### 用户 ID（open_id） - -用户 ID 形如 `ou_xxx`。 - -**方法 1（推荐）** - -1. 启动 Gateway 网关，并私信机器人 -2. 运行 `openclaw logs --follow` 并查找 `open_id` - -**方法 2** - -检查配对请求中的用户 Open ID： +在日志输出中查找 `open_id`。你也可以查看待处理的配对请求： ```bash openclaw pairing list feishu @@ -439,61 +168,45 @@ openclaw pairing list feishu ## 常用命令 -| Command | 描述 | -| --------- | ----------------- | -| `/status` | 显示机器人状态 | -| `/reset` | 重置会话 | -| `/model` | 显示 / 切换模型 | +| Command | 说明 | +| --------- | ----------------------- | +| `/status` | 显示机器人状态 | +| `/reset` | 重置当前会话 | +| `/model` | 显示或切换 AI 模型 | -> 注意：Feishu 目前还不支持原生命令菜单，因此必须以文本形式发送命令。 - -## Gateway 网关管理命令 - -| Command | 描述 | -| -------------------------- | ----------------------------- | -| `openclaw gateway status` | 显示 Gateway 网关状态 | -| `openclaw gateway install` | 安装 / 启动 Gateway 网关服务 | -| `openclaw gateway stop` | 停止 Gateway 网关服务 | -| `openclaw gateway restart` | 重启 Gateway 网关服务 | -| `openclaw logs --follow` | 跟踪 Gateway 网关日志 | +> Feishu/Lark 不支持原生斜杠命令菜单，因此请将这些命令作为普通文本消息发送。 --- ## 故障排除 -### 机器人在群聊中不响应 +### 机器人在群聊中没有响应 1. 确保机器人已加入群组 -2. 确保你 @mention 了机器人（默认行为） -3. 检查 `groupPolicy` 未设置为 `"disabled"` +2. 确保你已 @提及机器人（默认必需） +3. 验证 `groupPolicy` 不是 `"disabled"` 4. 检查日志：`openclaw logs --follow` -### 机器人未接收到消息 +### 机器人未收到消息 -1. 确保应用已发布并获批 +1. 确保机器人应用已在 Feishu Open Platform / Lark Developer 中发布并通过审核 2. 确保事件订阅包含 `im.message.receive_v1` -3. 确保已启用**长连接** -4. 确保应用权限完整 +3. 确保已选择**持久连接**（WebSocket） +4. 确保已授予所有必需的权限范围 5. 确保 Gateway 网关正在运行：`openclaw gateway status` 6. 检查日志：`openclaw logs --follow` ### App Secret 泄露 -1. 在 Feishu 开放平台中重置 App Secret -2. 更新配置中的 App Secret -3. 重启 Gateway 网关 - -### 消息发送失败 - -1. 确保应用具有 `im:message:send_as_bot` 权限 -2. 确保应用已发布 -3. 查看日志中的详细错误 +1. 在 Feishu Open Platform / Lark Developer 中重置 App Secret +2. 更新配置中的值 +3. 重启 Gateway 网关：`openclaw gateway restart` --- ## 高级配置 -### 多账户 +### 多账号 ```json5 { @@ -518,42 +231,53 @@ openclaw pairing list feishu } ``` -`defaultAccount` 控制当出站 API 未显式指定 `accountId` 时，使用哪个 Feishu 账户。 +`defaultAccount` 用于控制当出站 API 未指定 `accountId` 时使用哪个账号。 ### 消息限制 -- `textChunkLimit`：出站文本分块大小（默认：2000 个字符） -- `mediaMaxMb`：媒体上传 / 下载限制（默认：30 MB） +- `textChunkLimit` — 出站文本分块大小（默认：`2000` 个字符） +- `mediaMaxMb` — 媒体上传/下载限制（默认：`30` MB） ### 流式传输 -Feishu 通过交互式卡片支持流式回复。启用后，机器人会在生成文本时更新卡片。 +Feishu/Lark 支持通过交互式卡片进行流式回复。启用后，机器人会在生成文本时实时更新卡片。 ```json5 { channels: { feishu: { - streaming: true, // 启用流式卡片输出（默认 true） - blockStreaming: true, // 启用分块流式传输（默认 true） + streaming: true, // 启用流式卡片输出（默认：true） + blockStreaming: true, // 启用块级分块流式传输（默认：true） }, }, } ``` -将 `streaming: false` 设为禁用后，会等待完整回复生成后再发送。 +将 `streaming: false` 设为关闭后，会一次性发送完整回复。 + +### 配额优化 + +使用两个可选标志减少 Feishu/Lark API 调用次数： + +- `typingIndicator`（默认 `true`）：设为 `false` 以跳过“正在输入”反应调用 +- `resolveSenderNames`（默认 `true`）：设为 `false` 以跳过发送者资料查找 + +```json5 +{ + channels: { + feishu: { + typingIndicator: false, + resolveSenderNames: false, + }, + }, +} +``` ### ACP 会话 -Feishu 支持以下 ACP 场景： +Feishu/Lark 支持用于私信和群组话题消息的 ACP。Feishu/Lark ACP 由文本命令驱动——没有原生斜杠命令菜单，因此请直接在会话中使用 `/acp ...` 消息。 -- 私信 -- 群组话题会话 - -Feishu ACP 由文本命令驱动。没有原生斜杠命令菜单，因此请直接在对话中使用 `/acp ...` 消息。 - -#### 持久化 ACP 绑定 - -使用顶层类型化 ACP 绑定，可将 Feishu 私信或话题会话固定绑定到持久化 ACP 会话。 +#### 持久 ACP 绑定 ```json5 { @@ -597,58 +321,39 @@ Feishu ACP 由文本命令驱动。没有原生斜杠命令菜单，因此请直 } ``` -#### 从聊天中按线程绑定的 ACP 启动 +#### 从聊天中启动 ACP -在 Feishu 私信或话题会话中，你可以原地启动并绑定一个 ACP 会话： +在 Feishu/Lark 私信或话题中： ```text /acp spawn codex --thread here ``` -说明： - -- `--thread here` 适用于私信和 Feishu 话题。 -- 绑定后的私信 / 话题中的后续消息会直接路由到该 ACP 会话。 -- v1 不支持普通非话题群聊。 +`--thread here` 可用于私信和 Feishu/Lark 话题消息。后续消息会在已绑定的会话中直接路由到该 ACP 会话。 ### 多智能体路由 -使用 `bindings` 可将 Feishu 私信或群组路由到不同智能体。 +使用 `bindings` 将 Feishu/Lark 私信或群组路由到不同的智能体。 ```json5 { agents: { list: [ { id: "main" }, - { - id: "clawd-fan", - workspace: "/home/user/clawd-fan", - agentDir: "/home/user/.openclaw/agents/clawd-fan/agent", - }, - { - id: "clawd-xi", - workspace: "/home/user/clawd-xi", - agentDir: "/home/user/.openclaw/agents/clawd-xi/agent", - }, + { id: "agent-a", workspace: "/home/user/agent-a" }, + { id: "agent-b", workspace: "/home/user/agent-b" }, ], }, bindings: [ { - agentId: "main", + agentId: "agent-a", match: { channel: "feishu", peer: { kind: "direct", id: "ou_xxx" }, }, }, { - agentId: "clawd-fan", - match: { - channel: "feishu", - peer: { kind: "direct", id: "ou_yyy" }, - }, - }, - { - agentId: "clawd-xi", + agentId: "agent-b", match: { channel: "feishu", peer: { kind: "group", id: "oc_zzz" }, @@ -660,56 +365,45 @@ Feishu ACP 由文本命令驱动。没有原生斜杠命令菜单，因此请直 路由字段： -- `match.channel`：`"feishu"` -- `match.peer.kind`：`"direct"` 或 `"group"` -- `match.peer.id`：用户 Open ID（`ou_xxx`）或群组 ID（`oc_xxx`） +- `match.channel`: `"feishu"` +- `match.peer.kind`: `"direct"`（私信）或 `"group"`（群聊） +- `match.peer.id`: 用户 Open ID（`ou_xxx`）或群组 ID（`oc_xxx`） -查找建议请参阅 [获取群组 / 用户 ID](#get-groupuser-ids)。 +查找提示请参见 [获取群组/用户 ID](#get-groupuser-ids)。 --- ## 配置参考 -完整配置：[Gateway 网关配置](/gateway/configuration) +完整配置：[Gateway configuration](/zh-CN/gateway/configuration) -关键选项： - -| Setting | 描述 | 默认值 | -| ------------------------------------------------- | --------------------------------------- | ---------------- | -| `channels.feishu.enabled` | 启用 / 禁用渠道 | `true` | -| `channels.feishu.domain` | API 域名（`feishu` 或 `lark`） | `feishu` | -| `channels.feishu.connectionMode` | 事件传输模式 | `websocket` | -| `channels.feishu.defaultAccount` | 出站路由的默认账户 ID | `default` | -| `channels.feishu.verificationToken` | webhook 模式必需 | - | -| `channels.feishu.encryptKey` | webhook 模式必需 | - | -| `channels.feishu.webhookPath` | Webhook 路由路径 | `/feishu/events` | -| `channels.feishu.webhookHost` | Webhook 绑定主机 | `127.0.0.1` | -| `channels.feishu.webhookPort` | Webhook 绑定端口 | `3000` | -| `channels.feishu.accounts..appId` | App ID | - | -| `channels.feishu.accounts..appSecret` | App Secret | - | -| `channels.feishu.accounts..domain` | 按账户覆盖 API 域名 | `feishu` | -| `channels.feishu.dmPolicy` | 私信策略 | `pairing` | -| `channels.feishu.allowFrom` | 私信 allowlist（open_id 列表） | - | -| `channels.feishu.groupPolicy` | 群组策略 | `allowlist` | -| `channels.feishu.groupAllowFrom` | 群组 allowlist | - | -| `channels.feishu.requireMention` | 默认要求 @mention | conditional | -| `channels.feishu.groups..requireMention` | 按群组覆盖 @mention 要求 | inherited | -| `channels.feishu.groups..enabled` | 启用群组 | `true` | -| `channels.feishu.textChunkLimit` | 消息分块大小 | `2000` | -| `channels.feishu.mediaMaxMb` | 媒体大小限制 | `30` | -| `channels.feishu.streaming` | 启用流式卡片输出 | `true` | -| `channels.feishu.blockStreaming` | 启用分块流式传输 | `true` | - ---- - -## dmPolicy 参考 - -| Value | 行为 | -| ------------- | --------------------------------------------------------------- | -| `"pairing"` | **默认值。** 未知用户会收到配对码；必须批准 | -| `"allowlist"` | 只有 `allowFrom` 中的用户可以聊天 | -| `"open"` | 允许所有用户（要求 `allowFrom` 中包含 `"*"`） | -| `"disabled"` | 禁用私信 | +| Setting | 说明 | 默认值 | +| ------------------------------------------------- | ------------------------------------ | ---------------- | +| `channels.feishu.enabled` | 启用/禁用该渠道 | `true` | +| `channels.feishu.domain` | API 域名（`feishu` 或 `lark`） | `feishu` | +| `channels.feishu.connectionMode` | 事件传输方式（`websocket` 或 `webhook`） | `websocket` | +| `channels.feishu.defaultAccount` | 出站路由的默认账号 | `default` | +| `channels.feishu.verificationToken` | webhook 模式必需 | — | +| `channels.feishu.encryptKey` | webhook 模式必需 | — | +| `channels.feishu.webhookPath` | webhook 路由路径 | `/feishu/events` | +| `channels.feishu.webhookHost` | webhook 绑定主机 | `127.0.0.1` | +| `channels.feishu.webhookPort` | webhook 绑定端口 | `3000` | +| `channels.feishu.accounts..appId` | App ID | — | +| `channels.feishu.accounts..appSecret` | App Secret | — | +| `channels.feishu.accounts..domain` | 按账号覆盖域名 | `feishu` | +| `channels.feishu.dmPolicy` | 私信策略 | `allowlist` | +| `channels.feishu.allowFrom` | 私信允许列表（`open_id` 列表） | [BotOwnerId] | +| `channels.feishu.groupPolicy` | 群组策略 | `allowlist` | +| `channels.feishu.groupAllowFrom` | 群组允许列表 | — | +| `channels.feishu.requireMention` | 群组中需要 @提及 | `true` | +| `channels.feishu.groups..requireMention` | 按群组覆盖 @提及要求 | 继承 | +| `channels.feishu.groups..enabled` | 启用/禁用特定群组 | `true` | +| `channels.feishu.textChunkLimit` | 消息分块大小 | `2000` | +| `channels.feishu.mediaMaxMb` | 媒体大小限制 | `30` | +| `channels.feishu.streaming` | 流式卡片输出 | `true` | +| `channels.feishu.blockStreaming` | 分块流式传输 | `true` | +| `channels.feishu.typingIndicator` | 发送“正在输入”反应 | `true` | +| `channels.feishu.resolveSenderNames` | 解析发送者显示名称 | `true` | --- @@ -722,7 +416,7 @@ Feishu ACP 由文本命令驱动。没有原生斜杠命令菜单，因此请直 - ✅ 图片 - ✅ 文件 - ✅ 音频 -- ✅ 视频 / 媒体 +- ✅ 视频/媒体 - ✅ 贴纸 ### 发送 @@ -731,64 +425,22 @@ Feishu ACP 由文本命令驱动。没有原生斜杠命令菜单，因此请直 - ✅ 图片 - ✅ 文件 - ✅ 音频 -- ✅ 视频 / 媒体 -- ✅ 交互式卡片 -- ⚠️ 富文本（post 风格格式和卡片，不支持任意 Feishu 创作功能） +- ✅ 视频/媒体 +- ✅ 交互式卡片（包括流式更新） +- ⚠️ 富文本（post 风格格式；不支持完整的 Feishu/Lark 创作能力） -### 线程与回复 +### 话题和回复 - ✅ 行内回复 -- ✅ 当 Feishu 暴露 `reply_in_thread` 时支持话题线程回复 -- ✅ 回复线程 / 话题消息时，媒体回复会保持线程感知 +- ✅ 话题回复 +- ✅ 回复话题消息时，媒体回复会保持话题感知 -## Drive 评论 - -当有人在 Feishu Drive 文档（Docs、Sheets 等）中添加评论时，Feishu 可以触发智能体。智能体会收到评论文本、文档上下文以及评论线程，以便在线程内回复或编辑文档。 - -要求： - -- 在你的 Feishu 应用事件订阅设置中订阅 `drive.notice.comment_add_v1` - （与现有的 `im.message.receive_v1` 一起） -- Drive 工具默认启用；可使用 `channels.feishu.tools.drive: false` 禁用 - -`feishu_drive` 工具提供以下评论操作： - -| Action | 描述 | -| ---------------------- | ----------------------------------- | -| `list_comments` | 列出文档上的评论 | -| `list_comment_replies` | 列出评论线程中的回复 | -| `add_comment` | 添加新的顶级评论 | -| `reply_comment` | 回复现有评论线程 | - -当智能体处理 Drive 评论事件时，它会收到： - -- 评论文本和发送者 -- 文档元数据（标题、类型、URL） -- 用于在线程内回复的评论线程上下文 - -在完成文档编辑后，系统会引导智能体使用 `feishu_drive.reply_comment` 通知评论者，然后输出精确的静默标记 `NO_REPLY` / `no_reply`，以避免重复发送。 - -## 运行时操作面 - -Feishu 当前公开以下运行时操作： - -- `send` -- `read` -- `edit` -- `thread-reply` -- `pin` -- `list-pins` -- `unpin` -- `member-info` -- `channel-info` -- `channel-list` -- 当配置中启用了 reaction 时，可使用 `react` 和 `reactions` -- `feishu_drive` 评论操作：`list_comments`、`list_comment_replies`、`add_comment`、`reply_comment` +--- ## 相关内容 -- [渠道概览](/channels) —— 所有支持的渠道 -- [配对](/channels/pairing) —— 私信认证与配对流程 -- [群组](/channels/groups) —— 群聊行为与提及门控 -- [渠道路由](/channels/channel-routing) —— 消息的会话路由 -- [安全](/gateway/security) —— 访问模型与加固 +- [渠道概览](/zh-CN/channels) — 所有受支持的渠道 +- [配对](/zh-CN/channels/pairing) — 私信身份验证和配对流程 +- [群组](/zh-CN/channels/groups) — 群聊行为和提及门控 +- [渠道路由](/zh-CN/channels/channel-routing) — 消息的会话路由 +- [安全](/zh-CN/gateway/security) — 访问模型和加固措施