飞书接入

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

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

​

准备机器人

1. 前往飞书开放平台创建自建应用。
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）。