wechat-publisher - 发布微信公众号推文

这是一个可以自动发布微信公众号推广的技能

使用 OpenClaw 自动发布微信公众号推文,核心是通过 wechat-publisher 技能 对接微信公众号 API,实现从 Markdown 到公众号草稿/群发的自动化流程。以下是完整步骤:

一、准备工作(必须完成)

  1. 微信公众号
  • 已注册并认证的订阅号/服务号(未认证账号无法使用发布接口)(实测个人公众号也可用)。
  • 登录微信公众平台 → 设置与开发 → 基本配置:
    • 该功能已迁移至“微信开发者平台” ,地址如下:
https://developers.weixin.qq.com/platform?aibot=1&utm_source=community
    • 登录后,“前往控制台” “我的业务”,“公众号”
    • 复制 AppID(开发者ID)、AppSecret(开发者密码)。
    • 在 IP白名单 中添加运行 OpenClaw 的设备/服务器公网 IP,不配置无法正常发布推文。
  1. OpenClaw 环境
  • 已安装并正常运行 OpenClaw(本地/云服务器均可)。
  • 安装 Node.js(用于依赖与排版工具)。

二、安装并配置 wechat-publisher 技能

1. 安装技能(两种方式)

  • 方式1:ClawHub 一键安装(推荐)
npx clawhub@latest install wechat-publisher

技能默认安装到:~/.openclaw/workspace/skills/wechat-publisher。

  • 方式2:手动创建技能目录
mkdir -p ~/.openclaw/workspace/skills/wechat-mp
cd ~/.openclaw/workspace/skills/wechat-mp
npm install node-fetch commander form-data

2. 配置公众号凭证(两种方式)

  • 方式1:环境变量(推荐)
# Linux/macOS
echo 'export WECHAT_APP_ID="你的AppID"' >> ~/.bashrc
echo 'export WECHAT_APP_SECRET="你的AppSecret"' >> ~/.bashrc
source ~/.bashrc

# Windows PowerShell
$env:WECHAT_APP_ID="你的AppID"
$env:WECHAT_APP_SECRET="你的AppSecret"
  • 方式2:OpenClaw 配置文件编辑 ~/.openclaw/openclaw.json,添加:
{
  "skills": {
    "entries": {
      "wechat-publisher": {
        "enabled": true,
        "env": {
          "WECHAT_APPID": "你的AppID",
          "WECHAT_SECRET": "你的AppSecret"
        }
      }
    }
  }
}
  • 方式3:配置.env文件,放在工作区根目录
WECHAT_APP_ID=wx******
WECHAT_APP_SECRET=****************
  • 方式4:在聊天窗口,发给openclaw自动配置
以下是微信的AppID和AppSecret帮我配置一下:
AppID(开发者ID):*******
AppSecret(开发者密码):********

3. 安装排版工具(wenyan-cli)

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

三、发布流程(3种方式)

1. 命令行直接发布(最常用)

  • 创建草稿(推荐,安全)
cd ~/.openclaw/workspace/skills/wechat-publisher
bash scripts/publish.sh /path/to/你的文章.md

执行后,文章会自动:

    • Markdown → 公众号富文本
    • 图片上传到微信素材库
    • 生成草稿并进入公众号后台「草稿箱」。
  • 命令行参数发布(更灵活)
# 创建草稿
node index.js --action create_draft --title "文章标题" --content "正文内容" --author "作者名"

# 发布草稿到粉丝(需草稿ID)
node index.js --action publish --media_id "草稿ID" --to_send

2. OpenClaw 对话式发布

在 OpenClaw 聊天窗口直接发送:

帮我发布这篇文章到我的微信公众号
/Users/xxx/文章.md

OpenClaw 会自动调用 wechat-publisher 完成上传。

3. 定时自动发布(结合 cron)

在 OpenClaw 中创建定时任务:

创建定时任务:每天早上9点发布待发布文章

OpenClaw 会生成 cron 表达式(如 0 9 * * *)并自动执行发布脚本。

四、文章格式要求(Markdown 规范)

为保证排版正常,文章需包含 frontmatter(文章元信息):

---
title: 文章标题
author: 作者名
summary: 摘要(可选)
cover: ./封面图.jpg  # 本地封面图路径
tags: 标签1,标签2
---

# 正文标题
正文内容...

五、常见问题与排查

  1. API 调用失败
  • 检查 IP 白名单是否正确添加。
  • 确认 AppID/AppSecret 无误,未泄露。
  • 公众号是否完成认证。
  1. 图片无法上传
  • 确保图片路径正确,使用本地路径而非外链。
  • 检查 wenyan-cli 是否正常安装。
  1. 草稿生成成功但未显示
  • 登录公众号后台 → 草稿箱 查看。
  • 未认证账号仅支持草稿,不支持群发。

六、完整工作流总结

  1. 准备公众号并获取 API 凭证 → 配置 IP 白名单。
  2. 安装 wechat-publisher 与 wenyan-cli。
  3. 配置环境变量/配置文件。
  4. 编写带 frontmatter 的 Markdown 文章。
  5. 命令行/对话/定时触发发布 → 草稿箱审核 → 手动群发。