企业微信接入

使用智能机器人长连接

当前 Nexus 接入的是企业微信智能机器人，使用 Bot ID、Secret 和长连接收发成员或群消息。企业应用的 Corp ID、群 Webhook 地址属于其他接入方式，不能填进这套表单。

准备可管理智能机器人的企业微信账号，并先确认目标 Agent 在 Nexus 内能正常回答。

扫码绑定已有机器人

打开 能力 → 频道 → 企业微信，通过扫码入口完成绑定。手机端确认后返回 Nexus，检查绑定的机器人与连接状态。

有权登录企业微信不等于有权配置所有机器人。授权页面不提供目标机器人时，先确认账号所属企业与管理范围，不要通过更换 Nexus 模型尝试解决。

手工填写凭据

使用已有机器人时，将同一机器人的两项凭据填入表单。

字段	内容
Bot ID	智能机器人标识
Secret	对应机器人的密钥
Long Connection URL	默认 wss://openws.work.weixin.qq.com

保留默认长连接地址。它是 WebSocket 地址，不能替换成普通群机器人的 HTTP Webhook。平台配置入口以企业微信开发者文档为准。

保存后查看连接结果，核对机器人是否对测试成员可用。长连接由 Nexus 维持，宿主退出会影响收发。

配对成员并测试

从企业微信向机器人发送一条文本，在 Nexus 能力 → 配对 中找到对应成员，绑定到测试 Agent 和会话。

这是企业微信机器人测试，请只回复“已收到企业微信测试”。

配对完成后重新发送，检查 Nexus 会话收到请求，企业微信原会话收到结果。回复使用平台原生流式能力，最终结果仍应以实际收到的消息为准。

扩展到群聊

将机器人用于目标测试群，确认群成员可使用该机器人。检查该群在 Nexus 中的配对及接收 Agent，随后在群里完成同样的文本测试。

成员私聊成功只证明那条私聊链路可用。群聊的可用范围、配对和发送目标需要分别核对。

连接失败与回复失败

情况	处理
长连接无法建立	核对 Bot ID 与 Secret 是否匹配、端点及出站网络
扫码后仍待确认	刷新机器人连接状态，不重复提交旧二维码
机器人可见但无请求	检查当前成员或群的可用范围与配对
Nexus 中已出现请求	转到目标会话处理模型或审批问题
结果已完成但未送达	检查原聊天与平台发送错误，再决定重试

Secret 轮换后同步更新 Nexus，并用新消息重新验证。更换机器人时重新核对成员和群关系，避免把任务送给旧的绑定目标。