Workbuddy怎么接入微信WorkBuddy个人微信接入教程本文约1950字预计需要8分钟阅读把 WorkBuddy 接入个人微信并不是装个插件那么简单——WorkBuddy 自己没有微信客户端调不通个人微信的官方 API微信没有对外公开个人号 API。最稳的接入路径是本地跑一个能提供微信 HTTP 接口的客户端如知更Ai把它的接口注册成 WorkBuddy 的技能SkillWorkBuddy 通过自然语言调用这些技能去查记录、发消息。下面讲清这个流程的具体步骤。一、先理解 WorkBuddy 的工具调用模式WorkBuddy 是腾讯云推出的 AI Agent 办公工具自身能力是理解自然语言 调用工具。它本身不带微信、不带邮件客户端、不带数据库但允许你把外部能力挂进来自定义技能Skill把单个 HTTP API 描述成一个技能WorkBuddy 看到匹配指令就调它MCPModel Context Protocol用一个 manifest 文件描述多个工具WorkBuddy 加载后自动拥有完整工具集不管是 Skill 还是 MCP本质都是WorkBuddy 调 HTTPHTTP 去操作微信。所以接入微信的核心是把操作微信这件事包装成一个 HTTP 服务而这个服务必须由本地常驻的微信客户端提供。二、整体接入架构┌──────────────────────┐ ┌──────────────────────┐ ┌──────────────────────┐│ WorkBuddy (AI Agent) │ ── │ 知更Ai 桌面端 │ ── │ 微信个人号 ││ 自然语言理解 │ HTTP │ http://127.0.0.1:5011│ │ 登录、收发消息 ││ 工具调度 │ ── │ 提供完整 API │ │ 好友 / 群 / 公众号 │└──────────────────────┘ └──────────────────────┘ └──────────────────────┘四件事要做对同机部署WorkBuddy 和知更Ai 必须能互相访问。最常见的是装在同一台 Windows 机器上接口可达确认http://127.0.0.1:5011在浏览器或 curl 里能调通VIP 授权知更Ai 的本地 HTTP API 是会员功能非会员服务不启动微信登录在知更Ai 里登录要托管的微信小号保持在线三、接入前的四项准备项怎么做WorkBuddy 安装从腾讯云官方渠道下载安装并登录知更Ai 安装桌面端安装开通会员确保 API 服务启动监听 5011微信登录在知更Ai 里扫码登录被托管的微信小号网络可达性验证在 WorkBuddy 所在机器上curl http://127.0.0.1:5011/api/account/self_info返回code0即正常如果第 4 步失败可能是知更Ai 的 API 服务没启动会员未激活或端口被占用按官方说明排查。四、注册技能Skill的具体步骤以最常用的查询聊天记录 发消息两个技能为例。步骤 1在 WorkBuddy 里新建自定义技能技能名称查微信聊天记录描述当用户询问聊天记录之前说了什么最近的对话等触发HTTP 调用配置方法POSTURLhttp://127.0.0.1:5011/api/db/chat_historyHeadersContent-Type: application/json请求体模板{wxid: 从会话上下文取当前机器人 wxid,target_wxid: 从用户问题中提取对方 wxid 或昵称,start_time: 按需可不填,end_time: 按需可不填}响应字段映射data.data[*].StrContent是消息内容CreateTime是时间戳IsSender1是自己发出步骤 2再建一个发消息技能技能名称发微信消息触发场景用户说回一句告诉他发个消息等HTTP 配置方法POSTURLhttp://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写一个wechat_mcp.json描述文件按 MCP 规范列出所有端点路径如/api/friend/add方法POST参数定义bot_id、v3、v4等返回值结构把这个文件路径配置到 WorkBuddy 的 MCP 接入点WorkBuddy 加载后自动列出全部可用工具自然语言提问时它会自己选MCP 的好处是维护成本低——知更Ai 加新接口你改一次 manifest 文件就行不用每个接口在 WorkBuddy 里点一遍注册。六、典型工作流从对话到自动回复接入完整后WorkBuddy 就能承担AI 客服助手的角色。完整链路举例用户问张三今天说了什么WorkBuddy 解析意图 → 自动选查微信聊天记录技能 → 调POST /api/db/chat_history参数target_wxidwxid_abc123、end_time今天24:00拿到data.data[]数组后整理成自然语言回答用户接着说回他一句明天下午两点开会WorkBuddy 选发微信消息技能 → 调POST /api/msg/text参数receiverwxid_abc123、content明天下午两点开会知更Ai 桌面端立即在微信里把消息发出去中间 WorkBuddy 完成的意图识别、参数提取、上下文管理、错误重试、结果整理。这套链路让AI 自动应答微信变成可落地的产品形态而不是停留在 Demo。七、常见问题排查现象原因处理WorkBuddy 调用 Skill 时报 connection refused跨机器访问 5011 端口被拒确认 WorkBuddy 与知更Ai 同机或建立端口隧道调通了但code-1知更Ai 会员未激活或微信未登录检查会员状态和微信登录状态WorkBuddy 不会主动选技能技能描述太泛把触发场景和参数说明写得更具体群消息发出但没生效receiver用了对方昵称而非 wxid改为 wxid 或group_idMCP 加载后看不到工具manifest 文件路径错误或格式不符检查文件路径和 JSON 语法八、注意事项本地端口不要外暴知更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接入个人微信需要哪些条件答四个条件aWorkBuddy 客户端已登录b知更Ai 桌面端已开通会员API 功能属于会员权益c被托管的微信小号在知更Ai 里保持登录dWorkBuddy 与知更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 周确认收发链路稳定后再接入正式业务系统。