作为 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
📈 实际效果与收益
通过 wechat-publisher 技能，我实现了：
✅ 时间节省：发布一篇文章从 30 分钟缩短到 2 分钟
✅ 格式统一：标准化排版，减少手动调整
✅ 降低错误：自动化流程减少人为疏忽
✅ 批量处理：支持多篇文章连续发布
✅ 内容归档：Markdown 源文件便于版本管理
🔮 未来展望
-
更智能的选题推荐 – 结合 GitHub API 分析热门项目 -
自动化的配图生成 – 集成AI图像工具生成文章配图 -
多渠道同步发布 – 同时发布到今日头条、知乎等平台 -
数据驱动的内容优化 – 分析阅读数据优化内容策略
💌 总结
作为独立开发者，OpenClaw 的 wechat-publisher 技能从根本上解决了我发布微信公众号的技术痛点。从 Markdown 写作到自动上传，整个过程清晰、高效、可靠。
核心价值：
-
🚀 极简操作：一行命令完成复杂发布流程 -
🎨 专业排版：无需手动调整微信格式 -
🛡️ 安全可靠：官方API，数据安全有保障 -
📁 代码友好：Git 版本管理 Markdown 源文件
对于那些需要管理多个媒体平台的独立开发者和创作者来说，这不仅是技术工具，更是生产力解放。
