公众号自动排版与推送全流程
如果你也在运营一个公众号，最让人抓狂的不是写文章，而是写完之后那 5 件事：
进后台 → 新建图文 → 粘贴 → 手动调格式 → 上传封面 → 预览 → 保存。
这套流程跑下来，15 分钟打底。最烦的是 复制粘贴 ——飞书聊天里的格式到了公众号后台经常失灵，加粗、emoji、链接乱飞，每次都要重头调一遍。
本攻略要解决的就是这件事： 让"写公众号"从体力活变成一句话召唤。
「写公众号不再是一场意志力比拼，
而是一句话召唤。」
—— 公众号自动发文攻略
前置 跑通这套流程需要什么
在说"怎么做"之前，先把"需要什么"列清楚。下面这 3 项，全部满足才能继续：
不需要企业认证。个人订阅号即可，要求是你本人有扫码授权权限。
Win / Mac / Linux 均可。本文以 Windows 11 为例，其它系统命令一致。
本攻略基于 OpenClaw / Hermes / 类似的本地 Agent，能跑 skill 即可。
如果您还没有，请看我之前写的沙瑞金攻略。
如果你都有，往下走。
步骤 1 安装 wechat-mp-push skill
这步本质上就是让 Agent 把这个 skill 拉到本地。打开你对 Agent 的对话窗口说一句：
「请安装 wechat-mp-push 这个 skill，公众号自动排版推送用。」
装完后会出现一个文件路径，类似：
# skill 路径
C:\Users\<你的用户名>\.qclaw\skills\wechat-mp-push\
里面有几个文件很关键：
步骤 2 扫码授权（一次性）
这一步把公众号和你的 Agent 连接起来，以后就不需要重复操作了。
当然，以下的步骤，如果您的秘书配置的好，他会一步一步引导你做。
2.1 打开配置向导
浏览器访问下面这个网址：
# 配置向导（一次性使用）
https://app.pcloud.ac.cn/design/wechat-mp-push.html
2.2 手机微信扫码
用 绑定公众号 的微信号（通常是公众号管理员个人微信）扫码 → 同意授权 → 选择你要推送的公众号。
2.3 复制返回的 JSON
页面下方会返回一段 JSON 配置。直接复制，发给 Agent，让它存成
config.json
。
JSON 的样子大概是这样：
{
"version" : 1 ,
"apiBase" : "https://api.pcloud.ac.cn/openClawService" ,
"openId" : "oBDQG1R..." ,
"accounts" : [
{
"name" : "你的公众号名" ,
"appId" : "wx..." ,
"selected" : true
}
]
}
⚠️ 注意： 这份 JSON 包含 openId 和 appId，但 不包含 公众号 AppSecret——这是本 skill 最大的优势，无需泄露 Secret。
步骤 3 推送第一篇测试稿
配置完成后，跑一次完整流程验证。先让 Agent 生成一份测试稿：
写一篇测试稿
让 Agent 按 design.md 规范生成一份简短的 HTML 推文（约 200-300 字够测试格式）。
按 design_cover.md 生成封面 HTML
封面单独写一个 900×383 的 HTML 文件，命名 <主文件名>_cover.html，与主 HTML 放在同一目录。
调用推送脚本
在终端 cd 到 skill 目录，敲一行命令：
# 推送命令（draft 表示推到草稿箱，不直接发布）
cd wechat-mp-push
node push-to-wechat-mp.js <你的 appId> html <主文件名>.html draft
去公众号后台草稿箱看效果
30 秒内公众号后台"草稿箱"会出现新内容。从草稿箱点"预览"看效果，没问题再"群发"。
⚠️ 注意： 推送脚本返回"网络超时"是常见情况， 不要重复推 。去草稿箱看一眼，确认内容是否到位即可。
参考 完整写作流程一览
把这套系统用熟之后，一次发文的标准流程是这样的：
你对 Agent 说「帮我写一篇关于 XX 的公众号推文」
Agent 按 design.md 规范写出主 HTML + 封面 HTML
Agent 用 Humanizer-zh.md 规则自动过一遍去 AI 味
Agent 调用推送脚本，主 HTML + 封面 HTML 一并发出
30 秒后你收到草稿箱就绪通知，进后台点群发
手动方案
15+
分钟/篇
自动方案
30秒
一句话召唤
排坑 几个常见的坑
坑 1：推送脚本报 413 / Payload 过大
正文 HTML 字符串超过约 50KB 就会被服务端拒掉。最常见原因是正文里 base64 内联了大图。
解法： 如果要用图，压到 540px 宽以内，质量 60-70%，base64 应该能控制在 20KB 以内。
坑 2：收到"检测到网络超时"
这是 正常 的成功提示。脚本端按规则超时不重复推，去草稿箱看一眼即可。
坑 3：公众号草稿箱看不到
推送的 sendMode 默认是
draft
（草稿箱）。如果你的账号选了
publish
会直接发布，
不建议先用 publish 测试
。
坑 4：JSON 里没有 selected: true
如果多账号配置，每个账号必须有一个
selected: true
，否则推送时脚本不知道推给谁。
「攻略的本质不是把每一步都罗列出来，
而是告诉你哪些坑可以绕开。」
—— 公众号自动发文攻略
以上就是公众号自动排版+推送的全套流程。从安装到第一篇推送，熟练的话 10 分钟能跑完。
本文为攻略类教程，工具版本：wechat-mp-push v3.0.6 / 2026.07.10