wechat-publisher：一键发布Markdown文章到微信公众号草稿箱工具

wechat-publisher by 0731coderlee-sudo/wechat-publisher

296 周安装量

21 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/0731coderlee-sudo/wechat-publisher --skill wechat-publisher

🇨🇳中文介绍

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 已添加到微信公众号后台的白名单！

🇺🇸English

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

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

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 文件所在目录开始计算。

方式 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

准备内容 - 用 Markdown 写作
运行脚本 - 一键发布到草稿箱
审核发布 - 到公众号后台审核并发布

Markdown 格式要求

必需的 Frontmatter

⚠️ 关键（实测结果）：wenyan-cli 强制要求完整的 frontmatter！

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

示例 1：相对路径（推荐）

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

# 正文...

示例 2：绝对路径

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

# 正文...

示例 3：网络图片

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

# 正文...

❌ 错误示例（会报错）：

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

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



# 完全没有 frontmatter
# 我的文章

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

💡 重要发现：

虽然 wenyan 官方文档说"正文有图片可省略cover"
但实际测试必须提供 cover ，否则报错
title 和 cover 缺一不可

✅ 本地路径：![](./images/photo.jpg)
✅ 绝对路径：![](/Users/bruce/photo.jpg)
✅ 网络图片：![](https://example.com/photo.jpg)

所有图片会自动上传到微信图床！

```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

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 缺失

错误信息： title is required in frontmatter

解决方法： 在 Markdown 文件顶部添加：

---
title: 你的文章标题
---

✅ 初始版本
✅ 基于 wenyan-cli 封装
✅ 支持一键发布到草稿箱
✅ 多主题支持
✅ 自动图片上传

Apache License 2.0 (继承自 wenyan-cli)

重要： 确保你的 IP 已添加到微信公众号后台的白名单！

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 文件所在目录开始计算。

方式 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

准备内容 - 用 Markdown 写作
运行脚本 - 一键发布到草稿箱
审核发布 - 到公众号后台审核并发布

Markdown 格式要求

必需的 Frontmatter

⚠️ 关键（实测结果）：wenyan-cli 强制要求完整的 frontmatter！

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

示例 1：相对路径（推荐）

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

# 正文...

示例 2：绝对路径

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

# 正文...

示例 3：网络图片

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

# 正文...

❌ 错误示例（会报错）：

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

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



# 完全没有 frontmatter
# 我的文章

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

💡 重要发现：

虽然 wenyan 官方文档说"正文有图片可省略cover"
但实际测试必须提供 cover ，否则报错
title 和 cover 缺一不可

✅ 本地路径：![](./images/photo.jpg)
✅ 绝对路径：![](/Users/bruce/photo.jpg)
✅ 网络图片：![](https://example.com/photo.jpg)

所有图片会自动上传到微信图床！

```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

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 缺失

错误信息： title is required in frontmatter

解决方法： 在 Markdown 文件顶部添加：

---
title: 你的文章标题
---

✅ 初始版本
✅ 基于 wenyan-cli 封装
✅ 支持一键发布到草稿箱
✅ 多主题支持
✅ 自动图片上传

Apache License 2.0 (继承自 wenyan-cli)

SEO与AEO最佳实践指南：优化内容适配传统搜索与AI答案引擎

wechat-publisher：一键发布Markdown文章到微信公众号草稿箱工具

🇨🇳中文介绍

wechat-publisher

功能

快速开始

1. 安装 wenyan-cli

2. 配置 API 凭证

🇺🇸English

wechat-publisher

功能

快速开始

1. 安装 wenyan-cli

2. 配置 API 凭证

相关 Skills

最新 Skills

3. 准备 Markdown 文件

4. 发布文章

主题选项

自定义主题

临时使用自定义主题

安装自定义主题（永久）

列出所有主题

工作流程

Markdown 格式要求

必需的 Frontmatter

图片支持

代码块

故障排查

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

2. wenyan-cli 未安装

3. 环境变量未设置

4. Frontmatter 缺失

参考资料

更新日志

2026-02-05 - v1.0.0

License

3. 准备 Markdown 文件

4. 发布文章

主题选项

自定义主题

临时使用自定义主题

安装自定义主题（永久）

列出所有主题

工作流程

Markdown 格式要求

必需的 Frontmatter

图片支持

代码块

故障排查

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

2. wenyan-cli 未安装

3. 环境变量未设置

4. Frontmatter 缺失

参考资料

更新日志

2026-02-05 - v1.0.0

License