微信公众号发布器

自动化工具，支持通过 API 发布文章到微信公众号。支持 Markdown 和 HTML 两种输入格式，内置 MD→微信HTML 转换器，包含自动 Access Token 管理、多账号支持、封面图和正文图片自动上传、图片 URL 替换和草稿创建功能。

快速开始

前置要求

用户需要：

• - 微信公众号（已认证的订阅号或服务号）
• 微信开发者ID（AppID）和开发者密码（AppSecret），在基本配置中获取
• Python 3.x（Python版本）
• 在微信后台启用功能：access_token、草稿、素材权限

配置指南

当用户请求发布到微信时，引导他们完成：

1. 1. 创建配置文件：复制 config.example.json 为 config.json
2. 填写凭证：编辑 config.json 填入 AppID 和 AppSecret
3. 安装依赖：

1. 4. 测试连接：用示例内容运行脚本

获取 AppID 和 AppSecret

引导用户：

1. 1. 登录：https://mp.weixin.qq.com
2. 导航：开发 → 基本配置
3. 复制：开发者ID (AppID) 和 开发者密码 (AppSecret)

使用模式

常见用户请求

直接发布：

• - 将这篇文章发布到我的公众号
• 为这个内容创建草稿
• 发布这篇文章，使用这张封面图
• 这篇文章里有本地图片，帮我上传并替换

定时发布：

• - 下周一上午9点发布这个文章（创建草稿，用户稍后手动发送）
• 每周五早上发布文章（使用 OpenClaw cron 任务触发脚本）

内容格式化：

• - 将这篇 markdown 文章格式化后发布到微信
• 将这篇博客转换为微信格式并创建草稿
• 上传这张图片作为封面，正文里的图片也要上传

图片处理：

• - 帮我上传这几张图片到公众号
• 文章里的本地图片自动替换成微信 URL

正文图片自动上传

智能检测：

脚本会自动扫描 HTML 内容中的 标签：

• - 本地路径：自动上传并替换为微信素材 URL
• 外部 URL：自动上传并替换为微信素材 URL

示例 HTML：

html

这是第一段内容。

第二段内容...

执行后自动变成：

html

这是第一段内容。

第二段内容...

执行方式

方法 1：从 Markdown 文件发布（推荐）

bash

直接发布 .md 文件，自动转 HTML + 上传所有图片

指定图片目录和作者

直接传入 Markdown 字符串

方法 2：从 HTML 文件发布

bash
python publish_article.py 文章标题 article.html --from-file --thumb cover.jpg --content-dir ./images

方法 3：直接传入 HTML 内容

bash
python publish_article.py 标题

Hello

World

方法 2：通过 OpenClaw Cron

创建 cron 任务触发脚本执行：

bash
python scripts/publish_article.py 定时文章 \
--config config.json \
--thumb cover.jpg \
--content-dir ./images

方法 3：先生成，再发布

1. 1. 使用 AI 生成文章内容（可包含本地图片路径）
2. 格式化为微信支持的 HTML
3. 执行发布脚本，自动处理所有图片

脚本参考

主要发布脚本位于 scripts/：

• - publish_article.py: Python 实现，使用 httpx，支持命令行参数
• config.example.json: 配置模板
• README.md: 详细的设置和使用说明

选择版本的考虑：

• - 如果用户偏好 Python 生态或已有 Python 环境，使用 Python 版

配置文件格式

config.json 支持多个微信公众号账号：

json
{
wechat: {
defaultAccount: account1,
accounts: {
account1: {
name: 账号名称,
appId: yourappid,
appSecret: yourappsecret,
type: subscription,
enabled: true
},
account2: { ... }
},
apiBaseUrl: https://api.weixin.qq.com,
tokenCacheDir: ./.tokens
}
}

关键字段：

• - appId: 微信 App ID
• appSecret: 微信 App Secret（注意安全保管）
• type: subscription（订阅号）或 service（服务号）
• enabled: true/false 启用或禁用账号

图片上传支持

封面图

• - 格式：JPG、JPEG、PNG
• 大小限制：不超过 64MB
• 建议尺寸：900 × 383 像素（2.35:1 比例）
• 用途：文章列表显示的封面

正文图片

• - 格式：JPG、JPEG、PNG、BMP、GIF
• 大小限制：不超过 2MB（单张）
• 用途：嵌入在文章内容中
• 自动处理：脚本自动上传并替换为微信素材 URL

使用方式

1. 封面图单独设置：

bash
python publish_article.py 标题 内容 --thumb cover.jpg

2. 正文图片自动上传：
只需在 HTML 中使用本地路径，脚本自动处理：

html

段落

3. 文字内容 + 多张图片：

html

我的文章

开头内容...

中间内容...

结尾内容...

图片路径说明

相对路径（推荐）：

• - 默认从当前目录查找
• 可通过 --content-dir 指定基础目录
• 示例：、

绝对路径：

• - 直接使用完整路径
• 示例：

外部 URL：

• - 不上传，保持原样
• 示例：

文章内容格式

微信需要特定的 HTML 格式：

基本结构：

html

段落内容...

章节标题

更多内容...

重要要求：

• - 使用
  包裹内容
• 只使用闭合标签（不要使用
  这样的自闭合标签）
• 推荐使用 HTTPS 图片链接
• 避免复杂 CSS（微信有限制）
• 正文图片会自动处理，无需手动上传

Markdown 支持（自动转换）

直接发布 Markdown 文件，无需手动转换 HTML！

脚本内置 MD→微信HTML 转换器，使用 --from-md 参数即可：

bash
python publish_article.py 文章标题 article.md --from-md --thumb cover.jpg

支持的 Markdown 语法