夜雨聆风小白必看｜OpenClaw 一键发布公众号文章（全程无坑，附故障速解）
最近很多小白问我：OpenClaw 怎么对接公众号？发布文章总报错怎么办？
其实不用慌！OpenClaw 作为一款“能动手办事”的AI助手，对接公众号发布文章，只要跟着步骤走，小白也能一次成功 ✅ （全程避开专业术语，每一步都标清楚，看不懂算我输！）
先跟大家简单说下核心逻辑：我们要做3件事——给公众号“授权”（配置后台）、给 OpenClaw “填密码”（凭证配置）、给 OpenClaw “装工具”（安装技能），最后就能一键发布文章，不用再手动复制粘贴啦～
📌 前期准备（必看！少一步都不行）
1. 有自己的微信公众号（订阅号、服务号都可以），能登录后台
2. 已经安装好 OpenClaw（没安装的宝子，先去完成安装再来看哦）
3. 电脑能正常联网，全程不用懂代码，复制粘贴命令就行
一、第一步：微信公众号后台配置（给 OpenClaw 开“权限”）
这一步是核心！相当于给 OpenClaw 办一张“进入公众号”的通行证，分2个小步骤，超简单～
1.1 获取 AppID 和 AppSecret（通行证的“账号密码”）
这两个是公众号的核心凭证，OpenClaw 靠它对接你的公众号，操作步骤如下：
① 打开微信公众号后台：用公众号管理员账号登录
https://mp.weixin.qq.com/② 登录后，点击左侧菜单栏「开发」→ 「基本配置」（找不到的宝子，看下图示意：开发在最下面，点一下就出来基本配置）
③ 进入页面后，找到「开发者 ID (AppID)」和「开发者密码 (AppSecret)」，把这两个信息记下来（可以存到记事本，后面要用）
⚠️ 重点提醒：AppSecret 是敏感信息，就像你的银行卡密码，千万不要泄露给别人！泄露了可能会导致公众号被违规操作哦～
补充：如果没找到这两个信息，就去「微信开放平台」→ 「设置与开发」→ 「账号设置」里找，步骤一样简单～
1.2 配置 IP 白名单（给 OpenClaw 开“门禁”）
微信公众号有个“安全规定”：只有添加到「IP白名单」的设备，才能通过 API 发布文章。这里分两种情况，小白按需选就好，推荐第二种（更省心）！
方案A：本地发布（适合有固定IP的宝子，比如公司服务器）
① 先获取自己的公网 IP：打开电脑“终端”（Windows 按 Win+R 输 cmd，Mac 按 command+空格 输 terminal），复制粘贴命令：
curl ifconfig.me回车后出现的一串数字就是公网 IP（比如 123.45.67.89）
② 回到公众号后台「开发」→ 「基本配置」，找到「IP白名单」，点击「添加IP」，把刚才获取的公网 IP 填进去，保存就好。
方案B：远程 MCP 服务（推荐！适合家用宽带，IP经常变）
家用宽带的 IP 会经常变，每次变都要重新加白名单，太麻烦！所以推荐用远程 MCP 服务，相当于找一个“固定IP的中转站”，步骤如下：
① 先把「wenyan-mcp 服务」部署到有固定IP的服务器（不懂部署也没关系，跟着服务器商家的教程来，很简单）
② 只需要把 MCP 服务器的 IP，添加到公众号后台的「IP白名单」（和方案A添加IP的步骤一样）
③ 最后在本地 OpenClaw 里，添加一个配置文件（mcp.json），复制下面的内容，把<your-remote-server-ip> 换成自己的 MCP 服务器 IP 即可：
{"mcpServers":{"wenyan-mcp":{"name":"公众号远程助手","transport":"sse","url":"http://<your-remote-server-ip>:3000/sse"}}}
小贴士：配置文件的路径不用记，后面会提到，跟着步骤来就好～
二、第二步：OpenClaw 凭证配置（给 OpenClaw 填“密码”）
把刚才获取的 AppID 和 AppSecret，填到 OpenClaw 里，让它能识别你的公众号。这里有两种方式，推荐第一种（更简单，小白首选）！
2.1 方式一：写入 TOOLS.md（推荐，一次配置，终身可用）
① 打开 OpenClaw 的工作区，找到「TOOLS.md」文件（文件路径：/home/will/.openclaw/workspace/TOOLS.md，复制路径就能找到）
② 打开文件后，添加下面的内容，把 wxe46cf205abxxxxxx 换成你的 AppID，a4c035e9e7a695exxxxxxx783354 换成你的 AppSecret：
# WeChat Official Account (微信公众号)**API Credentials:**export WECHAT_APP_ID=wxe46cf205abxxxxxxexport WECHAT_APP_SECRET=a4c035e9e7a695exxxxxxx783354
③ 保存文件，这样凭证就配置好了，超级简单！
2.2 方式二：使用 wechat.env（适合远程发布模式）
如果用的是「远程发布」（方案B的 MCP 服务），可以用这种方式，步骤如下：
① 打开电脑终端，复制粘贴命令，进入技能目录：
cd /home/will/.openclaw/workspace/skills/wechat-mp-publisher② 复制示例文件，生成配置文件：cp wechat.env.example wechat.env
③ 编辑配置文件：nano wechat.env，把里面的 AppID 和 AppSecret 换成自己的，保存退出即可（nano 编辑：输完内容按 Ctrl+O 保存，Ctrl+X 退出）
补充：如果需要指定 MCP 配置文件路径，就在文件里添加一行：export MCP_CONFIG_FILE="/path/to/your/mcp.json"（把路径换成自己的 mcp.json 路径）
三、第三步：安装必要 Skills（给 OpenClaw 装“工具”）
Skills 就是 OpenClaw 的“工具插件”，发布公众号文章需要安装对应的工具，步骤分4步，全程复制命令就行，不用懂原理～
3.1 先选对 Skills（小白按需选，不踩坑）
有两个技能可选，对应不同的发布模式，看清楚再装：
Skill 名称 | 适用场景 | 特点（小白易懂版） |
|---|---|---|
wechat-publisher | 本地固定 IP（方案A） | 简单直接，不用额外配置，适合公司服务器使用 |
wechat-mp-publisher | 动态 IP/远程发布（方案B） | 通过 MCP 服务中转，家用宽带也能用，IP 变了也不影响 |
3.2 安装 wenyan-cli（必需！两个技能都需要）
这是底层工具，相当于“基础插件”，必须安装，步骤如下：
① 打开终端，复制粘贴命令，回车安装：
npm install -g @wenyan-md/cli② 安装完成后，输入命令：如果出现一堆文字，说明安装成功（没成功就重新输一遍安装命令）
wenyan --help3.3 安装 Skill（选一个安装就行）
方式A：使用 ClawHub（推荐，一键安装，小白首选）
① 终端输入命令，搜索技能：clawhub search wechat（会出现两个技能，对应上面的表格）
② 安装技能（二选一）：
本地发布（方案A）：
clawhub install wechat-publisher远程发布（方案B）：
clawhub install wechat-mp-publisher方式B：手动克隆（适合懂一点终端操作的宝子）
① 终端输入命令，进入技能目录：
cd /home/will/.openclaw/workspace/skills② 克隆技能（替换 <skill-repo-url>为技能的仓库地址）：
git clone <skill-repo-url> wechat-publisher小贴士：仓库地址可以在 ClawHub 上找到，小白还是推荐方式A，更简单～
3.4 安装额外依赖（仅远程发布模式需要）
如果安装的是 wechat-mp-publisher（远程发布），还要安装两个额外工具，步骤如下：
① 安装 MCP 客户端：
npm install -g mcporter② 安装 jq（JSON 处理工具）：
Ubuntu/Debian 系统：
sudo apt install jqMac 系统：
brew install jq四、第四步：发布文章（终于到核心！一键搞定）
前面的配置都做好后，发布文章就很简单了，分3步：准备文章 → 一键发布 → 后台审核，小白也能秒会～
4.1 准备 Markdown 文件（文章内容要规范）
OpenClaw 发布文章，需要用 Markdown 格式（不懂 Markdown 也没关系，按下面的模板写就行），重点是：必须包含「标题」和「封面图」，少一个都会报错！
模板如下（复制粘贴，替换成自己的内容即可）：
---title: 文章标题（必填！比如：小白必看｜OpenClaw 公众号发布教程）cover: http://xxxx/cover.jpg # 封面图（必填！复制图片链接填这里，本地图片也可以）---# 正文开始你的文章内容...（可以写文字、插图片、放代码）## 代码示例（可选）```pythondef hello():print("Hello, WeChat!")```## 图片展示（可选） # 正文里的配图，复制图片链接填这里
⚠️ 重点提醒：title（文章标题）和 cover（封面图）是必填项，缺少任何一个，发布都会失败！封面图建议用清晰的图片，尺寸推荐900*500px，避免模糊～
4.2 三种发布方式（推荐第一种，最简单）
方式A：直接对话 OpenClaw（推荐，小白首选）
打开 OpenClaw，直接在聊天框里输入命令（替换成自己的 Markdown 文件路径）：
① 基础发布：
帮我把 /path/to/article.md 发布到微信公众号② 带主题发布（更美观）：
用 lapis 主题发布这篇文章：/path/to/article.md小贴士：/path/to/article.md 是你的 Markdown 文件路径，比如你的文件在桌面，路径就是 /Users/xxx/Desktop/article.md（Mac）或 C:\Users\xxx\Desktop\article.md（Windows）
方式B：使用脚本发布（适合习惯用终端的宝子）
① 本地发布（wechat-publisher 技能）：
cd /home/will/.openclaw/workspace/skills/wechat-publisher./scripts/publish.sh /path/to/article.md
② 远程发布（wechat-mp-publisher 技能）：
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-light4.3 主题和代码高亮（让文章更美观）
发布时可以选择主题和代码高亮样式，推荐组合（复制就能用），不用自己试错：
① 主题选项（选一个）：
--t default：默认主题（简单朴素）
--t lapis：青金石主题（推荐，美观清晰）
- -t phycat：物理猫主题（可爱风）
② 代码高亮（选一个）：
- -h solarized-light：推荐（清晰不刺眼）
- -h atom-one-dark：深色模式（适合代码多的文章）
完整示例：
wenyan publish -f article.md -t lapis -h solarized-light4.4 发布流程总结（小白必看）
1. 准备内容：用 Markdown 写好文章，添加好 title和 cover（必填）
2. 运行发布：用上面三种方式中的一种，执行发布命令
3. 审核发布：登录微信公众号后台，找到「素材管理」，审核文章内容，确认无误后点击「发布」即可～
五、第五步：故障排查（小白救星！报错不用慌）
发布时遇到报错，不用急着放弃，对照下面的表格，找到错误原因和解决方案，一键解决，比问别人更快捷！
5.1 常见错误速查（重点记！）
错误信息 | 错误原因（小白易懂） | 解决方案（一步到位） |
|---|---|---|
ip not in whitelist | 当前电脑/服务器的 IP，没添加到公众号白名单 | 去公众号后台「开发→基本配置→IP白名单」，添加当前 IP 或 MCP 服务器 IP |
wenyan: command not found | 没安装 wenyan-cli，或者安装失败 | 重新输入命令安装： |
WECHAT_APP_ID is required | 没配置 AppID 和 AppSecret，或者配置错了 | 检查 TOOLS.md 或 wechat.env 文件，确认 AppID 和 AppSecret 填写正确 |
未能找到文章封面 | Markdown 文件里，缺少 cover 字段，或封面链接无效 | 在 Markdown 的 frontmatter 里，添加正确的 cover 封面链接 |
title is required in frontmatter | Markdown 文件里，缺少 title 字段（文章标题） | 在 Markdown 的 frontmatter 里，添加 title 文章标题 |
Dependencies Missing | 缺少 jq 或 mcporter 依赖（仅远程发布需要） | 按照第三步 3.4 的步骤，安装对应的依赖 |
无法执行exec | OpenClaw 没有执行权限 | 在 openclaw.json 中，临时设置 tools profile 为 full |
5.2 发布前检查清单（避免报错！）
发布前花1分钟检查以下5点，能避免90%的报错，小白必看：
✅ AppID 和 AppSecret 已正确配置（检查 TOOLS.md 或 wechat.env）
✅ IP 已加入公众号白名单（本地 IP 或 MCP 服务器 IP）
✅ wenyan-cli 已安装（输入 wenyan --help 能正常显示）
✅ Markdown 文件有完整的 frontmatter（包含 title + cover）
✅ 封面图片可访问（链接有效，或本地图片路径正确）
5.3 获取帮助（实在解决不了，看这里）
如果遇到上面没提到的错误，可以通过以下方式获取帮助：
① 查看 wenyan-cli 帮助：wenyan --help
② 查看可用主题：wenyan theme -l
③ 测试凭证是否有效（替换成自己的 AppID 和 AppSecret）：
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"
🎯 小白快速开始检查表（贴在桌面，对照操作）
□ 1. 获取公众号 AppID 和 AppSecret（第一步 1.1）
□ 2. 配置 IP 白名单（本地 IP 或 MCP 服务器 IP，第一步 1.2）
□ 3. 安装 wenyan-cli：npm install -g @wenyan-md/cli（第三步 3.2）
□ 4. 安装技能：clawhub install wechat-publisher（或远程版，第三步 3.3）
□ 5. 配置凭证到 TOOLS.md（第二步 2.1）
□ 6. 准备 Markdown 文件（含 title 和 cover，第四步 4.1）
□ 7. 发布：让 OpenClaw 帮你发布（第四步 4.2）
💡 最后给小白的温馨提醒
1. 全程不用懂代码，所有命令都可以直接复制粘贴，重点是填对自己的 AppID、AppSecret 和文件路径
2. 推荐优先选择「远程发布模式」（方案B），不管是家用宽带还是公司电脑，都能稳定发布，不用频繁改 IP 白名单
3. 发布后一定要去公众号后台审核，确认文章格式、图片都正常，再点击发布，避免出错
4. 如果还是遇到问题，评论区留言，我会一一回复，帮你解决～
按照上面的步骤操作，小白也能轻松用 OpenClaw 一键发布公众号文章，节省更多时间专注于内容创作❤️
