wechat-publisher

一键发布 Markdown 文章到微信公众号草稿箱

基于wenyan-cli封装的 OpenClaw skill。

功能

• ✅ Markdown 自动转换为微信公众号格式
• ✅ 自动上传图片到微信图床
• ✅ 一键推送到草稿箱
• ✅ 多主题支持（代码高亮、Mac 风格代码块）
• ✅ 支持本地和网络图片

快速开始

1. 安装 wenyan-cli

wenyan-cli 需要全局安装：

npm install -g @wenyan-md/cli

验证安装：

wenyan --help

注意：publish.sh 脚本会自动检测并安装 wenyan-cli（如果未安装）

2. 配置 API 凭证

API 凭证已保存在/Users/leebot/.openclaw/workspace/TOOLS.md

确保环境变量已设置：

export 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 强制要求）：

---
title: 文章标题（必填！）
cover: https://example.com/cover.jpg  # 封面图（必填！）
---

# 正文开始

你的内容...

⚠️ 关键发现（实测）：

• title和cover 都是必填字段！
• 缺少任何一个都会报错："未能找到文章封面"
• 虽然文档说"正文有图可省略cover"，但实际测试必须提供 cover
• 所有图片（本地/网络）都会自动上传到微信图床

推荐封面图来源：

# 方案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 脚本

cd /Users/leebot/.openclaw/workspace/wechat-publisher
./scripts/publish.sh /path/to/article.md

方式 2: 直接使用 wenyan-cli

wenyan 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-light
• dracula
• github-dark/github
• monokai
• solarized-dark/solarized-light(推荐)
• xcode

使用示例：

# 使用 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

自定义主题

临时使用自定义主题

wenyan publish -f article.md -c /path/to/custom-theme.css

安装自定义主题（永久）

# 从本地文件安装
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

列出所有主题

wenyan theme -l

工作流程

1. 准备内容- 用 Markdown 写作
2. run the script- One-click publish to drafts
3. Review and publish- Review and publish in the official account backend

Markdown format requirements

Required Frontmatter

⚠️ Key (actual test results): wenyan-cli enforces complete frontmatter!

---
title: 文章标题（必填！）
cover: 封面图片URL或路径（必填！）
---

Example 1: Relative path (recommended)

---
title: 我的技术文章
cover: ./assets/cover.jpg
---

# 正文...

Example 2: Absolute path

---
title: 我的技术文章
cover: /Users/bruce/photos/cover.jpg
---

# 正文...

Example 3: Network image

---
title: 我的技术文章
cover: https://example.com/cover.jpg
---

# 正文...

❌ Error example (will cause an error):

# 只有 title，没有 cover
---
title: 我的文章
---

错误信息：未能找到文章封面

# 完全没有 frontmatter
# 我的文章

错误信息：未能找到文章封面

💡 Important discovery:

• Although the official wenyan documentation says "if the body has images, cover can be omitted"
• butactual testing shows that cover must be provided, otherwise an error occurs
• title and coverare indispensable

Image support

• ✅ Local path:![](./images/photo.jpg)
• ✅ Absolute path:![](/Users/bruce/photo.jpg)
• ✅ Network image:![](https://example.com/photo.jpg)

All images will be automatically uploaded to the WeChat image hosting service!

代码块

```python
def hello():
    print("Hello, WeChat!")
```

会自动添加代码高亮和 Mac 风格装饰。

故障排查

1. 上传失败：IP 不在白名单

错误信息： ip not in whitelist

解决方法：

1. 获取你的公网 IP：curl ifconfig.me
2. 登录微信公众号后台：https://mp.weixin.qq.com/
3. 开发 → 基本配置 → IP 白名单 → 添加你的 IP

2. wenyan-cli 未安装

错误信息： wenyan: command not found

解决方法：

npm install -g @wenyan-md/cli

3. 环境变量未设置

错误信息： WECHAT_APP_ID is required

解决方法：

export WECHAT_APP_ID=your_wechat_app_id
export WECHAT_APP_SECRET=your_wechat_app_secret

或在~/.zshrc/~/.bashrc中永久添加。

4. Frontmatter 缺失

错误信息： frontmatter 中需要 title

解决方法：在 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 封装
• ✅ 支持一键发布到草稿箱
• ✅ 多主题支持
• ✅ 自动图片上传

许可证

Apache License 2.0 (继承自 wenyan-cli)