> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerone.run/llms.txt
> Use this file to discover all available pages before exploring further.

# 飞书接入

> 配置飞书或 Lark 机器人，在聊天中向桌面 Agent 发送任务。

飞书消息渠道把聊天消息转交给正在运行的 Zerone 桌面端。它与[飞书 CLI](/zh/app/lark-cli)分别配置：消息渠道负责对话入口，CLI 负责操作飞书资源。

## 准备机器人

1. 前往[飞书开放平台](https://open.feishu.cn/)创建自建应用。
2. 为应用启用「机器人」能力。
3. 在凭证页面获取 App ID 和 App Secret。
4. 添加接收消息事件 `im.message.receive_v1`，使用长连接接收事件。
5. 按组织要求发布应用版本并完成审批。

不要把 App Secret 发到群聊或存入公开文档。

## 连接桌面端

1. 打开「工具 > 消息渠道」，进入「飞书设置」。
2. 选择平台：国内版选择飞书，国际版选择 Lark。
3. 填写 App ID 和 App Secret，点击「测试连接」。
4. 保存配置，启用飞书渠道和消息渠道主开关，并启动服务。
5. 向机器人发送一条测试消息，确认桌面端收到请求并回复。

## 限定使用范围

在「访问与行为」中配置：

* **私信策略**：开放、配对、白名单或禁用。
* **允许来源**：指定允许访问的用户 open\_id。
* **群聊策略**：开放、白名单或禁用；可指定允许的群组 chat\_id。
* **需要 @提及**：仅在群聊中提及机器人时响应。
* **话题会话**：为不同话题保留独立上下文。

建议从自己的私聊或小范围白名单开始，不要把能访问电脑文件的机器人直接开放给所有人。

## 无法响应时

先检查凭据测试结果、应用发布状态、事件订阅和访问策略，再确认 Zerone 正在运行且渠道已经启动。通用命令和权限确认方式见[消息渠道（Beta）](/zh/app/channels)。