From 965ebad489c0b5e01a9911d515f0ded9cad03030 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 27 Apr 2026 20:59:47 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/channels/feishu.md | 179 +++++++++++++++++++--------------- 1 file changed, 98 insertions(+), 81 deletions(-) diff --git a/docs/zh-CN/channels/feishu.md b/docs/zh-CN/channels/feishu.md index 9bd47638b..9a8de8a0e 100644 --- a/docs/zh-CN/channels/feishu.md +++ b/docs/zh-CN/channels/feishu.md @@ -5,19 +5,19 @@ read_when: summary: Feishu 机器人概览、功能和配置 title: Feishu x-i18n: - generated_at: "2026-04-27T09:44:03Z" + generated_at: "2026-04-27T20:58:59Z" model: gpt-5.4 provider: openai - source_hash: f24fada0adea25fc4f2ea93a1c91af5a0fd86aebe90901aa20031c59a982a970 + source_hash: b300f98fb3681e84a105de99b9e771b1f0fc6278ee2fda01a703b97fabf5dd63 source_path: channels/feishu.md workflow: 15 --- # Feishu / Lark -Feishu/Lark 是一个一体化协作平台，团队可以在其中聊天、共享文档、管理日历，并协同完成工作。 +Feishu/Lark 是一个一体化协作平台，团队可以在其中聊天、共享文档、管理日历，并共同完成工作。 -**Status：**已可用于机器人私信 + 群聊，适合生产环境。WebSocket 是默认模式；webhook 模式为可选。 +**Status：** 已可用于机器人私信 + 群聊，达到生产可用。WebSocket 是默认模式；webhook 模式为可选。 --- @@ -51,11 +51,11 @@ Feishu/Lark 是一个一体化协作平台，团队可以在其中聊天、共 配置 `dmPolicy` 以控制谁可以向机器人发送私信： - `"pairing"` — 未知用户会收到配对码；通过 CLI 批准 -- `"allowlist"` — 只有 `allowFrom` 中列出的用户可以聊天（默认：仅机器人所有者） +- `"allowlist"` — 仅 `allowFrom` 中列出的用户可以聊天（默认：仅机器人所有者） - `"open"` — 允许所有用户 - `"disabled"` — 禁用所有私信 -**批准配对请求：** +**批准一个配对请求：** ```bash openclaw pairing list feishu @@ -66,26 +66,26 @@ openclaw pairing approve feishu **群策略**（`channels.feishu.groupPolicy`）： -| 值 | 行为 | -| ------------- | ---- | -| `"open"` | 在群组中回复所有消息 | -| `"allowlist"` | 仅回复 `groupAllowFrom` 中的群组 | -| `"disabled"` | 禁用所有群消息 | +| Value | Behavior | +| ------------- | -------------------------------------------------------------------------------------------- | +| `"open"` | 在群组中响应所有消息 | +| `"allowlist"` | 仅响应 `groupAllowFrom` 中的群组，或在 `groups.` 下显式配置的群组 | +| `"disabled"` | 禁用所有群组消息 | 默认值：`allowlist` **提及要求**（`channels.feishu.requireMention`）： -- `true` — 需要 @提及（默认） -- `false` — 无需 @提及也会回复 +- `true` — 需要 @mention（默认） +- `false` — 无需 @mention 也会响应 - 按群覆盖：`channels.feishu.groups..requireMention` -- 仅广播用途的 `@all` 和 `@_all` 不会被视为对机器人的提及。如果一条消息同时提及 `@all` 和机器人本身，仍然算作提及机器人。 +- 仅广播用途的 `@all` 和 `@_all` 不会被视为对机器人的提及。如果一条消息同时提及 `@all` 和机器人本身，仍然算作提及了机器人。 --- ## 群组配置示例 -### 允许所有群组，无需 @提及 +### 允许所有群组，无需 @mention ```json5 { @@ -97,7 +97,7 @@ openclaw pairing approve feishu } ``` -### 允许所有群组，但仍要求 @提及 +### 允许所有群组，但仍要求 @mention ```json5 { @@ -117,13 +117,30 @@ openclaw pairing approve feishu channels: { feishu: { groupPolicy: "allowlist", - // 群组 ID 类似于：oc_xxx + // 群组 ID 形如：oc_xxx groupAllowFrom: ["oc_xxx", "oc_yyy"], }, }, } ``` +你也可以通过添加显式的 `groups.` 条目来准入一个群组。`groups.*` 下的通配默认值会配置匹配的群组，但它们本身不会使群组获得准入。 + +```json5 +{ + channels: { + feishu: { + groupPolicy: "allowlist", + groups: { + oc_xxx: { + requireMention: false, + }, + }, + }, + }, +} +``` + ### 限制群组内的发送者 ```json5 @@ -134,7 +151,7 @@ openclaw pairing approve feishu groupAllowFrom: ["oc_xxx"], groups: { oc_xxx: { - // 用户 open_id 类似于：ou_xxx + // 用户 open_id 形如：ou_xxx allowFrom: ["ou_user1", "ou_user2"], }, }, @@ -151,9 +168,9 @@ openclaw pairing approve feishu ### 群组 ID（`chat_id`，格式：`oc_xxx`） -在 Feishu/Lark 中打开群组，点击右上角的菜单图标，然后进入 **设置**。群组 ID（`chat_id`）会列在设置页面中。 +在 Feishu/Lark 中打开群组，点击右上角的菜单图标，然后进入**设置**。群组 ID（`chat_id`）会显示在设置页面中。 -![获取群组 ID](/images/feishu-get-group-id.png) +![Get Group ID](/images/feishu-get-group-id.png) ### 用户 ID（`open_id`，格式：`ou_xxx`） @@ -163,7 +180,7 @@ openclaw pairing approve feishu openclaw logs --follow ``` -在日志输出中查找 `open_id`。你也可以查看待处理的配对请求： +在日志输出中查找 `open_id`。你也可以检查待处理的配对请求： ```bash openclaw pairing list feishu @@ -173,11 +190,11 @@ openclaw pairing list feishu ## 常用命令 -| 命令 | 说明 | -| --------- | ---- | -| `/status` | 显示机器人状态 | -| `/reset` | 重置当前会话 | -| `/model` | 显示或切换 AI 模型 | +| Command | Description | +| --------- | -------------------------- | +| `/status` | 显示机器人状态 | +| `/reset` | 重置当前会话 | +| `/model` | 显示或切换 AI 模型 | Feishu/Lark 不支持原生斜杠命令菜单，因此请将这些命令作为普通文本消息发送。 @@ -189,16 +206,16 @@ Feishu/Lark 不支持原生斜杠命令菜单，因此请将这些命令作为 ### 机器人在群聊中没有响应 -1. 确保机器人已添加到群组 -2. 确保你 @提及了机器人（默认要求） -3. 验证 `groupPolicy` 不为 `"disabled"` +1. 确保机器人已被添加到群组中 +2. 确保你 @mention 了机器人（默认需要） +3. 确认 `groupPolicy` 不是 `"disabled"` 4. 检查日志：`openclaw logs --follow` -### 机器人没有收到消息 +### 机器人没有接收到消息 1. 确保机器人已在 Feishu Open Platform / Lark Developer 中发布并获批 2. 确保事件订阅包含 `im.message.receive_v1` -3. 确保已选择**长连接**（WebSocket） +3. 确保已选择**持久连接**（WebSocket） 4. 确保已授予所有必需的权限范围 5. 确保 Gateway 网关正在运行：`openclaw gateway status` 6. 检查日志：`openclaw logs --follow` @@ -206,7 +223,7 @@ Feishu/Lark 不支持原生斜杠命令菜单，因此请将这些命令作为 ### App Secret 泄露 1. 在 Feishu Open Platform / Lark Developer 中重置 App Secret -2. 更新你的配置中的该值 +2. 更新你配置中的值 3. 重启 Gateway 网关：`openclaw gateway restart` --- @@ -244,7 +261,7 @@ Feishu/Lark 不支持原生斜杠命令菜单，因此请将这些命令作为 ``` `defaultAccount` 用于控制当出站 API 未指定 `accountId` 时使用哪个账户。 -`accounts..tts` 使用与 `messages.tts` 相同的结构，并在全局 TTS 配置之上执行深度合并，因此多机器人 Feishu 配置可以将共享的提供商凭证保留在全局配置中，同时仅按账户覆盖语音、模型、persona 或自动模式。 +`accounts..tts` 使用与 `messages.tts` 相同的结构，并会在全局 TTS 配置之上执行深度合并，因此多机器人 Feishu 配置可以将共享的提供商凭证保留在全局，只按账户覆盖语音、模型、persona 或自动模式。 ### 消息限制 @@ -266,14 +283,14 @@ Feishu/Lark 通过交互式卡片支持流式回复。启用后，机器人会 } ``` -将 `streaming: false` 设为禁用后，会在一条消息中发送完整回复。 +将 `streaming: false` 设置为一次性在一条消息中发送完整回复。 ### 配额优化 -使用两个可选标志来减少 Feishu/Lark API 调用次数： +使用两个可选标志减少 Feishu/Lark API 调用次数： -- `typingIndicator`（默认 `true`）：设为 `false` 可跳过“正在输入”反应调用 -- `resolveSenderNames`（默认 `true`）：设为 `false` 可跳过发送者资料查询 +- `typingIndicator`（默认 `true`）：设置为 `false` 以跳过“正在输入”反应调用 +- `resolveSenderNames`（默认 `true`）：设置为 `false` 以跳过发送者资料查询 ```json5 { @@ -288,7 +305,7 @@ Feishu/Lark 通过交互式卡片支持流式回复。启用后，机器人会 ### ACP 会话 -Feishu/Lark 支持用于私信和群线程消息的 ACP。Feishu/Lark ACP 由文本命令驱动——没有原生斜杠命令菜单，因此请直接在会话中使用 `/acp ...` 消息。 +Feishu/Lark 支持用于私信和群组话题消息的 ACP。Feishu/Lark ACP 由文本命令驱动——没有原生斜杠命令菜单，因此请直接在对话中使用 `/acp ...` 消息。 #### 持久 ACP 绑定 @@ -336,17 +353,17 @@ Feishu/Lark 支持用于私信和群线程消息的 ACP。Feishu/Lark ACP 由文 #### 从聊天中启动 ACP -在 Feishu/Lark 私信或线程中： +在 Feishu/Lark 私信或话题中： ```text /acp spawn codex --thread here ``` -`--thread here` 适用于私信和 Feishu/Lark 线程消息。后续在该已绑定会话中的消息会直接路由到该 ACP 会话。 +`--thread here` 适用于私信和 Feishu/Lark 话题消息。绑定对话中的后续消息会直接路由到该 ACP 会话。 ### 多智能体路由 -使用 `bindings` 将 Feishu/Lark 私信或群组路由到不同智能体。 +使用 `bindings` 将 Feishu/Lark 私信或群组路由到不同的智能体。 ```json5 { @@ -382,7 +399,7 @@ Feishu/Lark 支持用于私信和群线程消息的 ACP。Feishu/Lark ACP 由文 - `match.peer.kind`：`"direct"`（私信）或 `"group"`（群聊） - `match.peer.id`：用户 Open ID（`ou_xxx`）或群组 ID（`oc_xxx`） -查找提示请参阅[获取群组/用户 ID](#get-groupuser-ids)。 +有关查找提示，请参阅 [获取群组/用户 ID](#get-groupuser-ids)。 --- @@ -390,34 +407,34 @@ Feishu/Lark 支持用于私信和群线程消息的 ACP。Feishu/Lark ACP 由文 完整配置：[Gateway 网关配置](/zh-CN/gateway/configuration) -| 设置 | 说明 | 默认值 | -| ------------------------------------------------- | ---- | ------ | -| `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.accounts..tts` | 按账户覆盖的 TTS | `messages.tts` | -| `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` | 按群覆盖 @提及要求 | inherited | -| `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` | +| Setting | Description | Default | +| ------------------------------------------------- | -------------------------------------------------------------------------------- | ---------------- | +| `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.accounts..tts` | 按账户覆盖 TTS | `messages.tts` | +| `channels.feishu.dmPolicy` | 私信策略 | `allowlist` | +| `channels.feishu.allowFrom` | 私信白名单（`open_id` 列表） | [BotOwnerId] | +| `channels.feishu.groupPolicy` | 群组策略 | `allowlist` | +| `channels.feishu.groupAllowFrom` | 群组白名单 | — | +| `channels.feishu.requireMention` | 在群组中要求 @mention | `true` | +| `channels.feishu.groups..requireMention` | 按群覆盖 @mention；显式 ID 在 allowlist 模式下也会使该群组获得准入 | inherited | +| `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` | --- @@ -431,9 +448,9 @@ Feishu/Lark 支持用于私信和群线程消息的 ACP。Feishu/Lark ACP 由文 - ✅ 文件 - ✅ 音频 - ✅ 视频/媒体 -- ✅ 贴纸 +- ✅ 表情贴纸 -入站的 Feishu/Lark 音频消息会被标准化为媒体占位符，而不是原始 `file_key` JSON。当配置了 `tools.media.audio` 时，OpenClaw 会下载语音消息资源，并在智能体轮次之前运行共享音频转写，因此智能体会收到语音转写文本。如果 Feishu 直接在音频负载中包含了转写文本，则会直接使用该文本，而不会再次发起 ASR 调用。如果没有音频转写提供商，智能体仍会收到一个 `` 占位符以及已保存的附件，而不是原始的 Feishu 资源负载。 +入站 Feishu/Lark 音频消息会被标准化为媒体占位符，而不是原始 `file_key` JSON。当配置了 `tools.media.audio` 时，OpenClaw 会下载语音消息资源，并在智能体轮次开始前运行共享音频转写，因此智能体接收到的是语音转录文本。如果 Feishu 在音频负载中直接包含转录文本，则会直接使用该文本，而不会再次调用 ASR。若未配置音频转写提供商，智能体仍会收到一个 `` 占位符以及已保存的附件，而不是原始的 Feishu 资源负载。 ### 发送 @@ -443,24 +460,24 @@ Feishu/Lark 支持用于私信和群线程消息的 ACP。Feishu/Lark ACP 由文 - ✅ 音频 - ✅ 视频/媒体 - ✅ 交互式卡片（包括流式更新） -- ⚠️ 富文本（post 风格格式；不支持完整的 Feishu/Lark 原生编辑能力） +- ⚠️ 富文本（post 风格格式化；不支持完整的 Feishu/Lark 原生编写能力） -原生 Feishu/Lark 音频气泡使用 Feishu `audio` 消息类型，并要求上传 Ogg/Opus 媒体（`file_type: "opus"`）。现有的 `.opus` 和 `.ogg` 媒体会直接作为原生音频发送。仅当回复请求以语音方式发送（`audioAsVoice` / 消息工具 `asVoice`，包括 TTS 语音消息回复）时，MP3/WAV/M4A 及其他常见音频格式才会通过 `ffmpeg` 转码为 48 kHz Ogg/Opus。普通 MP3 附件会保持为常规文件。如果缺少 `ffmpeg` 或转换失败，OpenClaw 会回退为文件附件并记录原因。 +原生 Feishu/Lark 音频气泡使用 Feishu `audio` 消息类型，并要求上传 Ogg/Opus 媒体（`file_type: "opus"`）。现有的 `.opus` 和 `.ogg` 媒体会直接作为原生音频发送。MP3/WAV/M4A 和其他可能的音频格式，仅在回复请求语音投递时（`audioAsVoice` / 消息工具 `asVoice`，包括 TTS 语音便签回复）才会通过 `ffmpeg` 转码为 48 kHz 的 Ogg/Opus。普通 MP3 附件会保持为常规文件。如果缺少 `ffmpeg` 或转换失败，OpenClaw 会回退为文件附件并记录原因。 -### 线程和回复 +### 话题与回复 - ✅ 行内回复 -- ✅ 线程回复 -- ✅ 回复线程消息时，媒体回复仍会保留线程感知能力 +- ✅ 话题回复 +- ✅ 回复话题消息时，媒体回复会保持话题感知 -对于 `groupSessionScope: "group_topic"` 和 `"group_topic_sender"`，原生 Feishu/Lark 话题群组会使用事件中的 `thread_id`（`omt_*`）作为规范的话题会话键。对于 OpenClaw 转换为线程的普通群组回复，则继续使用回复根消息 ID（`om_*`），这样首轮消息和后续消息会保持在同一个会话中。 +对于 `groupSessionScope: "group_topic"` 和 `"group_topic_sender"`，原生 Feishu/Lark 话题群组使用事件 `thread_id`（`omt_*`）作为规范的话题会话键。对于 OpenClaw 转换为话题的普通群组回复，仍继续使用回复根消息 ID（`om_*`），以便首轮和后续轮次保持在同一个会话中。 --- ## 相关内容 -- [渠道概览](/zh-CN/channels) — 所有受支持的渠道 -- [配对](/zh-CN/channels/pairing) — 私信身份验证和配对流程 -- [群组](/zh-CN/channels/groups) — 群聊行为和提及门控 +- [渠道概览](/zh-CN/channels) — 所有支持的渠道 +- [配对](/zh-CN/channels/pairing) — 私信认证与配对流程 +- [群组](/zh-CN/channels/groups) — 群聊行为与提及门控 - [渠道路由](/zh-CN/channels/channel-routing) — 消息的会话路由 - [安全](/zh-CN/gateway/security) — 访问模型与加固措施