手把手教你用 OpenClaw 自动发布微信公众号文章

从 Markdown 到公众号草稿，全程自动化

前言

你是否想过，用 Markdown 写一篇文章，然后自动发布到微信公众号？

不需要打开公众号后台，不需要手动排版，不需要上传配图。

今天，我来分享我是怎么用 OpenClaw 实现这个流程的。

一、准备工作

1. 安装微信公众号插件

执行命令：openclaw plugins install clawhub:holo-wechat-mp

安装完成后，OpenClaw 会自动加载三个技能：

• wechat-mp-typeset — Markdown 排版
• wechat-mp-manage — 素材管理
• wechat-mp-publish — 发布流程

2. 配置公众号信息

编辑文件 ~/.openclaw/extensions/holo-wechat-mp/.env，填入 AppID 和 AppSecret。

3. 安装依赖

执行命令：uv pip install pyyaml markdown requests

二、Markdown 文章准备

1. 文章结构

使用标准 Markdown 格式写文章：

• 标题用 # 标记
• 章节用 ## 标记
• 引用用 > 标记
• 图片用 ![描述](路径) 插入

2. 配图方式

在 Markdown 中使用 ![描述](路径) 插入图片：

• 本地图片：![描述](./images/photo.jpg)
• 网络图片：![描述](https://example.com/photo.jpg)

三、排版生成 HTML

使用 typeset.py 将 Markdown 转换为微信公众号兼容的 HTML：

执行命令：uv run python <skill-dir>/scripts/typeset.py article.md --output article.html --preview article.preview.html --theme minimal

输出两个文件：

• article.html — 排版后的 HTML（用于发布）
• article.preview.html — 浏览器预览文件

四、下载配图

微信公众号要求配图必须是真实图片文件，不是 HTML 页面。

执行命令：uv run python -c "import requests; r = requests.get('图片URL'); open('local.jpg','wb').write(r.content)"

注意事项：

• 图片必须是 jpg 或 png 格式
• 图片不能是 HTML 页面（常见错误）
• 图片大小不超过 10MB

五、创建草稿

使用 submit_html_draft.py 创建公众号草稿：

执行命令：uv run python <skill-dir>/scripts/submit_html_draft.py article.html --cover cover.jpg --title "文章标题" --author "作者名" --digest "文章摘要"

返回 media_id 即表示成功。

六、发布文章

确认草稿无误后，发布文章：

执行命令：uv run python <skill-dir>/scripts/manage.py draft publish --media-id MEDIA_ID --confirm-media-id MEDIA_ID

注意：两个 MEDIA_ID 必须一致，否则不会发布。

常见问题

1. IP 白名单错误

原因：服务器 IP 不在公众号白名单中

解决：登录 mp.weixin.qq.com，设置与开发，开发资质，IP 白名单，添加当前服务器 IP。

2. AppSecret 错误

原因：.env 文件中的 AppSecret 不正确

解决：检查 .env 文件，确保没有省略号。AppSecret 只显示一次，需立即复制保存。

3. 图片格式错误

原因：图片不是真实图片文件

解决：检查图片文件是否完整，重新下载图片。

4. Token 过期

原因：access token 已过期

解决：重新获取 access token 后重试。

总结

整个流程总结：

1. 写文章 — Markdown 格式
2. 排版 — typeset.py 生成 HTML
3. 配图 — 下载图片文件
4. 草稿 — submit_html_draft.py
5. 发布 — manage.py draft publish

从写文章到发布，全程自动化！

2026年7月9日
by 村长

这篇文章由 OpenClaw 自动排版发布