| name | wx-mp-publisher |
| description | Render and publish Markdown articles to WeChat Official Account (公众号) draft box. Supports local mode (IP whitelisted) and server relay mode via Wenyan Server. Supports multi-account, image-only posts (小绿书), and proxy. |
| metadata | {"openclaw":{"emoji":"📤","requires":{"bins":["node","npx"]}}} |
WeChat MP Publisher
将 Markdown 稿件排版并推送到微信公众号草稿箱。
发布命令
./skills/wx-mp-publisher/scripts/publish-wx-mp.sh <markdown_file> [theme]
主题选择（未指定时按内容匹配）：
自定义主题说明：generate-wenyan-theme 生成的用户自定义 CSS 会注册到下表。若用户明确指定参考某个自定义主题，必须优先采用该主题；未指定时才按内容在内置主题和已注册自定义主题中匹配。
| 主题 ID | 风格描述 | 适用场景 |
|---|
default | 简洁经典 | 资讯、通知、简讯 |
pie | 现代锐利（仿少数派） | 深度长文、评测、观点（默认） |
lapis | 极简冷蓝 | 技术教程、代码分析 |
purple | 简约紫调 | 品牌、商务、精品内容 |
orangeheart | 暖橙优雅 | 情感、故事、节日 |
maize | 淡雅玉米黄 | 健康生活、美食、户外 |
rainbow | 多彩活泼 | 亲子、宠物、娱乐 |
phycat | 薄荷清爽 | 科普、知识型内容 |
<custom-theme> | 用户自定义主题占位（由 generate-wenyan-theme 生成后更新，文件：<custom-theme>.css） | 用户明确指定参考该主题时优先采用；相似内容可优先建议 |
智能选择决策树（用户未指定主题时）：
含大量代码/技术术语 → lapis
年轻女性/亲子/萌宠 → rainbow
情感/故事/节日 → orangeheart
健康/美食/户外 → maize
品牌/商务/精品 → purple
科普/知识型 → phycat
深度长文/评测/观点 → pie
其他（资讯/通知） → default
Frontmatter 要求
文章 Markdown 开头必须包含 YAML 块，否则微信 API 会拒绝：
---
title: 文章标题
cover: ./cover.jpg
author: 作者名称
source_url: https://...
need_open_comment: true
only_fans_can_comment: false
---
发布小绿书（图片消息）
纯图片轮播形式，不含正文 HTML。在 frontmatter 中指定 image_list（最多 20 张，首张为封面）：
---
title: 文章标题
image_list:
- ./1.jpg
- ./2.jpg
- ./3.jpg
---
可选的说明文字
有 image_list 时自动走图片消息接口，忽略主题参数。
多公众号发布
如需向非默认公众号推送，设置环境变量 WECHAT_TARGET_APP_ID 后执行：
./skills/wx-mp-publisher/scripts/publish-wx-mp.sh article.md
前提：relay server 端已通过 wenyan credential --set 完成该公众号的凭据配置，且对应公众号已将 server IP 加入白名单。
代理配置
如网络环境需要代理访问微信 API，设置环境变量 WENYAN_PROXY 后执行：
./skills/wx-mp-publisher/scripts/publish-wx-mp.sh article.md
支持 HTTP / HTTPS / SOCKS5 / SOCKS4 代理格式。
Agent 行为约束
- 脚本首次运行会自动下载
@wenyan-md/cli，约 10–30 秒，等待完成再报告结果
- 禁止在脚本输出前自行判断是否发布成功
Error Handling
| 错误 | 处理方式 |
|---|
请配置环境变量 | 配置对应环境变量 |
invalid ip | 本机 IP 未白名单，改用 relay（配置 WENYAN_SERVER_URL） |
invalid appid | 检查 WECHAT_APP_ID 或 WECHAT_TARGET_APP_ID |
| 图片上传失败 | 确认 Markdown 中图片路径真实存在 |
缺少 title | 在 Markdown 开头添加 frontmatter title: 字段 |
Notes
- publish 成功后会输出草稿
media_id，可在公众号后台找到对应草稿
- 本 skill 只负责推送草稿，正式发布仍需在公众号后台手动操作
- 支持 Mermaid 图表语法，在 Markdown 中使用 mermaid 代码块即可自动渲染为图片
