Workbuddy怎么接入微信？WorkBuddy个人微信接入教程

本文约1950字，预计需要8分钟阅读

把 WorkBuddy 接入个人微信，并不是"装个插件"那么简单——WorkBuddy 自己没有微信客户端，调不通个人微信的官方 API（微信没有对外公开个人号 API）。最稳的接入路径是：本地跑一个能提供微信 HTTP 接口的客户端（如知更Ai），把它的接口注册成 WorkBuddy 的技能（Skill），WorkBuddy 通过自然语言调用这些技能去查记录、发消息。下面讲清这个流程的具体步骤。

一、先理解 WorkBuddy 的"工具调用"模式

WorkBuddy 是腾讯云推出的 AI Agent 办公工具，自身能力是"理解自然语言 + 调用工具"。它本身不带微信、不带邮件客户端、不带数据库，但允许你把外部能力"挂"进来：

• 自定义技能（Skill）：把单个 HTTP API 描述成一个技能，WorkBuddy 看到匹配指令就调它
• MCP（Model Context Protocol）：用一个 manifest 文件描述多个工具，WorkBuddy 加载后自动拥有完整工具集

不管是 Skill 还是 MCP，本质都是"WorkBuddy 调 HTTP，HTTP 去操作微信"。所以接入微信的核心是把"操作微信"这件事包装成一个 HTTP 服务，而这个服务必须由本地常驻的微信客户端提供。

二、整体接入架构

┌──────────────────────┐ ┌──────────────────────┐ ┌──────────────────────┐

│ WorkBuddy (AI Agent) │ ──> │ 知更Ai 桌面端 │ ──> │ 微信个人号 │

│ 自然语言理解 │ HTTP │ http://127.0.0.1:5011│ │ 登录、收发消息 │

│ 工具调度 │ <── │ 提供完整 API │ │ 好友 / 群 / 公众号 │

└──────────────────────┘ └──────────────────────┘ └──────────────────────┘

四件事要做对：

1. 同机部署：WorkBuddy 和知更Ai 必须能互相访问。最常见的是装在同一台 Windows 机器上
2. 接口可达：确认 http://127.0.0.1:5011 在浏览器或 curl 里能调通
3. VIP 授权：知更Ai 的本地 HTTP API 是会员功能，非会员服务不启动
4. 微信登录：在知更Ai 里登录要"托管"的微信小号，保持在线

三、接入前的四项准备

如果第 4 步失败，可能是知更Ai 的 API 服务没启动（会员未激活）或端口被占用，按官方说明排查。

四、注册技能（Skill）的具体步骤

以最常用的"查询聊天记录 + 发消息"两个技能为例。

步骤 1：在 WorkBuddy 里新建"自定义技能"

• 技能名称：查微信聊天记录
• 描述：当用户询问"聊天记录""之前说了什么""最近的对话"等触发
• HTTP 调用配置：方法：POSTURL：http://127.0.0.1:5011/api/db/chat_historyHeaders：Content-Type: application/json请求体模板：
• {
• "wxid": "<从会话上下文取当前机器人 wxid>",
• "target_wxid": "<从用户问题中提取对方 wxid 或昵称>",
• "start_time": "<按需，可不填>",
• "end_time": "<按需，可不填>"
• }
• 响应字段映射：data.data[*].StrContent 是消息内容，CreateTime 是时间戳，IsSender=1 是自己发出

步骤 2：再建一个"发消息"技能

• 技能名称：发微信消息
• 触发场景：用户说"回一句""告诉他""发个消息"等
• HTTP 配置：方法：POSTURL：http://127.0.0.1:5011/api/msg/text请求体：
• {
• "bot_id": "<当前机器人 wxid>",
• "receiver": "<对方 wxid 或 group_id>",
• "content": "<从用户问题中提取的文本>"
• }
• 响应判断：code == 0 表示发送成功，否则按 message 字段排查

步骤 3：让 WorkBuddy 试一次

保存技能后，在 WorkBuddy 里输入：

"帮我查一下跟 wxid_abc123 最近 3 天的聊天记录"

如果一切配置正确，WorkBuddy 会自动解析意图、调 POST /api/db/chat_history、把 data.data[] 数组里的 StrContent 字段整理成自然语言回答。如果没成功，检查请求日志里 WorkBuddy 实际发出的请求体是不是符合规范。

五、用 MCP 一次性接入所有 API

