消息通道 - 无影 Agent 专属云电脑

通过消息通道配置，管理员可以建立 IM 平台（钉钉、飞书、企业微信）与 Agentic Computer 之间的通信桥梁。配置完成后，员工即可在 IM 客户端群聊或私聊中，通过 @机器人 的方式直接调用绑定的 Agent。系统采用长连接模式，安全且高效，无需企业配置公网回调地址或开放入站防火墙端口。

消息通道总览

登录Agentic Computer管理控制台。
在左侧导航栏，选择连接与通道 > 消息通道。
页面展示全局数据统计卡片：
- 已登记机器人：当前企业已成功接入并建立连接的机器人总数。
- 活跃绑定：当前企业正在运行的「IM 会话 ⇄ Agent」绑定关系总数。
- 今日消息：今日通过 IM 通道交互的累计消息条数。

登记机器人

在消息通道页面，单击登记机器人。

在登记机器人面板，根据选择的平台填写信息：

钉钉

配置项	说明
IM 平台	选择钉钉。钉钉采用 Stream 长连接模式。
机器人名称	自定义在 AC 控制台内展示的机器人名称。
AppKey	钉钉开放平台应用的 `AppKey`。
AppSecret	钉钉开放平台应用的 `AppSecret`。
RobotCode	仅当您对接的是钉钉第三方企业应用或群模板机器人时，才需要在此处填入在钉钉开发者后台获取的唯一 RobotCode。
会话范围	固定值：内部群和内部员工私聊。不支持员工/部门范围与外部群。

飞书

配置项	说明
IM 平台	选择飞书。飞书采用长连接（事件订阅）模式，无需配置回调地址与加密密钥。
机器人名称	自定义在 AC 控制台内展示的机器人名称。
Appld	飞书应用的 `AppID`（以 `cli_` 开头）。
AppSecret	飞书应用的 `AppSecret`。
会话范围	固定值：内部群和内部员工私聊。不支持员工/部门范围与外部群。

企业微信

配置项	说明
IM 平台	选择企业微信。企业微信采用智能机器人 WebSocket 模式，无需 CorpId 与回调配置。
机器人名称	自定义在 AC 控制台内展示的机器人名称。
Botld	企业微信智能机器人的 `Botld`。
BotSecret	企业微信智能机器人的 `BotSecret`。
会话范围	固定值：内部群和内部员工私聊。不支持员工/部门范围与外部群。

所有输入的敏感凭证仅在首次点击保存时写入一次，服务端不回显，页面也不进行任何缓存与展示。后续如需修改，只能通过“更新凭证”重新覆盖输入。

点击登记机器人。
保存后，系统自动验证凭据并建立连接，通道进入运行状态。如果通道未进入运行状态，可查看机器人通道表的最近错误。

机器人通道

成功登记后，机器人将出现在消息通道页面的机器人通道列表中。系统会自动向平台发起长连接握手，进入后台轮询。

运行状态

状态	含义说明	处置建议
验证中	正在对输入的凭证进行接口可用性校验。	等待数秒即可。
运行中	长连接（Stream/WebSocket）建立成功，服务正常运行。	机器人已准备就绪，员工可正常发起绑定。
异常	应用凭证失效、轮换或网络握手超时。	可在列表的最近错误列查看具体报错，进行针对性排障。
已停用	管理员手动将该通道暂停服务。	暂时拦截所有来自该机器人的消息输入。

运维操作

在机器人通道列表的操作列中，支持以下运维操作：

更新凭证：当 IM 平台侧的安全凭证发生定期轮换时，在此处同步填入新凭证进行覆盖。
重试：仅当通道状态为异常时可见。用于排查网络或配置问题后，手动触发重新建立长连接握手。
停用/启用：管理员可随时一键暂停该机器人的通信服务。停用后，原有的会话绑定关系与历史配置仍会妥善保留，重新启用后即可恢复。

企业活跃绑定

消息通道页面的企业活跃绑定列表展示全企业的「IM 会话 ⇄ Agent」绑定关系。

如何绑定（以钉钉为例）

员工侧申请：员工申请一个一次性的绑定码。
群内激活：员工在钉钉群聊或与机器人的私聊中发送 @机器人 /bind <绑定码>。
关系确立：绑定成功后，该绑定关系将实时回传并注册到控制台的企业活跃绑定列表中。
消息拦截：若群内未完成此项绑定，群成员向机器人发送的任何消息都将无法触发任务，系统仅会自动返回一条用于引导绑定的系统提示。

管理员解绑

管理员可在企业活跃绑定列表对违规或失效的绑定执行解绑。解绑后，该会话立即停止响应且不可恢复，员工需重新申请绑定码绑定。