# IM 通道

连接消息平台、绑定接收 Agent，并排查消息收发问题。

## 把消息接入工作台

IM 通道用于从消息平台接收请求并让绑定的 Agent 处理。它与读取文档、代码等业务资源的连接器分别配置。接入后，消息会沿通道的绑定关系进入对应会话。

当前产品包含个人微信 iLink、企业微信、飞书、钉钉、Telegram 和 Discord 等通道实现。可用入口与配置要求以你的版本和通道详情为准，不同平台的登录方式并不相同。

## 配置一条通道

1. 打开 **能力 → 频道**，选择需要的平台。
2. 阅读平台要求，准备机器人凭据、应用配置或扫码登录条件。
3. 在对应字段填入配置，按需要完成授权。
4. 检查连接账号与配对/绑定状态，确认目标 Agent 正确。
5. 从自己的测试会话发送一条普通消息，检查 Nexus 是否收到并回复。

测试通过后再将机器人加入工作群组。群组中的成员和材料可能会进入 Agent 上下文，应先明确使用范围。

## 为外部用户或群配对

通道在线后，打开 **能力 → 配对**，将外部用户或群绑定到正确的 Agent 与会话。缺少配对时，通道可能已经连接，但消息仍不会进入预期任务。完整操作见[外部消息配对](/docs/pairing)。

## 收不到消息时

先确认账号在线、机器人已启用、配对正确，以及平台要求的事件订阅或长连接已建立。再查看 Nexus 的通道状态与服务日志。

不同平台使用轮询、长连接或回调，所需配置各不相同。按对应通道页面和平台说明填写。

## 收到但没有回复

确认绑定的 Agent 和模型可用，当前任务没有等待审批，平台允许机器人向该目标发送消息。Nexus 中的任务成功与平台发送成功需要分别核对。

网络超时后先查看目标平台是否已有消息，避免重复发送。授权结果待确认时保留当前状态并刷新核对，确认后再决定是否重试。

## 长期在线与多副本

消息通道依赖持续运行的服务。桌面退出或服务器停止时，连接可能中断。长期值守需要保持服务在线，并监控通道状态。

同一数据库的多个后台实例可能争抢轮询或长连接，造成重复消息或断连。当前部署应保持后台 worker 的单实例约束，详见[部署与运维](/docs/deployment)。

## 管理凭据

通道凭据应放在配置表单中，避免写入 Skill、记忆和工作区。变更平台凭据后同步更新 Nexus，并做一次收发验证。备份时一起保留凭据加密密钥，参见[备份指南](/docs/backup)。