配置
IM 通道
连接消息平台、绑定接收 Agent,并排查消息收发问题。
把消息接入工作台
IM 通道用于从消息平台接收请求并让绑定的 Agent 处理。它与读取文档、代码等业务资源的连接器分别配置。接入后,消息会沿通道的绑定关系进入对应会话。
当前产品包含个人微信 iLink、企业微信、飞书、钉钉、Telegram 和 Discord 等通道实现。可用入口与配置要求以你的版本和通道详情为准,不同平台的登录方式并不相同。
配置一条通道
- 打开 能力 → 频道,选择需要的平台。
- 阅读平台要求,准备机器人凭据、应用配置或扫码登录条件。
- 在对应字段填入配置,按需要完成授权。
- 检查连接账号与配对/绑定状态,确认目标 Agent 正确。
- 从自己的测试会话发送一条普通消息,检查 Nexus 是否收到并回复。
测试通过后再将机器人加入工作群组。群组中的成员和材料可能会进入 Agent 上下文,应先明确使用范围。
为外部用户或群配对
通道在线后,打开 能力 → 配对,将外部用户或群绑定到正确的 Agent 与会话。缺少配对时,通道可能已经连接,但消息仍不会进入预期任务。完整操作见外部消息配对。
收不到消息时
先确认账号在线、机器人已启用、配对正确,以及平台要求的事件订阅或长连接已建立。再查看 Nexus 的通道状态与服务日志。
不同平台使用轮询、长连接或回调,所需配置各不相同。按对应通道页面和平台说明填写。
收到但没有回复
确认绑定的 Agent 和模型可用,当前任务没有等待审批,平台允许机器人向该目标发送消息。Nexus 中的任务成功与平台发送成功需要分别核对。
网络超时后先查看目标平台是否已有消息,避免重复发送。授权结果待确认时保留当前状态并刷新核对,确认后再决定是否重试。
长期在线与多副本
消息通道依赖持续运行的服务。桌面退出或服务器停止时,连接可能中断。长期值守需要保持服务在线,并监控通道状态。
同一数据库的多个后台实例可能争抢轮询或长连接,造成重复消息或断连。当前部署应保持后台 worker 的单实例约束,详见部署与运维。
管理凭据
通道凭据应放在配置表单中,避免写入 Skill、记忆和工作区。变更平台凭据后同步更新 Nexus,并做一次收发验证。备份时一起保留凭据加密密钥,参见备份指南。