微信公众号远程发布 (Remote Publisher - Compliance Optimized)
核心痛点解决:家用宽带 IP 频繁变动,无法固定添加到公众号白名单?
本技能通过远程 wenyan-mcp 服务中转,让你的本地 OpenClaw 也能稳定发布文章,无需本地 IP 权限!
🌟 架构优势
- IP 漫游无忧:仅需将远程 MCP 服务器 IP 加入白名单,无论你在家里、咖啡厅还是 4G 热点,都能随时发布。
- 合规隔离:凭证与系统配置分离,避免污染全局
TOOLS.md。 - 依赖自检:脚本运行时自动检查
jq、mcporter和wenyan-cli。 - 灵活配置:支持自定义 MCP 配置文件路径。
⚙️ 快速配置
1. 准备凭证 (wechat.env)
在技能根目录下复制 wechat.env.example 为 wechat.env 并填入公众号凭证:
cp wechat.env.example wechat.env
nano wechat.env
内容示例:
export WECHAT_APP_ID="wx..."
export WECHAT_APP_SECRET="cx..."
# Optional: 指定 MCP 配置文件 (默认 $HOME/.openclaw/mcp.json)
# export MCP_CONFIG_FILE="/path/to/your/mcp.json"
2. 连接远程服务 (mcp.json)
确保你的 mcp.json 指向远程 MCP 实例:
{
"mcpServers": {
"wenyan-mcp": {
"name": "公众号远程助手",
"transport": "sse",
"url": "http://<your-remote-server-ip>:3000/sse",
"headers": {
"X-API-Key": "<optional-api-key>"
}
}
}
}
🚀 使用指南
方式 A: 智能助手 (推荐)
直接对我说:
"帮我把
path/to/article.md发布到公众号,使用默认主题。"
我会自动:
- 读取
wechat.env获取凭证 - 检查本地环境 (
mcporter,jq) - 调用远程 MCP 完成发布
方式 B: 命令行脚本 (高级)
我们提供了封装好的脚本 scripts/publish-remote.sh,体验与本地 CLI 一致:
# 赋予执行权限
chmod +x scripts/publish-remote.sh
# 发布文章 (自动加载 wechat.env)
./scripts/publish-remote.sh ./my-post.md
# 指定主题 (lapis)
./scripts/publish-remote.sh ./my-post.md lapis
📝 Markdown 规范
与标准 wenyan-cli 一致,头部必须包含元数据:
---
title: 我的精彩文章
cover: https://example.com/cover.jpg
---
# 正文开始
...
提示:cover 推荐使用图床链接,以确保远程服务器能正确下载封面。
🛠️ 故障排查
| 现象 | 原因 | 解决方案 |
|---|---|---|
| Dependencies Missing | 缺少 jq 或 mcporter | 请确保系统已安装这些工具 |
| Config Not Found | 未找到 wechat.env | 请按照步骤 1 创建并配置 |
| IP not in whitelist | 远程服务器 IP 未加白 | 登录公众号后台 -> 基本配置 -> IP 白名单,添加 MCP 服务器的公网 IP |