微信公众号文章自动生成发布 — 微信公众号文章自动生成和发布
v1.0.0微信公众号一键发布技能。帮助用户将 Markdown 文章自动发布到公众号草稿箱, 包括:Access Token 获取、封面图生成与压缩、永久素材上传、草稿 JSON 构造与提交。 当用户要求"发布公众号"、"写公众号文章"、"公众号草稿"时触发。
运行时依赖
安装命令
点击复制本土化适配说明
微信公众号文章自动生成发布 — 微信公众号文章自动生成和发布 安装说明: 安装命令:["openclaw skills install wechatdoc-publisher"] 该技能用于微信、公众号相关操作,可能需要相应的平台账号或API密钥
技能文档
微信公众号一键发布 本技能帮助用户将 Markdown 格式的文章自动发布到微信公众号草稿箱。 支持自定义账号配置,适合个人博主和内容创作者使用。
快速开始 首次使用配置 获取公众号凭证 登录 微信公众平台 进入「设置与开发」→「基本配置」 记录 AppID 和 AppSecret 添加 IP 白名单 在同一页面找到「IP白名单」 添加服务器出口 IP:112.8.202.216 否则 API 会返回 40164 错误 创建凭证文件 在工作目录创建 wechat_credentials.json: { "appid": "你的AppID", "appsecret": "你的AppSecret" }
完整发布流程 Step 1:准备文章 文章需为 Markdown 格式,建议结构: # 文章标题 导语段落,简要介绍文章内容...
小节标题1
内容...小节标题2
内容... --- 结语段落... 写作技巧: 主标题用 # 开头 小节用 ## 开头(会转换为加粗标题) 列表项用 - 开头 分割线用 --- 重点用 文字 加粗Step 2:生成封面图 使用「多模态内容生成」技能生成封面图: 生成一张微信公众号封面图,[文章主题描述], 简洁大气,横版 1280×720,16:9比例, PNG格式,主色调 [颜色],留文字排版空间 要求: 分辨率必须为 1280×720(16:9横版) 文件大小需 < 2MB 如超过 2MB,使用 scripts/compress_img.py 压缩
Step 3:一键发布 执行发布脚本: python scripts/publish.py <文章.md路径> <封面图路径> [摘要] 脚本会自动完成: 读取凭证 获取 Access Token 上传封面图到永久素材 转换 Markdown 为微信 HTML 提交草稿到公众号 成功示例: Title: 文章标题 Cover uploaded: media_id=xxx Draft created: media_id=xxx 发布成功!去草稿箱预览吧
封面图规范 参数 要求 分辨率 1280×720(横版 16:9) 格式 PNG/JPEG 大小 < 2MB(永久素材限制) 内容 简洁大气,留文字空间 常见错误: 生成竖版图(9:16)→ 必须重新生成横版 文件太大 → 用 compress_img.py 压缩 模糊不清 → 提高生成分辨率
压缩图片 python scripts/compress_img.py <原图路径> <输出路径> [quality] 默认 quality=85,逐步降低直到文件 < 500KB。
API 调用说明 详细 API 文档请参考 references/api_ref.md。 核心端点 功能 方法 URL 获取 Token GET /cgi-bin/token 上传永久素材 POST /cgi-bin/material/add_material 新增草稿 POST /cgi-bin/draft/add Token 管理 有效期:7200 秒(2小时) 建议每次发布前重新获取 返回 40001 时重新获取
常见问题 错误码速查 errcode 含义 解决方案 40164 IP不在白名单 mp后台添加 112.8.202.216 40006 图片太大 压缩到 < 2MB 40007 无效 media_id 用 add_material 永久素材接口 40013 AppID 不合法 检查 wechat_credentials.json 40001 Token 过期 重新获取
没有 AppID 怎么办? 个人订阅号不支持获取 AppID,仅: 已认证的服务号 已认证的订阅号 企业微信 支持 API 发布。
脚本说明 脚本 功能 publish.py 一键发布(自动执行全流程) create_draft.py Markdown → 草稿 JSON compress_img.py 压缩图片到指定大小 upload_cover.py 仅上传封面图
与其他技能配合 技能 配合方式 wechat-official-account 获取选题建议、内容优化指导 humanizer 去除 AI 写作痕迹 多模态内容生成 生成封面图和配图 baidu-search 搜索热门选题
版本记录 v1.0.0 (2026-05-12):初始版本,一键发布到草稿箱