跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
浏览器与自动化

aws-wechat-article-publish

公众号发布|公众号草稿箱|公众号群发|图文推送|微信 API|wechat automation|WeChat API automation|auto publish|scheduled publish — 公众号 API 发布工具,图文入草稿箱或直接群发,支持封面素材上传、发布前检查与 draft/published 模式切换。面向公众号运营、自动化内容团队、开发者。触发词:「发布」「提交」「群发」「推送」「发出去」「上传到公众号」「发到公众号」「可以发了吗」「发布前检查」。需要多环节串联(写+审+排+配图+发)请走 aws-wechat-article-main。

aiworkskills · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add aiworkskills/wechat-article-skills --skill aws-wechat-article-publish

技能说明


name: aws-wechat-article-publish description: 公众号发布|公众号草稿箱|公众号群发|图文推送|微信 API|wechat automation|WeChat API automation|auto publish|scheduled publish — 公众号 API 发布工具,图文入草稿箱或直接群发,支持封面素材上传、发布前检查与 draft/published 模式切换。面向公众号运营、自动化内容团队、开发者。触发词:「发布」「提交」「群发」「推送」「发出去」「上传到公众号」「发到公众号」「可以发了吗」「发布前检查」。需要多环节串联(写+审+排+配图+发)请走 aws-wechat-article-main。 homepage: https://aiworkskills.cn url: https://github.com/aiworkskills/wechat-article-skills metadata: openclaw: requires: env: - WECHAT_1_APPID - WECHAT_1_APPSECRET bins: - python3 primaryEnv: aws.env

发布

公众号 API 直连发布 —— 图文入草稿箱或直接群发,素材上传、发布前检查一站式完成。

套件说明 · 本 skill 属 aws-wechat-article-* 一条龙套件(共 9 个 slug,入口 aws-wechat-article-main)。跨 skill 的相对引用依赖同一 skills/ 目录,建议一并 clawhub install 全套。源码:https://github.com/aiworkskills/wechat-article-skills

能力披露(Capabilities)

