微信公众号自动发布实战：从动态IP困境到云托管解决方案

一、背景与问题

作为内容创作者，微信公众号是重要的发布渠道。但在尝试实现远程自动化发布时，遇到了一系列技术障碍。本文完整记录了从问题定位到最终解决方案的全过程，希望能为有类似需求的开发者提供参考。

核心需求

• 通过 AI 助手（QClaw）远程撰写文章

• 自动生成高质量封面图

• 无需手动操作，文章自动进入公众号草稿箱

二、技术难点分析

2.1 IP 白名单困境

微信公众号 API 要求调用方 IP 必须在白名单内。对于家庭宽带用户，外网 IP 会动态变化：

# 第一次查询 $ curl -s ipinfo.io/ip 111.55.204.86 # 几小时后再次查询 $ curl -s ipinfo.io/ip 111.55.204.64 # IP 已变化

每次 IP 变化都需要手动登录公众号后台更新白名单，完全无法实现自动化。

2.2 Access Token 管理

传统方案调用公众号 API 需要获取 access_token：

1. 使用 AppID + Secret 换取 access_token

2. Token 有效期 2 小时，需要定时刷新

3. 每天有调用次数限制（2000 次）

4. Token 泄露存在安全风险

2.3 封面图生成

公众号草稿必须有封面图（thumb_media_id）。探索过的方案：

最终采用了html2image方案：用 HTML 模板生成封面，通过 Playwright 渲染成图片。中文显示完美，而且零成本。

三、解决方案：微信云托管开放接口服务

3.1 什么是开放接口服务？

微信云托管开放接口服务是微信团队提供的免鉴权解决方案：

• ✅ 容器内调用api.weixin.qq.com自动鉴权

• ✅ 无需管理 access_token

• ✅不受 IP 白名单限制

• ✅ 云托管环境有固定出口 IP

3.2 工作原理对比

传统方式：

1. 获取 access_token（需 AppID + Secret + IP 白名单） 2. 带 token 调用业务接口 3. 定时刷新 token（有效期 2 小时） 4. 处理 token 过期重试逻辑

开放接口服务方式：

1. 容器内直接 POST http://api.weixin.qq.com/cgi-bin/draft/add 2. 云托管自动注入鉴权信息 3. 无需管理 token，无需 IP 白名单 4. 代码极简，稳定可靠

四、实现步骤

Step 1：开通云托管环境

1. 访问 微信云托管控制台

2. 选择关联的公众号/小程序

3. 创建环境（免费额度足够测试使用）

Step 2：配置开放接口服务

进入控制台 → 设置 → 云调用：

1. 开启「开放接口服务」开关

2. 添加需要的接口权限：

• /cgi-bin/draft/add

  — 创建草稿

• /cgi-bin/material/add_material

  — 上传素材

Step 3：部署发布服务

服务核心代码（Node.js）：

const axios = require('axios'); const FormData = require('form-data'); const WX_API = 'http://api.weixin.qq.com'; // 开放接口服务地址 // 生成封面图（调用 html2image） async function generateCoverImage(params) { const html = generateCoverHTML(params); // HTML 模板 const res = await axios.post('https://html2image.hanfangyuan.cn/api/html2image', { html, viewport_width: 2680, viewport_height: 800, image_type: 'png' }); return Buffer.from(res.data.image_base64, 'base64'); } // 上传封面到素材库 async function uploadCover(params) { const buf = await generateCoverImage(params); const form = new FormData(); form.append('media', buf, { filename: 'cover.png', contentType: 'image/png' }); return new Promise((resolve, reject) => { // 开放接口服务自动鉴权，无需 access_token form.submit(`${WX_API}/cgi-bin/material/add_material?type=image`, (err, res) => { /* ... */ }); }); } // 创建草稿 async function publishArticle(params) { const { media_id } = await uploadCover(params); return axios.post(`${WX_API}/cgi-bin/draft/add`, { articles: [{ title: params.title, content: params.content, thumb_media_id: media_id, author: params.author, digest: params.digest, need_open_comment: 1 // 开启评论 }] }); }

Step 4：远程调用发布

curl -X POST https://your-service.run.tcloudbase.com/publish \ -H 'Content-Type: application/json' \ -d '{ "title": "文章标题", "content": "<p>正文 HTML</p>", "author": "作者", "digest": "摘要", "cover_tag": "技术教程" }'

五、封面图生成方案详解

封面图采用html2image方案，核心技术栈：

• FastAPI + Playwright

  ：接收 HTML，启动 Chromium 渲染截图

• HTML 模板

  ：用 CSS 实现各种风格的排版

• 输出

  ：base64 编码的 PNG 图片

封面尺寸规范

公众号封面采用2680×800 px（3.35:1）横屏比例，包含两部分：

• 左侧主图区域（1880×800）：文章封面主体

• 右侧小图区域（800×800）：分享时显示的方形图

内置三种模板风格：

• editorial

  （大字报刊风格）：适合突出标题

• grid

  （网格高亮风格）：信息模块化排列

• block

  （色块气泡风格）：视觉层次丰富

六、踩过的坑

6.1 baoyu-post-to-wechat 浏览器方式缺失依赖

尝试安装baoyu-post-to-wechat技能，但浏览器方式依赖的baoyu-chrome-cdp包在 npm 上 404，无法使用。

6.2 云托管 CLI 交互式部署

wxcloud run:deploy是交互式命令，即使加了--noConfirm也会有选择器弹出。解决方案：用 expect 脚本自动化处理所有交互。

6.3 云端 Docker 缓存问题

多次部署后镜像 digest 不变，新代码未生效。解决方案：创建新服务或清理云端缓存。

6.4 封面图尺寸

封面图推荐900×383 px（2.35:1），这是公众号主封面的标准比例。使用 html2image 时建议生成 2680×800 的大图以保证清晰度。

七、最终效果

整条链路打通后：

1. AI 助手根据主题撰写文章

2. 自动生成高质量 HTML 封面

3. 调用云托管服务上传封面并创建草稿

4. 用户在公众号后台确认发布

全程无需手动复制粘贴，真正实现「说一句话，文章自动上草稿箱」。

八、技术栈总结

九、参考资源

• 微信云托管开放接口服务文档

• html2image GitHub

• text-card-skills GitHub

本文由OpenClaw自动生成并发布到公众号草稿箱

封面图由 html2image 服务渲染生成