OpenSkillIndex← back to search
claude-codeopenclawautomation

Skills bozo-wechat-publisher

一键发布 Markdown 文章到微信公众号草稿箱。当用户提到发布到微信、公众号、推文、草稿箱、上传文章时触发。支持 wenyan-cli 完整排版和 curl 备用方案，兼容所有 Node.js 版本。

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bozoyan/bozo-wechat-publisher" ~/.claude/skills/openclaw-skills-bozo-wechat-publisher && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/bozoyan/bozo-wechat-publisher" ~/.openclaw/skills/openclaw-skills-bozo-wechat-publisher && rm -rf "$T"
manifest: skills/bozoyan/bozo-wechat-publisher/SKILL.md
tags
#markdown#wechat#publishing#automation#cli
source content

bozo-wechat-publisher

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

基于 wenyan-cli 封装，提供 curl 备用方案兼容所有环境。

核心功能

  • 🚀 一键发布到草稿箱
  • 🎨 多主题支持（8 种内置 + 2 种自定义卡片主题）
  • 💻 代码高亮（9 种主题）
  • 🖼️ 图片自动上传到微信图床
  • 🔧 三种发布方案（wenyan-cli / 自定义主题 / curl 备用）
  • 📚 完整移植文档
  • 🎴 卡片式布局（支持深色/浅色主题，CSS 样式内联注入）

快速开始（3 分钟配置）

1. 安装 wenyan-cli

npm install -g @wenyan-md/cli

2. 修复 wenyan 命令

重要： wenyan-cli 2.x 存在 ESM 模块加载问题，需要创建包装脚本：

# 创建包装脚本
mkdir -p ~/.local/bin
cat > ~/.local/bin/wenyan << 'EOF'
#!/bin/bash
node /usr/local/lib/node_modules/@wenyan-md/cli/dist/cli.js "$@"
EOF
chmod +x ~/.local/bin/wenyan

# 确保 ~/.local/bin 在 PATH 中
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 验证
wenyan --version

3. 配置 API 凭证

export WECHAT_APP_ID=your_app_id
export WECHAT_APP_SECRET=your_app_secret

永久配置（添加到 

~/.zshrc
）：

echo 'export WECHAT_APP_ID=your_app_id' >> ~/.zshrc
echo 'export WECHAT_APP_SECRET=your_app_secret' >> ~/.zshrc
source ~/.zshrc

4. 添加 IP 到白名单

curl ifconfig.me

登录 https://mp.weixin.qq.com/ → 开发 → 基本配置 → IP 白名单 → 添加此 IP

准备 Markdown 文件

文件顶部必须包含 frontmatter：

---
title: 文章标题（必填）
cover: ./assets/cover.jpg  # 封面图（必填）
description: 公众号摘要。 # 可选
author: 作者名称
source_url: https://example.com  # 可选
---

# 正文开始

你的内容...

⚠️ 必填字段：

  • title
    - 文章标题
  • cover
    - 封面图路径或 URL

封面图推荐：

  • 尺寸：1080×864 像素（5:4）
  • 格式：JPG/PNG
  • 大小：< 2MB

发布文章

方案一：wenyan-cli（推荐）

适用环境： Node.js 18 及以下

# 使用默认主题
wenyan publish -f article.md

# 指定主题和代码高亮
wenyan publish -f article.md -t lapis -h solarized-light

# 关闭 Mac 风格代码块
wenyan publish -f article.md -t lapis --no-mac-style

# 列出所有主题
wenyan theme -l

内置主题：

  • default
    - 默认主题
  • lapis
    - 青金石（推荐）
  • phycat
    - 物理猫
  • orangeheart
    - 橙心
  • rainbow
    - 彩虹
  • pie
    - 派派风格
  • maize
    - 玉米色
  • purple
    - 紫色

方案二：自定义卡片主题（新增）

适用环境： 任何 Node.js 版本

使用自定义卡片主题发布，支持深色/浅色风格：

# 使用 card-tech-dark 深色科技主题（默认）
./scripts/publish-card-theme-v2.sh article.md

# 使用 card-neon-light 霓虹浅色主题
./scripts/publish-card-theme-v2.sh article.md card-neon-light

