WechatExplorer/docs/agent/agent-hub.md

Agent Hub：让微信机器人参与实时工作

Agent Hub 是 WechatExplorer 内置的实时微信交互入口。你先在应用中扫码登录一个微信机器人账号，之后向这个机器人发送文字；本机 Agent Hub 会接收消息、读取已经连接的微信数据，必要时调用已配置的 AI，再把结果回复给发消息的人。

它和 Reader Skill 是两条不同的路径：

• Reader Skill / Local HTTP API：外部 Agent 主动查询历史微信数据；
• Agent Hub / 微信机器人：机器人收到实时消息后处理并回复。

连接器和 Agent Hub 是什么关系

你不需要单独部署这些组件。扫码后，后台的微信连接器负责登录机器人、保持连接、接收微信消息和发送回复；Agent Hub 负责判断消息要做什么、查询 WechatExplorer 本地数据、调用 AI 并组织结果。可以把它理解为：连接器负责“和微信通信”，Hub 负责“处理任务”。

你能做什么

连接 Agent Hub 后，可以在微信中询问：

• “最近 5 条消息是谁？”
• “帮我看看最近跟某人聊了些什么。”
• “生成产品交流群今天的群聊总结图片。”

当前已实现的实时任务包括：

• 查看最近会话（数量限制为 1–20）；
• 查询你和某位联系人的近期聊天；
• 用已配置的 AI 总结你和某位联系人近 7 天的聊天；
• 生成今天、昨天或近 7 天的群聊总结图片；
• 总结指定群成员在群里的近期发言；
• 对不需要读取聊天的普通文字请求返回简短 AI 回复。

任务完成后，回复会发送回触发这次请求的微信用户。群聊总结会先发送进度提示，完成后发送图片。

这些任务会在后台查询联系人、群聊和聊天记录，但当前机器人没有单独的“列出所有联系人”或“列出所有群聊”命令；需要完整浏览或按条件查询时，请使用档案页面或 Reader Skill / Local HTTP API。

连接步骤

1. 打开应用主导航中的“Agent”；页面标题为“Agent Hub”。
2. 确认 Hub 显示“运行中”，数据库状态为“可查询”。
3. 点击“扫码登录微信机器人”。
4. 用微信扫描二维码；如果页面显示“已扫码，等待手机确认”，在手机上确认。
5. 状态变为“在线”后，从该机器人账号发送测试问题。

可以重新扫码登录或断开连接。登录凭证失效时，需要重新扫码。

运行日志

Agent Hub 页面会记录系统、Agent Hub 和微信连接器日志。日志支持筛选、复制和清空，并会隐藏 Token 和二维码数据，不记录微信密码。

需要满足的条件

• WechatExplorer 的微信数据库已经连接，并且数据 API 可以查询；
• 依赖总结或自然语言理解的任务，需要在“设置 → AI 模型”配置可用的 AI 服务；
• WechatExplorer 和 Agent Hub 需要保持运行，机器人才能接收和回复消息。

安全与边界

• Hub 使用本机通信，不把数据库直接暴露到公网；
• 机器人账号和个人微信账号是不同的登录边界，请确认你连接的是正确账号；
• 机器人回复会发送给当前发消息的人；开发者 API 另有受保护的测试发送入口，使用前必须确认接收者；
• Hub 生成群聊总结时仍可能调用你配置的 AI Provider；
• 当前实时自然语言入口主要处理文字消息。底层连接器可以接收图片、语音、文件和视频，但 Agent Hub 尚未为这些媒体提供同等的实时意图处理；
• 当前没有实现群发、广播、定时任务或通用自主操作微信；
• 本页面的“Agent Hub 状态”可以通过 Local HTTP API 查询，但不要把它误认为外部 Agent 的实时消息订阅接口或 MCP Server。

无法连接时

先检查 Hub、连接器和数据库三项状态，再查看日志。二维码过期、连接器不存在、凭证失效和数据 API 未就绪分别需要重新扫码、修复安装、重新登录或先完成微信数据库连接。