WorkBuddy 接入公众号保姆级教程：20 分钟搭建 AI 自动写稿工作流
摘要：WorkBuddy 是近期极具潜力的 AI Agent 平台。本文将为你详细讲解如何将 WorkBuddy 接入公众号，利用开源 MCP 服务，打造“一句话生成文章 -> 自动排版 -> 自动同步公众号草稿箱”的爆款工作流。全程本地部署，保障数据安全，只需 20 分钟即可跑通。
本文目录
- 你需要准备什么
- 第一步：获取公众号 AppID 和 AppSecret
- 第二步：安装并配置微信 MCP 服务
- 第三步：配置 API 调用 IP 白名单
- 第四步：WorkBuddy 连通性测试
- 第五步：AI 自动写稿正式使用指南
- 常见问题排查（FAQ）
- 核心注意事项总结
WorkBuddy 太火了，我预测它将是下半年最火的 Agent，没有之一。原因大家懂的，依托庞大的生态体量，再加上 AI 领域的深度布局，尽早熟悉 WorkBuddy 绝对是抢占红利的关键。
网上关于 WorkBuddy 基础安装的教程很多，这里不再赘述。作为 AI 应用层的重度玩家，今天我重点分享一个高阶玩法：如何把微信公众号接入 WorkBuddy，实现全自动化的写稿与发布同步。
接入完成后，你的公众号写作流程将极简化为： 我输入一句话指令 → WorkBuddy 自动生成爆款文章 → 自动排版并发送到公众号草稿箱 → 我在后台审阅后直接发布。
整个过程我亲自踩坑并跑通，以下是整理出的标准化接入流程，照着做，20 分钟搞定。
你需要准备什么
在开始将 WorkBuddy 接入公众号之前，请先对照检查以下基础设施：
| # | 准备项 | 怎么检查与获取 |
|---|---|---|
| 1 | WorkBuddy | 确保已安装并能正常对话响应 |
| 2 | Python 3.10+ | 电脑终端/CMD 输入 python --version 确认版本 |
| 3 | pip 包管理器 | 电脑终端/CMD 输入 pip --version |
| 4 | Git 环境 | 电脑终端/CMD 输入 git --version |
| 5 | 微信公众号 | 需认证的订阅号或服务号，登录 公众平台，确认左侧有「开发」菜单 |
| 6 | 代码编辑器 | VS Code / PyCharm / Cursor 均可，能打开本地文件夹就行 |
| 7 | 清晰的内容定位 | 明确你的公众号赛道与风格，直接影响 AI Agent 的生成质量 |
💡 提示：如果你的公众号还没有开发者权限，请先前往微信公众平台申请认证。个人未认证订阅号不支持高级开发者 API 接口。
第一步：获取公众号 AppID 和 AppSecret
这是 WorkBuddy 接入公众号的“钥匙”，后续配置必不可少。
- 登录微信开发者平台：https://developers.weixin.qq.com/platform
- 导航路径：左上角 → 我的业务与服务 → 公众号 → 开发密钥
- 首次使用请点击「激活」生成密钥。注意：AppSecret 只显示一次，请务必立刻复制并妥善保存！
请记录好这两个关键信息：
- AppID：
wx开头的一串字符 - AppSecret：一长串十六进制字符
第二步：安装并配置微信 MCP 服务
WorkBuddy 主要是通过 MCP（Model Context Protocol） 来连接外部服务的。这里我们使用开源工具 wechat_oa_api_mcp。它的优势是完全本地部署，你的 AppID、AppSecret 和文章内容都保存在本地机器上，不经过任何第三方服务器，极其安全。
2.1 让 WorkBuddy 自动安装
打开 WorkBuddy 对话框，直接下达指令：
「帮我安装 wechat_oa_api_mcp，它是一个微信公众号 MCP 服务」
WorkBuddy 会非常智能地自动克隆该开源项目到本地并安装依赖。
2.2 填入公众号配置信息
用你习惯的代码编辑器打开 WorkBuddy 刚才创建的项目文件夹。 找到项目根目录下的 .env 文件（如果没有则新建一个，或在 config.yaml 中配置，视具体项目结构而定），将第一步获取的密钥填入：
# .env 文件配置示例
WECHAT_APP_ID=你的AppID填这里
WECHAT_APP_SECRET=你的AppSecret填这里2.3 启动 MCP 服务
在项目根目录下打开终端，依次执行以下命令：
# 安装必要的 Python 依赖包
pip install -r requirements.txt
# 启动微信 MCP 服务（默认监听 8000 端口）
python main.py
启动成功后，打开浏览器访问 http://localhost:8000/docs，如果能看到 Swagger 接口文档页面，说明本地 MCP 服务已正常运行。
⚠️ 高频踩坑点：这个 MCP 服务必须保持运行，WorkBuddy 才能连上公众号。终端一旦关闭，服务就会停止。长期高频使用，建议用
nohup、pm2等工具将其做成后台常驻服务。
第三步：配置 API 调用 IP 白名单
微信官方出于安全考虑，要求调用 API 的网络出口 IP 必须在白名单内，否则调用时会直接报错 errcode: 40164。
3.1 获取你当前的公网 IP
如果是 Windows 用户，打开 PowerShell 输入以下命令：
curl ifconfig.me⚠️ 注意：截图分享给他人时，记得给自己的公网 IP 打码以防隐私泄露。
3.2 在微信后台添加白名单
进入 微信公众平台 → 设置与开发 → 安全中心 → IP 白名单，将刚才获取到的 IP 地址填入并保存。
⚠️ 防坑指南：如果你使用的是家庭宽带、手机热点或开启了 VPN 代理，你的公网 IP 是动态变化的。一旦网络变化，API 就会报错，需要重新回后台加白名单。最一劳永逸的办法是租用一台带有固定公网 IP 的云服务器来部署 MCP 服务。
第四步：WorkBuddy 连通性测试
配置全部搞定后，我们要测试一下 WorkBuddy 到微信公众号的整条链路是否畅通。在 WorkBuddy 对话框输入：
「帮我测试一下微信公众号接入是否正常」
WorkBuddy 会自动执行一套标准流程：获取 Access Token → 创建测试草稿 → 删除测试素材。如果它回复全部通过，恭喜你，链路完美打通！
第五步：AI 自动写稿正式使用指南
工作流搭建完毕，现在开始体验 WorkBuddy 自动运营公众号的魅力。
5.1 发送指令生成文章
你可以把一个选题灵感或者大纲直接丢给 WorkBuddy：
指令模板参考： 「请根据以下选题写一篇公众号文章，用 HTML 格式排版，字数 1500 左右。标题用
<h1>标签，正文段落用<p>标签，小标题用<h2>标签。完成后请直接创建草稿，同步到我的公众号草稿箱。 选题方向：【输入你的选题内容】」
接到指令后，WorkBuddy 将自动在后台完成：
- ✍️ 撰写爆款内容（按要求的 HTML 结构排版）
- 🖼️ 上传匹配的封面图
- 📝 调用 API 将内容直接同步至公众号草稿箱
5.2 登录后台审阅发布
你只需要登录 微信公众平台，点击左侧的 草稿箱，预览刚刚 AI 生成的文章，确认无误或做轻微微调后，点击发布即可。
常见问题排查（FAQ）
Q1：同步到草稿箱里的文章显示乱码怎么办？
这是由于 MCP 传输过程中的 HTML 编码错乱导致的。不用慌，WorkBuddy 自己就能修。 截个图发给它，并配上文字：
「草稿箱里的文章显示乱码，帮我排查并修复 HTML 编码」
AI 会自动检查请求头编码（UTF-8）并重新同步。修复后刷新公众号草稿箱即可恢复正常：
Q2：突然无法生成，API 报错 errcode: 40164？
百分之百是你的 IP 地址发生变化了。回到本文的【第三步】操作，重新获取目前的公网 IP，填入微信公众平台的白名单中即可。
核心注意事项总结
将 WorkBuddy 接入公众号确实能极大提升生产力，但长期运营需注意以下几点：
- 绝对的数据安全：本教程使用的
wechat_oa_api_mcp是纯本地部署。所有的密钥和文章数据都只在你自己的电脑上流转，不存在被第三方截获的风险。 - 坚持“草稿箱 + 人工确认”机制：千万不要让 AI 直接群发！保持同步到草稿箱，由你做最后一道主编把关，确保文章的价值观和最终排版无误。
- 注意服务运行状态：每次准备让 WorkBuddy 写稿前，确保本地终端未关闭，且 http://localhost:8000/docs 能够正常访问。
跑通这个工作流后，你在公众号运营上耗费的机械劳动时间将趋近于零。剩下的精力，请全部聚焦于核心选题的挖掘和内容深度的打磨上，这才是 AI 时代创作者不可替代的护城河。