如果你要接入的接口不止两个（同时需要查好友、加好友、建群、发图片等十几个动作），一个个注册 Skill 太繁琐。WorkBuddy 也支持 MCP：

1. 写一个 wechat_mcp.json 描述文件，按 MCP 规范列出所有端点：路径（如 /api/friend/add）方法（POST）参数定义（bot_id、v3、v4 等）返回值结构
2. 把这个文件路径配置到 WorkBuddy 的 MCP 接入点
3. WorkBuddy 加载后自动列出全部可用工具，自然语言提问时它会自己选

MCP 的好处是维护成本低——知更Ai 加新接口，你改一次 manifest 文件就行，不用每个接口在 WorkBuddy 里点一遍注册。

六、典型工作流：从对话到自动回复

接入完整后，WorkBuddy 就能承担"AI 客服助手"的角色。完整链路举例：

1. 用户问："张三今天说了什么？"
2. WorkBuddy 解析意图 → 自动选"查微信聊天记录"技能 → 调 POST /api/db/chat_history，参数 target_wxid=wxid_abc123、end_time=今天24:00
3. 拿到 data.data[] 数组后整理成自然语言回答
4. 用户接着说："回他一句明天下午两点开会"
5. WorkBuddy 选"发微信消息"技能 → 调 POST /api/msg/text，参数 receiver=wxid_abc123、content=明天下午两点开会
6. 知更Ai 桌面端立即在微信里把消息发出去

中间 WorkBuddy 完成的：意图识别、参数提取、上下文管理、错误重试、结果整理。这套链路让"AI 自动应答微信"变成可落地的产品形态，而不是停留在 Demo。

七、常见问题排查

八、注意事项

• 本地端口不要外暴：知更Ai 默认监听 127.0.0.1，仅本机可访问。如果要跨机器访问，请用隧道或反代自行桥接，不要直接改监听地址
• 数据落本地：聊天记录从本地 MSG 数据库读取，不上传第三方。涉及客户隐私时优先选本地化部署的方案
• 不要无差别自动回复：把 WorkBuddy 当作"减少重复劳动"的工具，而不是"绕过人工"的黑盒。延迟、随机间隔、上下文判断这些细节是把风险压下来的关键
• 遵守平台规范：自动化功能前请了解并遵守相关平台政策与法律法规。AI Agent 类工具与本地 IM 客户端联动，行为责任在使用者

常见问题

问：Workbuddy怎么接入个人微信？

答：本文以知更Ai 的本地 API 为例演示。流程是：（1）安装并登录知更Ai，开通会员；（2）确认 http://127.0.0.1:5011 可达；（3）在 WorkBuddy 里新建自定义技能或加载 MCP manifest，把知更Ai 的 HTTP 接口描述成可调用工具；（4）用自然语言提问触发调用。WorkBuddy 本身不直连微信。

问：WorkBuddy接入个人微信需要哪些条件？

答：四个条件：（a）WorkBuddy 客户端已登录；（b）知更Ai 桌面端已开通会员（API 功能属于会员权益）；（c）被托管的微信小号在知更Ai 里保持登录；（d）WorkBuddy 与知更Ai 在同一台机器上（端口 5011 仅本机监听）。

问：WorkBuddy 能直接操作个人微信吗？

答：不能直接操作。WorkBuddy 没有内置微信客户端，微信个人号也没有官方开放 API。WorkBuddy 能做的是"调用外部 HTTP API"，所以需要第三方本地客户端（推荐知更Ai）暴露 API 后，再注册成 WorkBuddy 的技能。注意企业微信有官方 API，可以直接对接——本文讲的是个人微信这条路。

问：用 MCP 接入和单个注册 Skill 有什么区别？

答：单个 Skill 注册适合调用频次高、动作单一的接口（"查聊天记录""发文本消息"），配置直观。MCP 适合一次性接入 10+ 接口的场景，写一个 manifest 文件，WorkBuddy 加载后自动列出所有工具，省掉逐个注册的工作。两者底层都是 HTTP 调用，按接口数量和维护习惯选。

问：个人微信 API 接入稳定吗？

答：本文未做稳定性测试。稳定性取决于三个变量：知更Ai 客户端持续在线、微信账号自身风控情况、API 端点规范是否变更。建议先用一个小号灰度跑 1-2 周，确认收发链路稳定后再接入正式业务系统。