我要投稿

从 Markdown 到微信公众号：OpenClaw 自动化发布全流程

发布日期：2026-03-08 13:05:08 浏览次数： 3010

作者：GitHub精选

微信搜一搜，关注“GitHub精选”

作为 GitHub 精选公众号的独立开发者，我深知内容创作和发布的痛点——写作、排版、发布、推广，每一步都需要大量人工操作。最近我尝试使用 OpenClaw 的 wechat-publisher 技能，实现了 Markdown 文章到微信公众号的自动化发布。以下是我的全流程总结：

📦 安装与配置

1. 核心工具：wenyan-cli


# 安装 wenyan-cli（微信公众号发布工具）
npm install -g @wenyan-md/cli

# 验证安装
wenyan --help

2. OpenClaw 技能：wechat publisher

通过clawhub安装微信公众号发布技能：


clawhub install wechat-publisher

3. 配置微信公众号 API 凭证

在 ~/.zshrc 或 ~/.bashrc 中添加：


export WECHAT_APP_ID="你的微信公众号App ID"
export WECHAT_APP_SECRET="你的微信公众号App Secret"

⚠️ 重要提醒： 必须将你的服务器IP添加到微信公众号后台的白名单中！

✍️ 文章格式要求

必需的前置元数据（frontmatter）

根据实测经验，wenyan-cli对格式要求严格：


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

# 正文内容...

关键发现：

title 和 cover 两者都是必填字段
缺少封面图会报错："未能找到文章封面"
即使文档说明"正文有图可省略cover"，实际测试必须提供
所有图片都会自动上传到微信图床

封面图推荐格式


# 相对路径（推荐，便于分享）
cover: ./assets/default-cover.jpg

# 绝对路径  
cover: /Users/username/photos/cover.jpg

# 网络图片
cover: https://images.unsplash.com/photo-xxx

🚀 发布实战案例

案例：我的上一篇"回归公告"文章发布过程

1. 原始内容文件：wechat-return-announcement.md


# 微信公众号回归公告内容

## 标题
我回来了！这次带着OpenClaw，让更新不再难产
...

2. 转换后的标准格式：wechat-return-announcement-formatted.md


---
title: 我回来了！这次带着OpenClaw，让更新不再难产
cover: https://images.unsplash.com/photo-1677442136019-21780ecad995?w=1200&q=80
---

# 我回来了！这次带着OpenClaw，让更新不再难产

好久不见，一直关注GitHub精选的朋友们！👋
...

3. 发布命令：


wenyan publish -f wechat-return-announcement-formatted.md -t lapis -h solarized-light

4. 发布结果：


发布成功，Media ID: JLKhOTRTm5H06wwFNvMieH9FBxxaos3KbWyLBkg-aN6xlk3u8oPibAfXjbeOJbhm

成功！ 文章已自动上传到微信公众号草稿箱。

⚙️ 主题与样式配置

内置主题选择


# 青金石主题 + solarized-light代码高亮（推荐）
wenyan publish -f article.md -t lapis -h solarized-light

# 物理猫主题 + GitHub代码高亮  
wenyan publish -f article.md -t phycat -h github

# 默认主题 + monokai代码高亮
wenyan publish -f article.md -t default -h monokai

自定义设置


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

# 关闭链接转脚注
wenyan publish -f article.md -t lapis --no-footnote

🛠️ 故障排除

常见问题与解决方案

错误：ip not in whitelist


# 获取公网IP
curl ifconfig.me

# 添加到微信公众号后台IP白名单
# 开发 → 基本配置 → IP白名单 → 添加IP

错误：wenyan: command not found


npm install -g @wenyan-md/cli

错误：WECHAT_APP_ID is required


# 检查环境变量
echo $WECHAT_APP_ID
echo $WECHAT_APP_SECRET

错误：title is required in frontmatter


# 修正示例
---
title: 你的文章标题
cover: ./assets/cover.jpg
---

📊 效率对比

传统发布流程（约30-45分钟）

写作 → 2. 格式调整 → 3. 图片处理 → 4. 登录公众号后台 → 5. 复制粘贴内容 → 6. 排版调整 → 7. 封面图上传 → 8. 保存预览 → 9. 发布

OpenClaw自动化流程（约2-3分钟）

写作 → 2. Markdown格式化 → 3. 运行发布命令 → 4. 自动完成！

效率提升： 约10-15倍！

🔄 完整工作流示例

自动化脚本 `publish_wechat.sh`


#!/bin/bash

# 加载环境变量
source ~/.zshrc

# 检查必要工具
if ! command -v wenyan &> /dev/null; then
    echo"wenyan-cli未安装，正在安装..."
    npm install -g @wenyan-md/cli
fi

# 检查环境变量
if [ -z "$WECHAT_APP_ID" ] || [ -z "$WECHAT_APP_SECRET" ]; then
    echo"错误：未设置微信公众号API凭证"
    exit 1
fi

# 发布文章
ARTICLE_FILE="$1"
if [ -z "$ARTICLE_FILE" ]; then
    echo"用法：./publish_wechat.sh <markdown文件路径>"
    exit 1
fi

if [ ! -f "$ARTICLE_FILE" ]; then
    echo"错误：文件不存在：$ARTICLE_FILE"
    exit 1
fi

echo"开始发布文章：$ARTICLE_FILE"
wenyan publish -f "$ARTICLE_FILE" -t lapis -h solarized-light

if [ $? -eq 0 ]; then
    echo"✅ 发布成功！文章已添加到微信公众号草稿箱"
    echo"📱 登录 https://mp.weixin.qq.com 查看并发布"
else
    echo"❌ 发布失败，请检查错误信息"
fi

OpenClaw 集成调用


用户：帮我发布这篇文章到微信公众号
文件：wechat-return-announcement-formatted.md

OpenClaw 自动执行：
1. ✅ 检查 wenyan-cli 安装状态
2. ✅ 验证环境变量配置  
3. ✅ 检查 Markdown 格式
4. ✅ 执行发布命令
5. 📋 返回发布结果 Media ID