OpenClaw 配置微信公众号自动发布工具全流程
写在前面
说实话,之前每次往公众号发文章都要手动排版、复制粘贴,累得够呛。最近终于把 OpenClaw 配置好了,可以直接从 Markdown 一键发布到公众号草稿箱,中间省了很多琐碎的步骤。今天把整个配置过程整理出来,希望能帮到有同样需求的朋友。
效果预览
配置完成后,你可以:
- 用 Markdown 写文章
- 一行命令发布到公众号草稿箱
- 支持代码高亮、多种排版主题
- 甚至可以让 AI 帮你润色文章
—
🔗 前置教程推荐(AI 助手安装):
本套自动化工作流必须依赖 OpenClaw 本体运行。如果你还没有在电脑上安装这位全能 AI 助理,请先阅读这篇 3 分钟速成教程:👉《小白必看!一条命令搞定 OpenClaw 部署,全网最简保姆级教程》
第一步:安装技能
首先确保你的 OpenClaw 已经运行,然后在 skills 目录添加微信公众号发布技能。打开终端(Terminal),输入以下命令:
# 方式一:通过 OpenClaw Hub 安装(推荐)
openclaw skills install wechat-mp-publisher
# 方式二:手动下载安装
git clone https://github.com/caol64/wechat-mp-publisher.git ~/.openclaw/skills/wechat-mp-publisher
安装完成后,检查一下技能是否加载成功:
openclaw skills list
第二步:安装依赖
这个技能依赖几个工具,如果是 Mac 用户,建议使用 Homebrew 提前装好,后面会省心很多:
# 安装 jq(JSON 处理)
brew install jq
# 安装 mcporter(MCP 客户端)
npm install -g mcporter
# 安装 wenyan-cli(文颜排版引擎)
npm install -g @wenyan-md/cli
验证一下文颜引擎是否安装成功:
wenyan --version
# 应该输出 2.0.1 或更高版本
第三步:配置 MCP 服务
这里是关键一步。MCP 服务相当于一个中转站,把你的发布请求发送到微信 API。
1)启动 MCP 服务
wenyan serve --port 3000
服务启动后会显示:
> 文颜 Server 已启动,监听端口 3000
> 健康检查:http://localhost:3000/health
💡 进阶提示(后台常驻):上面的命令在关闭终端后服务就会停止。为了让它在后台持续运行,推荐使用 pm2:
# 安装 pm2 并启动服务
npm install -g pm2
pm2 start "wenyan serve --port 3000" --name wechat-mcp
2)配置 mcp.json
在 ~/.openclaw/ 目录下创建 mcp.json:
{
"mcpServers": {
"wenyan-mcp": {
"name": "公众号发布助手",
"transport": "http",
"url": "http://localhost:3000"
}
}
}
> 注:如果你把 MCP 服务部署在云服务器(VPS),请把 localhost 改成服务器公网 IP。
配置完成后,重启 OpenClaw:
openclaw gateway restart
第四步:获取并配置公众号凭证
在让自动化工具接管发布前,我们需要拿到公众号的 API 钥匙(AppID 和 AppSecret)。
1)获取 AppID / AppSecret
- 打开微信开发者平台:https://developers.weixin.qq.com/platform
- 进入「我的业务」→ 选择公众号/服务号
- 在基础信息中查看 AppID 与 AppSecret
2)写入配置文件
cd ~/.openclaw/skills/wechat-mp-publisher
cp wechat.env.example wechat.env
nano wechat.env
填入:
export WECHAT_APP_ID="wx开头的ID"
export WECHAT_APP_SECRET="公众号密钥"
第五步:添加 IP 白名单
这是最容易卡住的一步。微信 API 强制要求调用者 IP 在白名单内。
curl ifconfig.me
然后在公众号后台「设置与开发 → 基本配置 → IP 白名单」添加该 IP。
> ⚠️ 家宽 IP 经常变,建议把 MCP 服务放到云服务器,用固定 IP。
第六步:测试发布
先写一个测试文件 test.md:
---
title: 测试文章
cover: https://picsum.photos/800/400
---
# Hello World
这是一篇测试文章。
执行发布:
wenyan publish -f test.md --server http://localhost:3000
如果成功,会看到类似输出:
> 发布成功,Media ID: oP2ZhMpFcMX63l…
进阶:AI 写作润色
如果你想让 AI 参与写作优化,还可以安装:
openclaw skills install wechat-mp-writer
它可以:
- 提供选题建议
- 撰写初稿
- 去 AI 味润色
- 给出配图建议并一键发布
常见问题(FAQ)
1)invalid ip not in whitelist
IP 没加白名单,或家宽出口变了。重新查 IP 后添加,或迁移到云端固定 IP。
2)invalid appid / 缺少凭据
检查 wechat.env 中变量名及内容是否正确,确认执行命令时环境变量已加载。
3)图片上传失败 / 配额不足
微信素材上传有日限额。测试阶段建议减少图片,先验证文本发布链路。
总结
前期配置确实有门槛,但跑通后收益巨大:写完即发布,自动排版,大幅减少重复劳动。对内容创作者来说,这套流程非常值得配置。