WechatExplorer/docs/agent/overview.md

在微信机器人或外部 Agent 中使用 WechatExplorer

WechatExplorer 提供两条不同路径。先按你实际想做的事选择，不需要先理解 Agent、Skill 或 API 等术语。

你想做什么	使用方式	需要什么
直接在微信里发文字，让本机查询聊天并回复	微信机器人（Agent Hub）	在应用“Agent”页面扫码登录机器人；部分任务需要 AI Provider
在 Codex、Claude Code、OpenClaw 等工具里查询微信历史	Reader Skill + Local HTTP API	安装 Skill，并配置本机 API Token

直接在微信里提问

打开应用一级导航中的“Agent”，进入“Agent Hub”，扫码登录一个微信机器人账号。之后用另一个微信账号向机器人发送文字，它会调用 WechatExplorer 的本机数据，必要时使用已配置的 AI，再把结果回复给发送者。

可以先尝试：

• “最近 5 个会话”；
• “帮我看看最近跟张三聊了些什么”；
• “生成产品交流群今天的群聊总结图片”。

这条路径不要求安装 Reader Skill，也不要求用户配置 API Token。它主要处理文字请求，不支持群发、定时任务或与文字同等的任意媒体理解。

连接步骤、当前任务清单和安全边界见Agent Hub。

在外部 Agent 中查询历史微信

Reader Skill 是给外部 Agent 的操作说明。安装后，Codex、Claude Code、OpenClaw 或其他本地 Agent 可以通过 WechatExplorer Local HTTP API 按需读取联系人、群聊、最近会话、指定时间范围的聊天和群成员信息。

典型问题包括：

• “总结今天技术交流群讨论的内容。”
• “帮我找上个月讨论过的项目地址。”
• “过去一周有没有人提到退款？”

外部 Agent 不会直接打开微信数据库文件，但它能取得本机 API 返回的聊天内容。Agent 是否继续把结果发送给云端模型，取决于 Agent 自己的模型和工具配置。

外部 Agent 的安装步骤

1. 启动 WechatExplorer 并完成微信数据库连接。
2. 打开一级导航“API”（页面为“API Center”），确认本地 API、数据库和 Reader Skill 都可用。
3. 选择目标 Agent，点击“复制安装指令”。
4. 在 Agent 自己的 Skill/配置目录执行或粘贴指令。
5. 在 API Center 复制当前 Token，并在 Agent 运行环境中设置 WECHATEXPLORER_API_TOKEN。
6. 先让 Agent 调用 health，再尝试查询最近会话。

详细说明：Reader Skill、Local HTTP API、API 安全。

不要混淆两条路径

• Agent Hub：微信机器人收到实时文字后处理并回复；
• Reader Skill/API：外部 Agent 主动查询历史数据；
• 127.0.0.1:6131 是 Local HTTP API，不是 MCP Server；
• Local HTTP API 当前没有对外提供实时入站消息订阅。