自定义主题：

  • card-tech-dark
    - 卡片科技暗色 🎴（适合技术文章、AI 内容）

    • 深色背景 (#0a0e27)
    • 紫色渐变强调色 (#6366f1 → #8b5cf6)
    • 卡片式布局 + 悬停动效

  • card-neon-light
    - 卡片霓虹浅色 🎴（适合教程、指南、操作手册）

    • 浅色背景 (#f8fafc)
    • 霓虹效果 (#06b6d4 → #8b5cf6)
    • 流畅动画 + 移动端优化

方案三：curl 备用方案

适用环境： 任何 Node.js 版本

当 wenyan-cli 不可用时，使用备用脚本：

# 从 skill 目录运行
./scripts/publish-curl.sh article.md

# 或指定环境变量
WECHAT_APP_ID=wx123 WECHAT_APP_SECRET=secret ./scripts/publish-curl.sh article.md

代码高亮：

  • solarized-light
    / 
    solarized-dark
  • github
    / 
    github-dark
  • atom-one-light
    / 
    atom-one-dark
  • monokai
  • dracula
  • xcode

重要说明

自定义卡片主题工作原理

样式注入方式：

  • 主题 CSS 样式作为 
    <style>
    标签放在内容开头（body 内）
  • 不使用 
    <head>
    标签，直接发送 body 内容到微信 API
  • 确保 CSS 变量（如 
    --bg-primary: #0a0e27
    ）在内容中生效

wenyan-cli 输出格式：

  • wenyan render
    输出不包含 
    <html>
    或 
    <body>
    标签
  • 直接以 
    <section id="wenyan">
    开头
  • 这是正常的，直接使用完整输出即可

封面图要求：

  • 草稿箱 API 必须提供 
    thumb_media_id
    （即使 
    show_cover_pic: 0
    ）
  • 脚本会自动上传封面图并获取 media_id
  • 如果没有封面图，会使用默认的 assets/logo.png

内容审核限制

错误 45166 - invalid content hint：

某些内容可能触发微信的内容审核，导致发布失败：

可能原因解决方案
敏感关键词简化内容，避免争议性话题
过长的文章分段发布或精简内容
特殊格式使用标准 Markdown 格式
代码块过多减少代码示例数量

建议： 先使用简单内容测试，确认发布流程正常后再添加完整内容。

适用环境： 任何 Node.js 版本

当 wenyan-cli 不可用时，使用备用脚本：

# 从 skill 目录运行
./scripts/publish-curl.sh article.md

# 或指定环境变量
WECHAT_APP_ID=wx123 WECHAT_APP_SECRET=secret ./scripts/publish-curl.sh article.md

完整安装步骤

macOS

# 1. 安装 wenyan-cli
npm install -g @wenyan-md/cli

# 2. 修复 wenyan 命令
mkdir -p ~/.local/bin
cat > ~/.local/bin/wenyan << 'EOF'
#!/bin/bash
node /usr/local/lib/node_modules/@wenyan-md/cli/dist/cli.js "$@"
EOF
chmod +x ~/.local/bin/wenyan
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

# 3. 配置环境变量
echo 'export WECHAT_APP_ID=your_app_id' >> ~/.zshrc
echo 'export WECHAT_APP_SECRET=your_app_secret' >> ~/.zshrc

# 4. 应用配置
source ~/.zshrc

Linux (Ubuntu/Debian)

# 1. 安装 Node.js 18
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 2. 安装 wenyan-cli
npm install -g @wenyan-md/cli

# 3. 修复 wenyan 命令
mkdir -p ~/.local/bin
cat > ~/.local/bin/wenyan << 'EOF'
#!/bin/bash
node /usr/local/lib/node_modules/@wenyan-md/cli/dist/cli.js "$@"
EOF
chmod +x ~/.local/bin/wenyan
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

# 4. 配置环境变量
echo 'export WECHAT_APP_ID=your_app_id' >> ~/.bashrc
echo 'export WECHAT_APP_SECRET=your_app_secret' >> ~/.bashrc

# 5. 应用配置
source ~/.bashrc

Windows

# 1. 安装 Node.js 18
# 下载: https://nodejs.org/dist/v18.20.2/node-v18.20.2-x64.msi

# 2. 安装 wenyan-cli
npm install -g @wenyan-md/cli

# 3. 创建包装脚本 wenyan.bat
# 保存到 npm 全局目录（运行 npm config get prefix 查看）
@echo off
node "%APPDATA%\npm\node_modules\@wenyan-md\cli\dist\cli.js" %*

# 4. 配置环境变量
# 系统属性 → 环境变量 → 新建用户变量
# WECHAT_APP_ID = your_app_id
# WECHAT_APP_SECRET = your_app_secret

故障排查

wenyan 命令无响应

问题： 执行 

wenyan --version
或 
wenyan --help
时没有任何输出

原因： wenyan-cli 2.x 存在 ESM 模块加载问题

解决方案： 创建包装脚本（见上文"修复 wenyan 命令"）

wenyan-cli 报 "fetch failed"

原因： Node.js 20/24 与 wenyan-cli 的 fetch 实现不兼容

解决方案：

# 方案 A: 使用 Node.js 18
nvm install 18 && nvm use 18

# 方案 B: 使用 curl 备用方案
./scripts/publish-curl.sh article.md

自定义主题发布后内容为空白

问题： 发布成功但草稿箱中内容为空白

原因： 主题 CSS 背景色与文字颜色冲突

解决方案：

  • card-tech-dark 使用深色背景 (#0a0e27) 和浅色文字 (#f1f5f9)
  • 确保微信编辑器没有覆盖样式
  • 检查 CSS 变量是否正确注入

错误 40007 - invalid media_id

问题： 发布时报 "invalid media_id" 错误

原因： 未提供 

thumb_media_id
字段

解决方案：

  • 确保封面图路径正确
  • 检查封面图文件是否存在
  • 脚本会自动上传封面图

错误 45166 - invalid content hint

问题： 内容触发微信审核

原因： 文章内容包含敏感词或格式问题

解决方案：

  • 简化文章内容
  • 避免争议性话题
  • 使用标准 Markdown 格式
  • 减少代码块数量

IP 不在白名单

错误信息： 

ip not in whitelist

解决方法：

# 1. 获取当前 IP
curl ifconfig.me

# 2. 登录公众号后台添加 IP
# https://mp.weixin.qq.com/ → 开发 → 基本配置 → IP 白名单

Frontmatter 缺失

错误信息： 

title is required in frontmatter

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

---
title: 你的文章标题
cover: 封面图路径
---

封面图错误

错误信息： 

未能找到文章封面

解决方法：

  • 确保 frontmatter 中有 
    cover
    字段
  • 检查图片路径是否正确（支持相对路径和绝对路径）
  • 确保图片尺寸符合要求（建议 1080×864）
  • 支持的格式：JPG/PNG

订阅号 API 限制

说明： 订阅号草稿箱 API 与服务号不同

限制：

  • 不支持某些高级 API（如 freepublish）
  • 草稿箱 API 可用但需注意权限配置
  • 某些接口需要服务号权限

解决方案：

  • 使用草稿箱 API (draft/add)
  • 发布需要手动在后台操作
  • 考虑升级为服务号以获得完整功能

移植到新电脑

在新的电脑上使用此 skill：

1. 复制 skill 目录

cp -r /Volumes/AI/AIGC/aigc/Skills/bozo-wechat-publisher ~/.claude/skills/

2. 安装依赖

# 安装 wenyan-cli
npm install -g @wenyan-md/cli

# 修复 wenyan 命令
mkdir -p ~/.local/bin
cat > ~/.local/bin/wenyan << 'EOF'
#!/bin/bash
node /usr/local/lib/node_modules/@wenyan-md/cli/dist/cli.js "$@"
EOF
chmod +x ~/.local/bin/wenyan
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

3. 配置环境变量

export WECHAT_APP_ID=your_app_id
export WECHAT_APP_SECRET=your_app_secret

4. 添加 IP 到白名单

curl ifconfig.me
# 登录公众号后台添加此 IP

发布示例

示例 Markdown 文件

---
title: 使用 Claude Code 提升开发效率
cover: ./assets/cover.jpg
author: 张三
source_url: https://myblog.com/original-post
---

# 使用 Claude Code 提升开发效率

Claude Code 是一款强大的 AI 编程助手...

## 代码示例

```javascript
function hello() {
    console.log("Hello, WeChat!");
}

图片示例

示例图片


### 发布命令

```bash
# 方案一：wenyan-cli
wenyan publish -f article.md -t lapis -h solarized-light

# 方案二：curl 备用
./scripts/publish-curl.sh article.md

工作流程

准备 Markdown (含 frontmatter)
         │
         ▼
    选择发布方案
         │
    ┌────┴────┐
    │         │
    ▼         ▼
wenyan-cli  curl 脚本
(完整功能)  (备用方案)
    │         │
    └────┬────┘
         ▼
   发布到草稿箱
         │
         ▼
   公众号后台审核发布

版本历史

v1.3.0 (2026-04-04)

  • ✅ 修复自定义卡片主题发布脚本（publish-card-theme-v2.sh）
  • ✅ 修复 wenyan render 输出格式问题（不包含 body 标签）
  • ✅ 添加自动封面图上传功能
  • ✅ 使用稳定版 access_token API
  • ✅ 添加内容审核问题说明
  • ✅ 完善故障排查指南

v1.2.0 (2026-04-04)

  • ✅ 修复 wenyan 命令无响应问题
  • ✅ 添加自动包装脚本设置
  • ✅ 完善安装步骤说明
  • ✅ 更新移植指南

v1.1.0 (2026-04-04)

  • ✅ 添加 curl 备用方案
  • ✅ 完善 Node.js 版本兼容性说明
  • ✅ 添加详细移植指南

v1.0.0 (2026-02-05)

  • ✅ 初始版本
  • ✅ 基于 wenyan-cli 封装

参考资料

License

Apache License 2.0