wechat-publisher
一键发布 Markdown 文章到微信公众号草稿箱
基于 wenyan-cli 封装的 OpenClaw skill。
功能
- ✅ Markdown 自动转换为微信公众号格式
- ✅ 自动上传图片到微信图床
- ✅ 一键推送到草稿箱
- ✅ 多主题支持（代码高亮、Mac 风格代码块）
- ✅ 支持本地和网络图片
快速开始
1. 安装 wenyan-cli
wenyan-cli 需要全局安装：
bashnpm install -g @wenyan-md/cli
验证安装：
bashwenyan --help
注意： publish.sh 脚本会自动检测并安装 wenyan-cli（如果未安装）
2. 配置 API 凭证
API 凭证已保存在 /Users/leebot/.openclaw/workspace/TOOLS.md
确保环境变量已设置：
bashexport WECHAT_APP_ID=your_wechat_app_id export WECHAT_APP_SECRET=your_wechat_app_secret
重要： 确保你的 IP 已添加到微信公众号后台的白名单！
配置方法：https://yuzhi.tech/docs/wenyan/upload
3. 准备 Markdown 文件
文件顶部必须包含完整的 frontmatter（wenyan 强制要求）：
markdown--- title: 文章标题（必填！） cover: https://example.com/cover.jpg # 封面图（必填！） --- # 正文开始 你的内容...
⚠️ 关键发现（实测）：
title和cover都是必填字段！- 缺少任何一个都会报错："未能找到文章封面"
- 虽然文档说"正文有图可省略cover"，但实际测试必须提供 cover
- 所有图片（本地/网络）都会自动上传到微信图床
推荐封面图来源：
markdown# 方案1: 相对路径（推荐，便于分享） cover: ./assets/default-cover.jpg # 方案2: 绝对路径 cover: /Users/bruce/photos/cover.jpg # 方案3: 网络图片 cover: https://your-cdn.com/image.jpg
💡 提示： 使用相对路径时，从 Markdown 文件所在目录开始计算。
4. 发布文章
方式 1: 使用 publish.sh 脚本
bashcd /Users/leebot/.openclaw/workspace/wechat-publisher ./scripts/publish.sh /path/to/article.md
方式 2: 直接使用 wenyan-cli
bashwenyan publish -f article.md -t lapis -h solarized-light
方式 3: 在 OpenClaw 中使用
"帮我发布这篇文章到微信公众号" + 附带 Markdown 文件路径
主题选项
wenyan-cli 支持多种主题：
内置主题：
default- 默认主题lapis- 青金石（推荐）phycat- 物理猫- 更多主题见：https://github.com/caol64/wenyan-core/tree/main/src/assets/themes
代码高亮主题：
atom-one-dark/atom-one-lightdraculagithub-dark/githubmonokaisolarized-dark/solarized-light(推荐)xcode
使用示例：
bash# 使用 lapis 主题 + solarized-light 代码高亮 wenyan publish -f article.md -t lapis -h solarized-light # 使用 phycat 主题 + GitHub 代码高亮 wenyan publish -f article.md -t phycat -h github # 关闭 Mac 风格代码块 wenyan publish -f article.md -t lapis --no-mac-style # 关闭链接转脚注 wenyan publish -f article.md -t lapis --no-footnote
自定义主题
临时使用自定义主题
bashwenyan publish -f article.md -c /path/to/custom-theme.css
安装自定义主题（永久）
bash# 从本地文件安装 wenyan theme --add --name my-theme --path /path/to/theme.css # 从网络安装 wenyan theme --add --name my-theme --path https://example.com/theme.css # 使用已安装的主题 wenyan publish -f article.md -t my-theme # 删除主题 wenyan theme --rm my-theme
列出所有主题
bashwenyan theme -l
工作流程
- 准备内容 - 用 Markdown 写作
- 运行脚本 - 一键发布到草稿箱
- 审核发布 - 到公众号后台审核并发布
Markdown 格式要求
必需的 Frontmatter
⚠️ 关键（实测结果）：wenyan-cli 强制要求完整的 frontmatter！
markdown--- title: 文章标题（必填！） cover: 封面图片URL或路径（必填！） ---
示例 1：相对路径（推荐）
markdown--- title: 我的技术文章 cover: ./assets/cover.jpg --- # 正文...
示例 2：绝对路径
markdown--- title: 我的技术文章 cover: /Users/bruce/photos/cover.jpg --- # 正文...
示例 3：网络图片
markdown--- title: 我的技术文章 cover: https://example.com/cover.jpg --- # 正文...
❌ 错误示例（会报错）：
markdown# 只有 title，没有 cover --- title: 我的文章 --- 错误信息：未能找到文章封面
markdown# 完全没有 frontmatter # 我的文章 错误信息：未能找到文章封面
💡 重要发现：
- 虽然 wenyan 官方文档说"正文有图片可省略cover"
- 但实际测试必须提供 cover，否则报错
- title 和 cover 缺一不可
图片支持
- ✅ 本地路径：
 - ✅ 绝对路径：
 - ✅ 网络图片：
所有图片会自动上传到微信图床！
代码块
markdown```python def hello(): print("Hello, WeChat!") ```
会自动添加代码高亮和 Mac 风格装饰。
故障排查
1. 上传失败：IP 不在白名单
错误信息： ip not in whitelist
解决方法：
- 获取你的公网 IP：
curl ifconfig.me - 登录微信公众号后台：https://mp.weixin.qq.com/
- 开发 → 基本配置 → IP 白名单 → 添加你的 IP
2. wenyan-cli 未安装
错误信息： wenyan: command not found
解决方法：
bashnpm install -g @wenyan-md/cli
3. 环境变量未设置
错误信息： WECHAT_APP_ID is required
解决方法：
bashexport WECHAT_APP_ID=your_wechat_app_id export WECHAT_APP_SECRET=your_wechat_app_secret
或在 ~/.zshrc / ~/.bashrc 中永久添加。
4. Frontmatter 缺失
错误信息： title is required in frontmatter
解决方法： 在 Markdown 文件顶部添加：
markdown--- title: 你的文章标题 ---
参考资料
- wenyan-cli GitHub: https://github.com/caol64/wenyan-cli
- wenyan 官网: https://wenyan.yuzhi.tech
- 微信公众号 API 文档: https://developers.weixin.qq.com/doc/offiaccount/
- IP 白名单配置: https://yuzhi.tech/docs/wenyan/upload
更新日志
2026-02-05 - v1.0.0
- ✅ 初始版本
- ✅ 基于 wenyan-cli 封装
- ✅ 支持一键发布到草稿箱
- ✅ 多主题支持
- ✅ 自动图片上传
License
Apache License 2.0 (继承自 wenyan-cli)
