微信公众号发布工具 v1.0

快速开始

1. 安装依赖

cd ~/.openclaw/workspace/skills/wechat-mp-publish
pip install -r requirements.txt

2. 配置公众号凭证

cp config.example.yaml config.yaml
# 编辑 config.yaml 填入 AppID 和 AppSecret

3. 运行测试

python publish.py --test

功能特性

✅ v1.0 已实现

• [x] 微信公众号 API 完整封装
• [x] access_token 自动缓存管理
• [x] 智能封面图生成（AI 绘图）
• [x] 3 种 HTML 样式模板
• [x] 草稿箱保存
• [x] 直接群发
• [x] 图片上传（获取正确 URL）
• [x] 配置管理（支持环境变量）

📋 使用命令

# 测试模式（自动发布 3 篇测试文章到草稿箱）
python publish.py --test

# 发布到草稿箱
python publish.py --draft "文章标题" "文章内容"

# 直接发布
python publish.py --publish "文章标题" "文章内容"

# 指定模板
python publish.py --draft "标题" "内容" --template business

🎨 模板样式

配置说明

config.yaml

wechat:
  appid: "你的 AppID"
  appsecret: "你的 AppSecret"
  name: "公众号名称"

image:
  provider: "dall-e-3"  # 或关闭 AI 绘图
  api_key: "${DALL_E_API_KEY}"  # 支持环境变量

环境变量

export DALL_E_API_KEY="sk-..."  # DALL-E 3 API 密钥

API 说明

核心类

WeChatAPI - 微信 API 封装

• get_access_token() - 获取访问令牌
• upload_image() - 上传图片
• create_draft() - 创建草稿
• publish_all() - 群发消息

ImageGenerator - 图片生成

• generate_cover() - 生成封面图
• extract_keywords() - 提取关键词
• build_prompt() - 构建绘图提示词

测试任务

验收标准

• [x] API 连接成功
• [ ] 生成 3 篇测试文章到草稿箱
• [ ] 每篇文章配图正确
• [ ] 3 个模板样式正常显示

测试内容

主题："我的诞生记"

• 以 AI 助手视角描述从诞生到成长的历程
• 每篇文章使用不同模板
• 每篇配图 1 张（AI 生成）

故障排除

问题 1: invalid appid

原因: AppID 配置错误

解决: 检查 config.yaml 中的 appid 是否正确

问题 2: invalid appsecret

原因: AppSecret 配置错误

解决: 检查 appsecret，注意不要有多余空格

问题 3: 图片上传失败

原因: 图片格式或大小不符合要求

解决: 确保图片为 JPG/PNG，大小<2MB

问题 4: AI 绘图失败

原因: DALL-E API 密钥未配置

解决: 设置 DALL_E_API_KEY 环境变量或使用占位图

版本历史

v1.0.0 (2026-03-09)

• 初始版本发布
• 实现核心发布功能
• 集成 AI 智能配图
• 3 种 HTML 模板

相关文档

• 产品需求文档
• 配置示例