本 skill 调 publish.py 直连微信公众号官方 API 发布图文。会把本篇 article.html 与 imgs/* 文件作为 POST body 上传到微信服务器。 具体行为:

  • 凭证读取:aws.env 的 WECHAT_{N}_APPID / WECHAT_{N}_APPSECRET(多槽位支持 N≥1)
  • 凭证外发:APPID / APPSECRET 以 query string 形式发给 api.weixin.qq.com/cgi-bin/token 换 access_token;后续请求带 access_token query string。微信返回的 access_token 在进程内存短期缓存,不落盘
  • 内容外发:本篇封面、正文插图以 multipart upload 发给 material/add_material;article.html 正文与标题/摘要以 JSON POST 发给 draft/add、freepublish/submit
  • 网络目标:默认 api.weixin.qq.com;用户可在 WECHAT_{N}_API_BASE / config.yaml.wechat_api_base 自配反代
  • 文件读:仓库内 .aws-article/config.yaml、aws.env、本篇 article.yaml、article.html、imgs/*
  • 文件写:仅本篇 article.yaml 的状态字段(media_id、publish_id、publish_completed)
  • shell:仅 {python} {baseDir}/scripts/publish.py、getdraft.py、article_init.py({python} = 本机 Python 3 解释器,见 main SKILL 第 0 步:Windows 用 py -3 -X utf8,macOS / Linux 用 python3)

建议:首次运行用 publish_method: draft 只入草稿箱确认效果,再切 published 真正群发。

配套 skill(informational)

本 skill 是 aws-wechat-article-* 一条龙公众号套件的发布环节(入口 aws-wechat-article-main)。工作流中的若干步骤会读取同级 ../aws-wechat-article-main/references/*.md 等共享文档(首次引导、articlescreening schema、env/config 示例等)。

  • 套件完整装齐到同一 skills/ 根目录时,跨 skill 引用都能读到。
  • 单独安装本 skill 时,跨 skill 引用的步骤会在读取阶段遇到 file not found;但 publish.py、getdraft.py、article_init.py 这几个脚本本身可独立运行(只要 aws.env 与 .aws-article/config.yaml 就绪)。

完整 9 slug 清单见 源码仓库。

通过微信公众号 API 将排版稿写入草稿箱或再提交发布(由 config.yaml 的 publish_method 与命令行 --publish 控制)。

配置检查 ⛔

任何操作执行前,必须按 首次引导 执行其中的 「检测顺序」。检测通过后才能进行以下操作(或用户明确书面确认「本次不检查」):

脚本目录

Agent 执行:确定本 SKILL.md 所在目录为 {baseDir}。发布子命令在 {baseDir}/scripts/publish.py(项目根执行)。

脚本 / 子命令用途
article_init.py初始化或更新本篇 article.yaml(及可选 closing.md)。用于总览 本篇准备(建目录后)或 发布前 补全元数据。仓库根执行:{python} {baseDir}/scripts/article_init.py <文章目录> [--title … --author … --digest …]
getdraft.py独立于 publish.py:用于正式文章查询(published-list / published-fields / publish-get / article-get,对应 freepublish/*),可用于 embeds.related_articles.manual 为空时自动补全推荐链接。注意:freepublish/* 需要公众号具备对应接口权限。仓库根:{python} {baseDir}/scripts/getdraft.py published-fields
check-screening校验 config.yaml 的 publish_method(draft / published / none)
check-wechat-env按 config.yaml 槽位检查 aws.env 的 WECHAT_N_APPID / WECHAT_N_APPSECRET 是否已填(调用 publish.py 前建议跑)
check环境检查:aws.env、各槽位、依赖、可选探测 token
accounts列出 config.yaml 中各微信槽位名称,并标记 aws.env 凭证缺项
full / token / …调微信 API(需 aws.env 微信凭证)

凭证与 publish_method ⛔

publish_method(以仓库 config.yaml 为准)

值含义行为
draft(默认)只进公众号草稿箱full 创建草稿后不调用 freepublish 提交发布。
published草稿 + 提交发布full 创建草稿后继续提交发布(异步)。full --publish 可单次强制带发布,即使当前为 draft。
none用户明确不填微信full 立即退出,不调任何微信接口(--publish 也会被忽略)。其它子命令(token 等)仍要凭证。

多账号时如何选槽位

  1. 运行 {python} {baseDir}/scripts/publish.py accounts,从 config.yaml 的 wechat_accounts + wechat_N_name 向用户展示列表(例如:您有2个账号:1."xiaoming",2."xiaoz")必须询问用户选择哪个账号发布到草稿箱,然后根据用户选择发布到指定的账号。
  2. 在 config.yaml 写 wechat_publish_slot: <整数>,或命令行 --account <序号或名称>(CLI 优先,见 articlescreening-schema.md)。

全局环境

在仓库根具备 aws.env(微信密钥)与 config.yaml(微信槽位数量与名称)。写作/生图见 validate_env.py(微信未齐仍可先做内容)。publish_method: none 时 full 会跳过;draft/published 发布前建议 check-wechat-env。API 端点优先取 WECHAT_N_API_BASE,若槽位未配则回退 config.yaml.wechat_api_base(两者都空时使用官方)。

作者名回退

full / create-draft 若 article.yaml 无 author,回退 config.yaml 的 default_author。

publish_completed(本篇是否已发布完成)

  • 字段在本篇 article.yaml。publish.py 不读、不改;由智能体维护。
  • false:发布流程未闭环。
  • true:已视为发布完成(草稿已确认 / 或 published 流程成功且运营确认)。

本篇发布真正结束后:将 publish_completed: true 写回 article.yaml。

写回 true 的前置门禁(缺啥补啥):

  1. article.html 存在;

  2. 文章目录存在封面图 cover.(png/jpg/jpeg/webp);

    封面裁剪框:微信只收一张封面,但 draft/add 可附带两个裁剪框,分别决定 2.35:1(订阅号信息流首图)与 1:1(分享卡片、公众号主页、历史列表)怎么裁;不传时微信自行居中裁切。publish.py 会按封面实际尺寸自动算出两个框并随草稿提交(需 Pillow;未安装则跳过,交给微信默认行为)。

    设计取向是 2.35:1 优先——信息流那一眼决定点不点,1:1 作降级视图。所以封面按 2.35:1 构图即可,不必为迁就方形而牺牲主视图。

    需要手动指定时,在本篇 article.yaml 写 pic_crop_235_1 / pic_crop_1_1(X1_Y1_X2_Y2 归一化 0~1),脚本不再覆盖。注意裁出区域的宽高比须与目标比例一致,否则接口返回 53402「封面裁剪失败」。

  3. article.md 与 article.html 中均不含 placeholder;

  4. 发布命令成功并拿到回执(media_id 或 publish_id)。

任一不满足:只可标记为“已提交草稿,未闭环”,不得写回 publish_completed: true。

用户仅说「发布」且未明确路径时 ⛔

在用户未给出 drafts/… 路径、仅说「发布文章」「帮我发一下」等时:

  1. 确定本篇目录:列出仓库下 **`dra
阅读完整来源 ↗