连接企业微信智能机器人

CubePlex 通过出站 WebSocket 连接企业微信智能机器人，不需要配置公网回调地址，但 API 服务必须能通过 443 端口访问 wss://openws.work.weixin.qq.com。

创建机器人

1. 在企业微信桌面端打开 工作台 → 智能机器人 → 创建 → 手动创建。
2. 选择 API 模式创建，连接方式选择 使用长连接。
3. 复制机器人的显示名称和 Bot ID，再获取并复制 Secret。请安全保存 Secret；企业微信 可能只显示一次。
4. 保存机器人。

绑定到 CubePlex

1. 打开 Workspace 设置 → IM，选择 连接 → 企业微信。
2. 完成前置条件检查。
3. 输入 Bot ID、与企业微信中完全一致的机器人显示名称和 Secret，然后点击 连接。 CubePlex 使用显示名称移除群消息开头的 @ 提及，也支持名称中包含空格的机器人。

CubePlex 会先验证凭据，再加密保存；绑定成功后立即建立长连接。一个机器人只允许一个活跃 客户端。若其他产品连接了同一机器人，CubePlex 可能被断开。请先停止冲突客户端，再在 CubePlex 中禁用并重新启用该账号。

关联身份

企业微信回调不提供邮箱。首次运行智能体前，请向机器人发送：

/link you@example.com

登录 CubePlex 后打开机器人返回的链接。该邮箱必须属于机器人所在 Workspace 的当前成员； CubePlex 会在每条消息到达时重新检查成员资格。

使用机器人

• 私聊中可直接发送消息。
• 群聊中需要 @ 机器人。账号的群聊路由设置决定每位成员使用隔离会话，还是全群共享一个会话。
• 发送 /new、/reset 或 新对话，可为当前范围开始新会话。

回复窗口有效时，结果会在原消息中流式显示；耗时较长或延迟执行的任务会改为主动发送最终结果。

轮换凭据

在 CubePlex 中删除企业微信账号，在企业微信中生成或复制当前 Secret，然后重新连接。 禁用会立即关闭连接；重新启用会自动建立连接，无需重启 API。

当前限制

当前仅支持企业微信智能机器人，不支持个人微信、企业应用回调模式、扫码配置、原生图片/文件 传输，也不支持在企业微信内直接完成审批或问答交互。遇到等待输入时，请前往 CubePlex Web UI 继续操作。