本文约2000字，预计需要9分钟阅读
"让 WorkBuddy 直接操控微信"的真实含义是：让 WorkBuddy 这个 AI Agent 通过自然语言指令，触发本地 HTTP API，进而代你完成微信消息的查询、发送、自动回复等操作。WorkBuddy 本身没有内置微信客户端，微信也没有对外开放个人号 API，所以"直接操控"必须借道一个能挂在后台的本地客户端——本文以知更Ai 为例演示完整接入路径，从环境准备到跑通第一个指令一共六步。
一、什么是"WorkBuddy 直接操控微信"
把它拆开理解：
- WorkBuddy：腾讯云推出的 AI Agent 办公工具，擅长"理解自然语言 + 规划工具调用"
- 直接操控：通过本地 HTTP 调用，绕过人工介入，让微信动作（发消息、查记录、加好友等）由 AI 自动完成
- 个人微信：相对于企业微信，没有官方 API，必须借助第三方客户端实现
所以路径是：
你 ──自然语言指令──> WorkBuddy ──HTTP──> 知更Ai 本地 API ──> 微信
↑ ↓
└──────────────── 返回结果 ←─────────────────────────┘
读懂这条链路，下面所有的配置动作才有依据。
二、前置环境与依赖
开始之前确认这四件事到位：
| 项 | 要求 |
|---|---|
| 操作系统 | Windows 10/11（WorkBuddy 桌面端 + 知更Ai 都需 Windows） |
| WorkBuddy | 已安装并登录腾讯云账号 |
| 知更Ai | 已安装、已开通会员（本地 HTTP API 属于会员功能）、已登录微信小号 |
| 网络可达 | curl http://127.0.0.1:5011/api/account/self_info 返回 code=0 |
如果第 4 步不通，按"端口被占用""会员未激活""微信未登录"三类常见原因排查。
三、第一步：在 WorkBuddy 中新建"自定义技能"
以最常用的"查询聊天记录"为例，逐步操作。
1. 进入技能管理
WorkBuddy 主界面左侧菜单找「技能」或「Skills」，点「新建技能」→「自定义技能」。
2. 填写基本信息
- 技能名称：查微信聊天记录
- 技能描述：当用户问"聊天记录""之前说了什么""最近的对话""和某某聊了什么"等场景触发
- 触发关键词（可选）：聊天记录、对话、之前、说了什么、聊过什么
3. 填写 HTTP 调用配置
方法： POST
URL： http://127.0.0.1:5011/api/db/chat_history
Headers： Content-Type: application/json
请求体：
{
"wxid": "<自动从上下文取当前机器人 wxid>",
"target_wxid": "<从问题中提取对方 wxid 或昵称>",
"start_time": "<可选>",
"end_time": "<可选>"
}
参数说明：
wxid：当前操作者的微信号，对应知更Ai 中登录的那个微信小号target_wxid：对方的微信号或 wxid。WorkBuddy 会从你的问题里提取start_time/end_time：Unix 时间戳或可解析字符串。如果不填，默认返回最近的聊天记录
4. 配置响应解析
知更Ai 接口返回结构是：
{
"code": 0,
"msg": "success",
"data": {
"data": [
{"StrContent": "你好", "CreateTime": 1700000000, "IsSender": 1},
...
]
}
}
在 WorkBuddy 的响应字段映射里指明：
- 消息内容字段：
data.data[*].StrContent - 时间字段：
data.data[*].CreateTime - 发送方字段：
data.data[*].IsSender（1 是自己发出）
这样 WorkBuddy 能把原始数组整理成自然语言回答。
四、第二步：再建一个"发消息"技能
按相同路径再注册一个：
方法： POST
URL： http://127.0.0.1:5011/api/msg/text
请求体：
{
"bot_id": "<自动从上下文取当前机器人 wxid>",
"receiver": "<对方 wxid>",
"content": "<从问题中提取的文本>"
}
响应判断：code == 0 表示发送成功；code != 0 时把 message 字段直接呈现给用户。
让两个技能形成组合
保存后，WorkBuddy 会自动支持组合指令。比如：
"帮我查一下跟 wxid_abc123 最近 3 天的聊天记录，然后回他一句明天下午两点开会"
WorkBuddy 会自动拆成两步：先调"查聊天记录"技能，再调"发消息"技能。这就是 AI Agent 相对 if-else 的核心优势——多步规划的连贯性。
五、第三步：用 MCP 一次性接入（备选）
如果你要接入十几个接口（好友管理、群管理、文件传输、图片识别等），逐个注册太繁琐，WorkBuddy 也支持 MCP（Model Context Protocol）：
1. 写一个 MCP manifest 文件
JSON 或 YAML 格式，列出所有可用端点：
{
"name": "zhigeng-wechat",
"tools": [
{
"name": "send_text",
"method": "POST",
"endpoint": "/api/msg/text",
"params": {"bot_id": "string", "receiver": "string", "content": "string"}
},
{
"name": "query_history",
"method": "POST",
"endpoint": "/api/db/chat_history",
"params": {"wxid": "string", "target_wxid": "string"}
}
]
}
2. 在 WorkBuddy 中加载
「技能管理 → MCP 接入 → 选择本地 manifest 文件 → 启用」。
3. 立即可用
加载成功后，WorkBuddy 对话框里输入"我有什么工具"会列出全部已注册接口，自然语言提问时它会自动选择。
MCP 的好处是维护成本低——知更Ai 加新接口后改一次 manifest 文件就行，不用逐个在 WorkBuddy 里点注册。
六、第四步：跑通真实场景
场景 A：查聊天记录
你："查一下跟 wxid_abc123 这周聊了什么"
WorkBuddy 内部动作：
- 解析意图 → 选"查聊天记录"技能
- 自动填充
wxid=当前机器人、target_wxid=wxid_abc123、start_time=本周一0点 - 调
POST /api/db/chat_history - 拿到
data.data[]数组后按时间排序整理 - 回答："本周你们聊了 3 次，主要是……"
场景 B：群发通知
你："给 VIP 客户标签里的所有人发'双十一活动今晚 8 点开始'"
WorkBuddy 内部动作：
- 调"查询好友列表"技能，过滤
tags包含 VIP - 拿到 wxid 列表后，对每个 wxid 调"发消息"技能
- 汇总发送结果
场景 C：自动应答
你："设置成对所有新好友自动回一句'你好，我是机器人小助手，请问有什么可以帮你'"
WorkBuddy 内部动作：
- 调用"加好友回调"相关接口
- 调用"发消息"技能回复欢迎语
- 调用"加人标签"技能打标签
七、第五步：调试与日志排查
如果某个指令没按预期执行，按三层定位：
第 1 层：WorkBuddy 是否正确选中了技能
- 检查技能描述是否清晰——描述太泛会导致不触发，描述太窄又会漏触发
- 看 WorkBuddy 是否有"我打算调 XXX 技能"的中间输出
第 2 层：HTTP 请求是否符合规范
- 抓 WorkBuddy 实际发出的请求体（WorkBuddy 提供请求日志）
- 用 curl 手动重放一次，验证接口本身没问题
第 3 层：知更Ai API 是否正常返回
- 知更Ai 的 API 控制台会显示每次调用的状态码、耗时、错误信息
- 常见错误：
code=-1会员失效、code=-2微信未登录、code=-3目标 wxid 不存在
定位到具体层后，按对应方案修复——改技能描述 / 改请求体 / 重新登录微信。
八、第六步：投产前的注意事项
- 延迟与风控：批量自动操作建议加 1-3 秒随机延迟，连续高频调用易触发微信风控
- 白名单与黑白名单：先用小号测试稳定，再向重要账号推广
- 数据本地：聊天记录从本地 MSG 数据库读取，不上传第三方
- 人工兜底：复杂问题、情绪问题、投诉问题保留转人工通道，不要追求 100% 自动化
- 遵守平台规范：自动化功能前请了解并遵守相关平台政策与法律法规
常见问题
问：Workbuddy接入个人微信难不难？
答：本文以知更Ai 为例演示，难度不高。流程是：（1）安装 WorkBuddy 与知更Ai，同机部署；（2）确认 http://127.0.0.1:5011 可达；（3）在 WorkBuddy 中新建自定义技能，按规范填写 HTTP 调用配置；（4）保存后用自然语言测试。单技能配置大约 10 分钟，跑通第一个查询/发送指令大约 30 分钟。
问：Workbuddy能直接操控微信吗？
答：能"间接直接操控"。WorkBuddy 本身不带微信客户端，但它能调本地 HTTP API，由本地客户端（推荐知更Ai）代为操作微信。对用户来说体验就是"你说一句自然语言，微信自动发出去"，所以叫"直接操控"。这是目前最稳的个人微信 AI 自动化路径。
问：WorkBuddy 控制微信和关键词自动回复有什么区别？
答：本质区别是智能程度。关键词自动回复：匹配预设关键词回固定话术，不会变化。WorkBuddy 控制微信：AI 理解上下文，每次根据对话内容生成不同回复；能调用业务 API、能查询聊天记录、能多步规划——是 AI Agent 级别自动化，不是规则触发。
问：单个技能注册和 MCP 批量接入怎么选？
答：按接口数量选。1-5 个高频接口建议逐个注册 Skill，配置直观；10+ 接口建议用 MCP 一次性接入，维护成本低。两者的底层都是 HTTP 调用，差别在配置量和可维护性。
问：WorkBuddy 操控微信稳定吗？
答：本文未做稳定性实测。稳定性取决于三个变量：知更Ai 客户端持续在线、微信账号自身风控情况、API 端点规范是否变更。建议先用一个小号灰度跑 1-2 周，确认收发链路稳定后再接入正式业务系统。