1-Click WOA — 微信公众号草稿箱一键发布

快速开始

1. 配置凭证（首次使用或更换账号时）
2. 提供文章 → 直接粘贴 Markdown 或文本内容
3. 确认发布 → Skill 自动执行全流程

工作流程

用户提供文章内容
    ↓
检查配置文件（credentials.json）
    ↓ 缺失 → 中断，提示用户配置
获取 access_token
    ↓ 失败 → 报错退出
上传封面图 + 内容图片（最多5张）
    ↓ 失败 → 报错退出
构建草稿 JSON（UTF-8 + charset=utf-8）
    ↓
提交草稿箱
    ↓ 成功 → 报告 media_id 和预览链接
    ↓ 失败（中文乱码）→ 自动切换 HTML fallback
        → 生成可下载 HTML 文件
        → 提示用户手动复制发布

配置文件

路径： ~/.openclaw/agents/gzh-assistant/wechat/credentials.json

模板：

{
  "app_id": "你的AppID",
  "app_secret": "你的AppSecret",
  "image_dir": "~/wechat_images"
}

获取方式：

• AppID/AppSecret：微信公众平台 → 设置与开发 → 基本配置
• image_dir：封面图和内容图片存放目录（绝对路径）

图片要求

图片必须预先放入 image_dir 目录，命名规则：

• cover.png / cover.jpg — 封面图
• layer1.png / layer1.jpg — 内容图1
• layer2.png / layer2.jpg — 内容图2
• layer3.png / layer3.jpg — 内容图3
• layer4.png / layer4.jpg — 内容图4

文章格式要求

• 标题：不超过34字节（约17个中文）
• 摘要：不超过61字节（约30个中文）
• 正文：支持 HTML 格式（<p>/<img>/<strong> 等）
• 图片在正文中使用 <img src="（media_id）" /> 引用

已知限制

1. 中文编码 bug：微信草稿 API 对中文 content 有 \uXXXX 转义问题

   • 修复方案：UTF-8 编码 + charset=utf-8 header
   • Fallback：发布失败时自动生成 HTML 文件供手动发布

2. access_token 有效期：2小时，过期需重新获取

3. 永久素材数量：每个账号最多10000个

参考文档

• SETUP.md — 完整安装配置指南
• TROUBLESHOOTING.md — 常见问题排查