OpenClaw 微信公众号发布教程

本教程将详细介绍如何在 OpenClaw 中配置和使用微信公众号发布功能。

📋 目录

1. 微信公众号后台配置
2. OpenClaw 凭证配置
3. 安装必要 Skills
4. 发布文章
5. 故障排查

1. 微信公众号后台配置

1.1 获取 AppID 和 AppSecret

1. 登录 微信公众号后台
2. 进入 开发 → 基本配置
3. 记录以下信息：
   • 开发者 ID (AppID): 如 wx开发者id
   • 开发者密码 (AppSecret): 如 a4c035e9e7a69123123123123123
   • AppID与AppSecret：请移步至微信开放平台 -> 设置与开发-> 账号设置 中获取

⚠️ 注意: AppSecret 是敏感信息，请妥善保管，不要泄露给他人。

1.2 配置 IP 白名单

微信公众号 API 要求调用方的 IP 必须在白名单中。

方案 A: 本地发布（固定 IP）

如果你的服务器有固定公网 IP：

1. 获取你的公网 IP：

   curl ifconfig.me
   

2. 在公众号后台 开发 → 基本配置 → IP 白名单 中添加该 IP

方案 B: 远程 MCP 服务（推荐，适合家用宽带）

如果你的 IP 经常变动（如家用宽带），建议使用远程 MCP 服务：

1. 部署 wenyan-mcp 服务到具有固定 IP 的服务器
2. 只需将 MCP 服务器的 IP 加入白名单
3. 本地 OpenClaw 通过 MCP 服务中转发布

// mcp.json 配置示例
{
  "mcpServers": {
    "wenyan-mcp": {
      "name": "公众号远程助手",
      "transport": "sse",
      "url": "http://<your-remote-server-ip>:3000/sse"
    }
  }
}

2. OpenClaw 凭证配置

2.1 方式一：写入 TOOLS.md（推荐）

编辑工作区的 TOOLS.md 文件，添加公众号凭证：

# 🔐 WeChat Official Account (微信公众号)

**API Credentials:**
```bash
export WECHAT_APP_ID=wxe46cf205abxxxxxx
export WECHAT_APP_SECRET=a4c035e9e7a695exxxxxxx783354

**文件路径**: `/home/will/.openclaw/workspace/TOOLS.md`

### 2.2 方式二：使用 wechat.env（远程发布模式）

如果使用 `wechat-mp-publisher` 技能，可以在技能目录下创建 `wechat.env`：

```bash
cd /home/will/.openclaw/workspace/skills/wechat-mp-publisher
cp wechat.env.example wechat.env
nano wechat.env

内容：

export WECHAT_APP_ID="wxe46cf205abxxxxxx"
export WECHAT_APP_SECRET="a4c035e9e7a695exxxxxxx783354"
# Optional: 指定 MCP 配置文件路径
# export MCP_CONFIG_FILE="/path/to/your/mcp.json"

3. 安装必要 Skills

3.1 可用 Skills 对比

3.2 安装 wenyan-cli（必需）

两个技能都需要 wenyan-cli 作为底层工具：

npm install -g @wenyan-md/cli

验证安装：

wenyan --help

3.3 安装 Skill

方式 A: 使用 ClawHub（推荐）

# 搜索技能
clawhub search wechat

# 安装技能
clawhub install wechat-publisher
# 或
clawhub install wechat-mp-publisher

方式 B: 手动克隆

cd /home/will/.openclaw/workspace/skills
git clone <skill-repo-url> wechat-publisher

3.4 安装额外依赖（远程发布模式）

如果使用 wechat-mp-publisher，还需要：

# 安装 MCP 客户端
npm install -g mcporter

# 安装 jq（JSON 处理工具）
# Ubuntu/Debian
sudo apt install jq
# macOS
brew install jq

4. 发布文章

4.1 准备 Markdown 文件

创建 Markdown 文件，必须包含完整的 frontmatter：

---
title: 文章标题（必填！）
cover: https://example.com/cover.jpg  # 封面图（必填！）
---

# 正文开始

你的内容...

## 代码示例

```python
def hello():
    print("Hello, WeChat!")

图片展示

> ⚠️ **重要**: `title` 和 `cover` 都是必填字段，缺少任何一个都会报错！

### 4.2 使用 OpenClaw 发布

#### 方式 A: 直接对话（推荐）

在 OpenClaw 中直接说：

帮我把 /path/to/article.md 发布到微信公众号

或

使用 lapis 主题发布这篇文章：/path/to/article.md

#### 方式 B: 使用脚本

```bash
# 本地发布
cd /home/will/.openclaw/workspace/skills/wechat-publisher
./scripts/publish.sh /path/to/article.md

# 远程发布
cd /home/will/.openclaw/workspace/skills/wechat-mp-publisher
./scripts/publish-remote.sh /path/to/article.md

方式 C: 直接使用 wenyan-cli

wenyan publish -f article.md -t lapis -h solarized-light

4.3 主题选项

wenyan-cli 支持多种主题和代码高亮：

# 主题选项
-t default      # 默认
-t lapis        # 青金石（推荐）
-t phycat       # 物理猫

# 代码高亮
-h solarized-light   # 推荐
-h atom-one-dark
-h github-dark
-h dracula

# 完整示例
wenyan publish -f article.md -t lapis -h solarized-light

4.4 发布流程

1. 准备内容 - 用 Markdown 写作，添加 frontmatter
2. 运行发布 - 通过 OpenClaw 或脚本发布
3. 审核发布 - 登录公众号后台审核并发布

5. 故障排查

5.1 常见错误

5.2 检查清单

发布前确认：

• AppID 和 AppSecret 已正确配置
• IP 已加入公众号白名单
• wenyan-cli 已安装 (wenyan --help 可运行)
• Markdown 文件有完整的 frontmatter（title + cover）
• 封面图片可访问（本地路径或有效 URL）

5.3 获取帮助

# 查看 wenyan-cli 帮助
wenyan --help

# 查看可用主题
wenyan theme -l

# 测试凭证
curl -G "https://api.weixin.qq.com/cgi-bin/token" \
  --data-urlencode "grant_type=client_credential" \
  --data-urlencode "appid=YOUR_APP_ID" \
  --data-urlencode "secret=YOUR_APP_SECRET"

📚 参考资料

• wenyan-cli GitHub
• wenyan 官网
• 微信公众号 API 文档
• wenyan-mcp GitHub
• OpenClaw 文档

🎯 快速开始检查表

□ 1. 获取公众号 AppID 和 AppSecret
□ 2. 配置 IP 白名单（本地 IP 或 MCP 服务器 IP）
□ 3. 安装 wenyan-cli: npm install -g @wenyan-md/cli
□ 4. 安装技能: clawhub install wechat-publisher
□ 5. 配置凭证到 TOOLS.md
□ 6. 准备 Markdown 文件（含 title 和 cover）
□ 7. 发布：让 OpenClaw 帮你发布

最后更新：2026-02-26