openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh zh-CN translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-13 10:05:55 +00:00
parent 0f747272cc
commit 4471e8ef4d
1 changed files with 156 additions and 504 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

660
docs/zh-CN/channels/feishu.md
View File

@ -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.<id>.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 <CODE>
```
批准后，你就可以正常聊天了。
---
## 概览
- **Feishu 机器人渠道**：由 Gateway 网关管理的 Feishu 机器人
- **确定性路由**：回复始终返回到 Feishu
- **会话隔离**：私信共享主会话；群组相互隔离
- **WebSocket 连接**：通过 Feishu SDK 建立长连接，无需公共 URL
> **需要 OpenClaw 2026.4.10 或更高版本。** 运行 `openclaw --version` 进行检查。使用 `openclaw update` 升级。
<Steps>
<Step title="运行渠道设置向导">
```bash
openclaw channels login --channel feishu
```
使用你的 Feishu/Lark 移动应用扫描二维码，以自动创建一个 Feishu/Lark 机器人。
</Step>
<Step title="设置完成后，重启 Gateway 网关以应用更改">
```bash
openclaw gateway restart
```
</Step>
</Steps>
---
@ -308,38 +46,43 @@ openclaw pairing approve feishu <CODE>
### 私信
- **默认值**：`dmPolicy: "pairing"`（未知用户会收到配对码）
- **批准配对**：
配置 `dmPolicy` 以控制谁可以向机器人发送私信：
```bash
openclaw pairing list feishu
openclaw pairing approve feishu <CODE>
```
- `"pairing"` — 未知用户会收到配对码；通过 CLI 批准
- `"allowlist"` — 只有列在 `allowFrom` 中的用户可以聊天（默认：仅机器人所有者）
- `"open"` — 允许所有用户
- `"disabled"` — 禁用所有私信
- **Allowlist 模式**：设置 `channels.feishu.allowFrom`，填入允许的 Open ID
**批准配对请求：**
```bash
openclaw pairing list feishu
openclaw pairing approve feishu <CODE>
```
### 群聊
**1. 群组策略**（`channels.feishu.groupPolicy`）：
**群组策略**（`channels.feishu.groupPolicy`）：
- `"open"` = 允许群组中的所有人
- `"allowlist"` = 仅允许 `groupAllowFrom`
- `"disabled"` = 禁用群消息
| Value | 行为 |
| ------------- | ---------------------------------- |
| `"open"` | 响应群组中的所有消息 |
| `"allowlist"` | 仅响应 `groupAllowFrom` 中的群组 |
| `"disabled"` | 禁用所有群组消息 |
默认值：`allowlist`
**2. @ 提及要求**（`channels.feishu.requireMention`，可通过 `channels.feishu.groups.<chat_id>.requireMention` 覆盖）：
**提及要求**（`channels.feishu.requireMention`）：
- 显式 `true` = 必须 @mention
- 显式 `false` = 无需提及即可回复
- 未设置且 `groupPolicy: "open"` 时 = 默认为 `false`
- 未设置且 `groupPolicy` 不是 `"open"` 时 = 默认为 `true`
- `true` — 必须 @提及（默认）
- `false` — 无需 @提及也会响应
- 按群组覆盖：`channels.feishu.groups.<chat_id>.requireMention`
---
## 群组配置示例
### 允许所有群组，无需 @mention（开放群组的默认值）
### 允许所有群组，不需要 @提及
```json5
{
@ -351,7 +94,7 @@ openclaw pairing approve feishu <CODE>
}
```
### 允许所有群组，但仍要求 @mention
### 允许所有群组，但仍然要求 @提及
```json5
{
@ -371,16 +114,14 @@ openclaw pairing approve feishu <CODE>
channels: {
feishu: {
groupPolicy: "allowlist",
// Feishu 群组 ID（chat_id）形如：oc_xxx
// 群组 ID 类似于：oc_xxx
groupAllowFrom: ["oc_xxx", "oc_yyy"],
},
},
}
```
### 限制群组中哪些发送者可以发消息（发送者 allowlist）
除了允许群组本身之外，该群中的**所有消息**还会受到发送者 open_id 的限制：只有列在 `groups.<chat_id>.allowFrom` 中的用户，其消息才会被处理；其他成员的消息会被忽略（这是完整的发送者级限制，而不只是针对 `/reset` 或 `/new` 这类控制命令）。
### 限制群组内的发送者
```json5
{
@ -390,7 +131,7 @@ openclaw pairing approve feishu <CODE>
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 <CODE>
---
<a id="get-groupuser-ids"></a>
## 获取群组/用户 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.<id>.appId` | App ID | - |
| `channels.feishu.accounts.<id>.appSecret` | App Secret | - |
| `channels.feishu.accounts.<id>.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.<chat_id>.requireMention` | 按群组覆盖 @mention 要求 | inherited |
| `channels.feishu.groups.<chat_id>.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.<id>.appId` | App ID | — |
| `channels.feishu.accounts.<id>.appSecret` | App Secret | — |
| `channels.feishu.accounts.<id>.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.<chat_id>.requireMention` | 按群组覆盖 @提及要求 | 继承 |
| `channels.feishu.groups.<chat_id>.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) — 访问模型和加固措施