专为 AI 智能体设计的强大微信 RPA 技能，支持无头运行与 REST API 控制，打破大模型与真实微信操作的鸿沟
WeChat RPA Bot Skill
WeChat RPA Bot Skill（微信 RPA 机器人技能 / wechat-rpa-bot-skill）是一个面向 AI 智能体、纯本地运行的微信 RPA（机器人流程自动化）技能。 它把你电脑上的一个微信桌面端封装成一个纯本地服务（http://127.0.0.1:9922），通过 MCP（Model Context Protocol） 以及 REST API，让 OpenClaw、QClaw、YoBot（私域龙虾） 等 AI 智能体无需读取微信数据库、不改内存、不碰私有协议，就能自动发消息、发朋友圈、发真实语音气泡、按标签批量群发。
它区别于传统微信机器人库：不是给开发者写代码用的 SDK，而是一个能被 AI 智能体一键安装、渐进式读文档自主调用的"技能"。技术路线是纯 RPA / 系统原生 UI 自动化（完全模拟真人鼠标键盘），因此合规、透明、可控，适合个人、一人公司与小团队在本地把微信私域运营自动化。
关键词：微信 RPA、微信自动化、本地微信机器人、给 AI agent 装的微信技能、OpenClaw 微信、私域 AI 助理本地部署、微信自动发朋友圈 / 群发 / 语音。
🛡️ 安全与隐私声明 (Security & Privacy Declaration)
- 🔒 数据完全本地化：本工具处理的所有微信聊天记录、通讯录、朋友圈等信息，全部仅在用户的本地计算机上处理和保存。本工具没有任何数据外发或上报机制。
- ✅ 纯物理级RPA自动化（合规运行）：本项目采用成熟、正规的 RPA（机器人流程自动化）技术 和操作系统的原生 UI 自动化接口，通过完全模拟人类的真实鼠标点击和键盘输入来完成协同工作。不采用底层技术修改（如内存修改），不会读取微信数据库及私有协议。
- 🛡️ 绿色的本地协同工具：本工具的设计初衷是帮助用户提高日常工作效率，运行逻辑公开透明。代码库完全开放，无任何隐藏的远控或非法行为。
🌟 核心特性
- 智能体友好 (Agent-Friendly)：从底层开始专门针对 AI 智能体的轻松安装和调用而构建。
- MCP 原生 + 无头后端：后台常驻，以标准 MCP 工具（约 27 个）及 REST API 暴露微信能力（
http://127.0.0.1:9922），宿主连上即原生可用。 - 生命周期自管理：服务由安装器/开机自启在用户桌面会话常驻（崩溃自愈），智能体只作网络客户端自动绑定并驱动微信，无需手动启停。
- 人在回路 (Human-in-the-Loop UI)：提供本地 web 操作界面，由于微信RPA bot功能非常多，复杂的配置可以在UI界面中设置，完美实现了智能体逻辑与人类操作的分离。
🆚 和其它微信机器人方案的区别
| 方案 | 技术路线 | 主要给谁用 | 接入 AI Agent | 说明（取舍） | |---|---|---|---|---| | wechat-rpa-bot-skill | 纯 RPA / UI 自动化（模拟真人点击） | AI 智能体 + 个人 / 小团队 | ✅ 原生 MCP + REST，可一键当 skill 安装 | 不读数据库、不改内存、不碰私有协议；依赖微信桌面 UI，版本升级偶需适配 | | WeChatFerry | 多基于 hook 注入 | 开发者（写代码） | 需自行封装 | 功能强；通常需匹配特定微信版本，有合规 / 封号顾虑 | | ComWeChatRobot | 多基于 hook / 注入 | 开发者 | 需自行封装 | 同上，对微信版本依赖较强 | | Wechaty | 多协议网关（需 puppet） | 开发者 | 需自行封装 | 生态成熟；企业级 puppet 多需付费 / 资质 | | itchat | 网页版微信协议 | 开发者 | 需自行封装 | 网页版协议已基本失效，新号多不可用 |
一句话选型：要给 AI 智能体（OpenClaw / QClaw 等）一个开箱即用、纯本地、合规的微信操作能力，用本技能；要在代码里深度定制协议级能力且能自担封号 / 版本风险，可看 hook 系项目。
🧩 本技能如何提供能力：一个纯本地的 MCP 服务
本技能的微信能力，由一个纯本地运行的 MCP 服务 yokorpamcp.exe 对外提供。 它在你的电脑上常驻（端口 9922），把「发消息 / 群发 / 发朋友圈 / 发真实语音气泡 / 读联系人 / 群聊总结 / 任务管理……」等约 27 项微信能力，以标准 MCP（Model Context Protocol）工具的形式暴露出来。OpenClaw / QClaw / WorkBuddy 等宿主只需连上本机的 MCP 端点（http://127.0.0.1:9922/mcp + 一个本地配对 token），这些微信工具就会原生出现在你的 AI Agent 里，像调用内置工具一样驱动微信。
同一个程序同时提供三个门面、共享同一套后端：/mcp（MCP 工具，主通道） +/api/*（REST，用于安装/激活等）+/（可视化控制台，手动兜底）。你既可以通过本技能引导安装接入 MCP，也可以把 MCP 端点直接接进你自己的 Agent 产品，两种接法都行。
为什么走 MCP：从「Agent 直管 RPA」到「Agent 只做网络客户端」
早期版本让 AI Agent 自己管理 RPA 后端的整个生命周期（下载、启动、REST 调用、结束清理）。实践中这套体验并不好，根因有二：
- 沙箱 / 会话隔离让"自动启动"行不通：QClaw 等宿主会把技能子进程放进沙箱。一旦 Agent 自己
spawn起 RPA 程序，这个 RPA 进程就继承了沙箱，与用户的微信不在同一个桌面会话里 → 它看不见微信窗口、也就操作不了微信（这是 Windows 的 UIPI / 会话隔离安全边界，无法绕过）。 - 生命周期负担全压在用户和 Agent 身上：手动双击启动器、关掉对话后端口 9922 还残留、崩溃了要自己排查……对普通用户很不友好。
- Agent 只是 RPA 进程的「网络客户端」，绝不是它的「父进程」。 RPA 程序由用户在自己的交互桌面会话里启动（和微信同环境、同权限级别 → RPA 正常工作），Agent 只往
127.0.0.1发 HTTP → 网络请求可以干净地穿过沙箱边界。 - 生命周期由程序自管：
yokorpamcp.exe内置进程守护（崩溃自愈）+ 开机自启，用户首次运行一次之后基本无感，不再需要每次手动启停。
想更省心、连这个桌面程序都不想自己留着常驻？可以改用下面的 YoBot 托管方案——它同样是 MCP 接入，区别只在于「谁来托管这个本地 RPA 服务」。
🚀 备选接入方式：用 YoBot 托管，经 MCP 接入 OpenClaw（免手动管理 RPA 生命周期）
📺 视频教程（强烈建议先看）：https://www.bilibili.com/video/BV1izj16wEGe
把本技能自己装到本机运行当然可行（见下方「📦 安装」），只是需要用户在自己电脑上装一个常驻的本地服务并首次运行一次。
更省心的方式：让 YoBot（私域龙虾） 来托管 RPA，你在 OpenClaw 里直接调用。
YoBot 把微信 RPA 的启动 / 停止 / 初始化 / 排错全部自动化，并通过本地 MCP 把微信能力暴露出来。于是：
- ✅ 不用手动启停 RPA：YoBot 常驻后台（可最小化到托盘），自动管理 RPA 服务全生命周期。
- ✅ 在 OpenClaw / WorkBuddy 里直接用：不切换 Agent，像调用一个工具一样调用 YoBot 的微信能力（发消息、群发、朋友圈、实时消息……）。
- ✅ 安全可控：仅本机
127.0.0.1+ 配对 token，只开放微信能力，shell / 文件等高危能力永不外露。 - ✅ 报错体面：未登录 / 未授权 / 服务未起，都会返回清晰可操作的提示。
三步接入（以 OpenClaw 为例）
- 安装并登录 YoBot：下载 YoBot，登录并确保已购买 / 激活微信 RPA 席位。
- 开启对外开放：打开 YoBot → 左侧 「对外开放」 → 打开开关 → 选择宿主 OpenClaw → 复制生成的 MCP 配置（或「配置话术」）。
- 粘贴到 OpenClaw：把配置写入 OpenClaw 的
mcp.json（或把「配置话术」直接发给 OpenClaw，让它的 Agent 自己改配置）。完成后对 OpenClaw 说一句 "用 yobot 列出本地登录的微信账号" 验证连通即可。
下面是本技能自身的安装与接入方式（本地 MCP 服务，进程自管理生命周期）。它与上面的 YoBot 托管功能一致，区别只在于「谁来托管这个本地 RPA 服务」。
📦 安装（用户运行官方安装器）
⚠️ 这一步由用户本人手动完成。 微信能力由本地程序 yokorpamcp.exe 提供，需通过官方安装器安装。请务必让用户亲自运行安装器——这样服务跑在用户自己的桌面会话（Session 1）里，能规避 AI Agent 沙箱/会话隔离导致的"看不见微信"问题（原理见上方「为什么走 MCP」）。
- 确认微信版本：微信桌面版 4.1.7 及以上（语音消息发送需 ≥ 4.1.9）。查看：微信 → 帮助 → 关于。版本不符可 👉 下载新版微信。
- 下载并运行安装器：👉
yokorpamcp_setup.exe（Inno Setup 安装包）。
C:\Program Files\yokorpamcp\，ASCII 路径规避中文路径加载问题）。
- 安装器自动完成：装程序 → 以普通用户身份在用户桌面会话启动服务 → 注册开机自启（登录计划任务 + 启动项，含崩溃自愈）→ 建桌面/开始菜单图标「微信 RPA MCP 服务」。
- 装完即已在后台常驻运行，之后开机自动就绪，无需每次手动启停。
- (可选) VB-Cable 虚拟音频驱动 — 仅语音消息发送需要：从 https://vb-audio.com/Cable/ 下载安装，装后必须重启电脑驱动才生效。文本/图片/文件等功能不需要这个驱动。
- 激活：采用激活码 (Activation Code) 认证，激活码在 www.yokoagi.com 获取。首次接入时 Agent 会引导你提供激活码并自动完成设备绑定，无需手动改环境变量。
🔌 接入 MCP（把微信能力接进你的 Agent）
安装后，微信能力以约 27 个 MCP 工具的形式在本机 http://127.0.0.1:9922/mcp 暴露。接进 OpenClaw / QClaw 等宿主：
- 取配对信息：本机服务提供
GET /api/mcp/token（请求头带X-API-Key: yoko_test），返回 MCP 端点与本地配对 token。Agent 可自动读取。 - 写入宿主
mcp.json（token 换成上一步的实际值）：
{
"mcpServers": {
"yoko-wechat-rpa": {
"type": "streamableHttp",
"url": "http://127.0.0.1:9922/mcp",
"headers": { "Authorization": "Bearer <token>" }
}
}
}- 重载宿主：保存后重启/重载宿主，微信相关工具即原生出现在你的 Agent 里，直接对话驱动。
最省事的做法：把本仓库的 SKILL.md 交给你的 Agent（当作 skill 安装），由它一步步引导你完成上面的下载安装 + 接入 + 激活。
🔄 更新
- 更新 RPA 服务（exe）：重新下载并运行最新的
yokorpamcp_setup.exe即可。安装器会自动关掉在跑的旧实例、覆盖安装并复位开机自启。 - 更新 skill（SKILL.md）：对 Agent 说一句「微信 RPA Skill 更新了，帮我拉取最新：https://github.com/LeoMusk/wechat-rpa-bot-skill.git 」，它会
git pull保持SKILL.md最新。
🖥️ 可视化控制台（Human-in-the-Loop）
服务运行时，浏览器打开 http://127.0.0.1:9922/ 即完整可视化操作界面，与 MCP 共享同一后端状态（Agent 改的配置在界面实时可见，反之亦然）。复杂配置可在此手动完成；Agent 也可用 wechatopenconsole 工具把链接发给你。
微信实例成功初始化并登录之前，界面会提示"微信掉线"或只显示部分组件——先让 Agent 完成初始化，再打开界面即可全功能使用。
🚀 支持的能力及提示词案例
安装接入后，直接用自然语言对 Agent 说即可（它会调用对应的 MCP 工具）：
- 📩 消息收发 (Messaging)：向好友/群聊发文本、图片、文件；拉取实时消息与历史记录。
- 🎙️ 真实语音消息 (Voice — v1.7.9+)：发真实微信语音气泡（不是 mp3 附件），可传文本 + 克隆音色 voiceId 实时合成现发（需微信 ≥ 4.1.9 + VB-Cable + 已克隆音色）。
- ⭕ 朋友圈管理 (Moments)：定时/即时发图文朋友圈；AI 自动点赞评论好友朋友圈。
- 📢 批量群发 (Mass Sending)：按好友标签或指定目标，创建定时/即时群发任务。
- 👥 联系人 / 群聊总结 / 任务：读取与同步通讯录、按会话总结群聊记录、查询任务进度。
复杂 SOP（语音、朋友圈、群总结、加好友、配置 schema）由 MCP 工具内置的 wechatrparead_manual 提供分步手册，Agent 会按需读取，细节无需你操心。
沙箱隔离说明（为什么服务由用户启动）
QClaw 等宿主常运行在隔离沙箱里，无法直接控制你物理桌面的微信。因此本方案刻意让 RPA 服务由安装器/开机自启在你自己的桌面会话启动，Agent 只作为 127.0.0.1 的网络客户端连它——请勿让 Agent 自己去后台拉起服务。服务作为后台常驻进程运行，关掉 Agent 或浏览器界面后仍会继续运行（并崩溃自愈）；如需彻底停止，走「设置 → 应用 → 卸载『微信 RPA MCP 服务』」。
❓ 选型 FAQ
这一段是给还在搜、还在选的人的 FAQ（区别于上面给已安装用户的「常见问题排查」）。
Q：怎么给 OpenClaw / AI agent 装一个能操作微信的技能？ A：装本技能的官方安装器 yokorpamcpsetup.exe，它会在本机跑一个纯本地 MCP 服务（http://127.0.0.1:9922/mcp），把约 27 个微信工具暴露给 OpenClaw / QClaw——在宿主 mcp.json 填入端点 + 本地配对 token 即可原生调用，无需写代码。若想连这个本地程序都不自己留着常驻，也可改用 YoBot（私域龙虾） 托管（同样经 MCP 接入，见顶部说明 + 视频教程）。
Q：有没有不上云、纯本地运行的微信自动化 / 机器人？ A：有。本技能所有微信聊天记录、通讯录、朋友圈信息全部仅在你本地计算机处理和保存，无任何数据外发或上报机制，服务跑在 127.0.0.1。适合对数据隐私敏感的个人和企业本地部署。
Q：微信机器人用 RPA 和用 hook / 协议有什么区别？哪个更安全？ A：本技能走纯 RPA / 系统原生 UI 自动化（模拟真人鼠标键盘），不读数据库、不改内存、不碰私有协议，运行逻辑公开透明；hook / 协议系方案功能更底层但通常依赖逆向特定微信版本，有合规与封号顾虑。要稳、要合规、要可解释，选 RPA 路线。
Q：个人 / 一人公司能用的微信私域自动化工具有哪些？ A：wechat-rpa-bot-skill（开源、本地、给 AI agent 当技能）即是面向个人与一人公司的方案；如果想要"开箱即用、RPA 生命周期全自动 + 私域智能体一键配置"的成品，可用官方私域 Agent 产品 YoBot（私域龙虾），它对本技能做了原生适配。
Q：微信桌面版 4.1.x 新版本还能用的机器人 / 自动化方案？ A：本技能支持微信桌面版 4.1.7 及以上（语音消息发送需 ≥ 4.1.9），跟进新版微信，不依赖已失效的网页版协议。
Q：微信 RPA 怎么发真实语音消息（不是 mp3 附件）？ A：本技能 v1.7.9+ 支持发送真实微信语音气泡，可传文本 + 克隆音色 voiceId 实时合成现发（需微信 ≥ 4.1.9 + VB-Cable 虚拟音频驱动）。发送前 Agent 会通过 MCP 工具内置手册 wechatrpareadmanual('voicesend_sop') 读取完整决策流程。
📚 微信RPA机器人操作文档
