---
title: 飞书 Bot 配置
pageTitle: 飞书 Bot
eyebrow: Bot 与 IM 接力 Agent
lead: 把 Agent 的消息接入飞书的群或应用会话，并在电脑锁屏后接力。这一页从飞书开放平台创建企业自建应用开始，带你走到在 CCR 里跑通。
---

## 这个方式适合谁

飞书适合团队把 Agent 消息接入飞书群或应用会话。CCR 用 App Secret 方式连接飞书应用。

> 还没看过 Bot 总览？先回到主文档的「把 Agent 消息转发到 IM（Bot）」那一节，了解整体流程和转发 Agent 消息、接力的区别，再回来配单个平台。

## 你会用到哪些字段

| 飞书后台里的名字 | CCR 字段 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| App ID | App ID | 必填 | 应用标识，通常以 `cli_` 开头 |
| App Secret | App Secret | 必填 | 应用密钥 |
| 飞书 / Lark 域 | Domain | 可选 | 国内飞书一般不填；Lark 或特殊域环境再填 |

## 第一步：创建企业自建应用

1. 打开 [飞书开放平台](https://open.feishu.cn/)。
2. 进入 `开发者后台`。
3. 点 `创建应用`。
4. 选 `企业自建应用`。
5. 填应用名，比如 `CCR`。
6. 填应用描述并上传图标。
7. 创建应用。

## 第二步：复制 App ID 和 App Secret

1. 进入刚创建的应用。
2. 打开 `基础信息`。
3. 进入 `凭证与基础信息`。
4. 复制 `App ID`。
5. 复制 `App Secret`。

这两个就是 CCR 里的必填字段。

## 第三步：开启机器人能力

1. 在应用后台打开 `应用能力`。
2. 点 `添加应用能力`。
3. 找到 `机器人`，添加或启用。
4. 设机器人名称和头像。

> 没开机器人能力，飞书聊天窗口可能看不到输入框，也收不到用户消息。

## 第四步：申请消息权限

1. 打开 `开发配置`。
2. 进入 `权限管理`。
3. 添加应用身份权限。
4. 至少开通「读取用户发给机器人的单聊消息」权限。
5. 要在群里 @ 机器人，开通「读取群聊中 @ 机器人消息」权限。
6. 要让 Agent 回复，开通「以应用身份发送消息」权限。
7. 保存。

> 不同租户后台权限名可能略有不同。看到 `im:message.p2p_msg:readonly`、`im:message.group_at_msg:readonly`、`im:message:send_as_bot` 这类标识时，优先选这些。

## 第五步：配置事件订阅

1. 打开 `事件与回调`。
2. 选择长连接（或 WebSocket）模式。
3. 添加事件 `im.message.receive_v1`。
4. 保存。

## 第六步：发布或安装应用

1. 打开 `版本管理与发布`，创建新版本。
2. 确认可见范围，测试时先选你自己或小范围。
3. 提交发布。
4. 企业要审核的话，等审核通过。
5. 在飞书客户端找到这个应用，或把机器人加进目标群。

## 在 CCR 中接入

1. 打开 CCR 的 **Bot 管理** 页面，点 **添加 Bot**。
2. 平台选 **飞书（Feishu）**。
3. 认证方式是 **App Secret**。
4. 填 **App ID** 和 **App Secret**。
5. 用 Lark 或特殊域环境，再填 **Domain**。
6. 保存这个 Bot。
7. 打开 **Agent配置**，编辑你要接 Bot 的 Agent配置。
8. 打开 **Bot** 开关，选刚保存的 Bot。
9. 按需打开 **转发 Agent 消息** 或 **接力**（见下一节）。
10. 从 CCR 重新打开 Agent。

## 消息接力：转发还是接力

- **转发 Agent 消息**：不管锁不锁屏都转发，适合要在飞书里保留完整输出。
- **接力**：只在电脑锁屏后转发，配合 **空闲秒数** 和目标设备。

> 只想锁屏后提醒，别开 **转发 Agent 消息**。

## 测试

1. 从 CCR 打开 Agent，触发一条消息。
2. 到飞书确认应用能收到并回复。
3. 群里用的话，先把应用加进目标群、确认成员可见。

> **怎么算成功：** 飞书里能看到 Agent 消息，你回复后 Agent 也能继续。

## 常见问题

- **认证失败**：重新复制 App ID 和 App Secret。
- **聊天窗口没输入框**：检查机器人能力开了没、事件订阅了没、应用发布到当前成员可见范围了没。
- **群里没响应**：先 @ 机器人测，确认事件订阅含 `im.message.receive_v1`。
- **Lark / 特殊域**：确认 Domain 填的是平台要求的值。
