---
name: gzh-publisher
description: "微信公众号统一发布技能：通过 OpenClaw Browser 自动化完成登录、写文章、一键排版、封面、存草稿。"
metadata: {"version":"3.2.0","author":"Daniel Li","domains":["content","publishing","automation","wechat"],"type":"automation"}
---
description: "微信公众号统一发布技能：通过 OpenClaw Browser 自动化完成登录、写文章、一键排版、封面、存草稿。唯一官方公众号发布方式。"
license: MIT
metadata:
version: 3.2.0
author: Daniel Li / 小a CEO
domains: [content, publishing, automation, wechat]
type: automation
requires: [openclaw-browser]
---
# GZH Publisher Skill — 公众号统一发布
> **唯一官方微信公众号发布方式。基于 OpenClaw Browser 自动化。**
## 🚀 快速使用（脚本模式）
```bash
# 推荐：自动扫描 gzh/ 目录图片
python3 scripts/publish.py --article gzh/article.md --author "Daniel"
# 跳过一键排版
python3 scripts/publish.py --article gzh/article.md --author "Daniel" --no-format
# 跳过封面
python3 scripts/publish.py --article gzh/article.md --author "Daniel" --no-cover
```
需要 OpenClaw Browser 运行中（`openclaw browser start`）。
---
## 什么时候用
- 有 Markdown 文章需要发布到微信公众号草稿箱
- Agent 需要"发布公众号"、"公众号草稿"、"发微信"时
> 📋 **发布前确认内容合规**：`~/clawd/projects/MediaClaw/references/platforms/weixin-mp.md`
## 不适用
- ❌ 直接正式发布 — 仅存草稿，人工最终审核发布
- ❌ 视频内容 — 仅支持图文消息
- ❌ 编辑已发布文章 — 只能新建
---
## 🔄 完整 Workflow（2026-04-18 实战验证）
```
┌─────────────────────────────────────────────────────┐
│ Step 1: 检查登录状态 │
│ browser → navigate(mp.weixin.qq.com) │
├─────────────────────────────────────────────────────┤
│ Step 2: 新建文章（新标签页 appmsg_edit） │
├─────────────────────────────────────────────────────┤
│ Step 3: 填标题（JS evaluate, textarea） │
├─────────────────────────────────────────────────────┤
│ Step 4: 填作者（JS evaluate, input） │
├─────────────────────────────────────────────────────┤
│ Step 5: 粘贴素材图片（clipboard + Ctrl+V） │
│ → 每张等8秒 CDN 转换 → 收集 mmbiz URL │
├─────────────────────────────────────────────────────┤
│ Step 6: 设封面「从正文选择」← 必须在 HTML 注入前！ │
├─────────────────────────────────────────────────────┤
│ Step 7: 注入正文 HTML（CDP WebSocket, 含 CDN 图片） │
├─────────────────────────────────────────────────────┤
│ Step 8: 一键排版（新标签页 articlestruct） │
│ → 点"使用此排版" → 图片不会丢失 ✅ │
├─────────────────────────────────────────────────────┤
│ Step 9: 保存草稿 │
└─────────────────────────────────────────────────────┘
```
---
## ⚡ 关键发现（踩坑总结）
### 1. 图片粘贴：唯一可行方案
- ❌ `innerHTML` 注入 `<img>` → 图片不加载
- ❌ CDP `DOM.setFileInputFiles` → 上传但不插入编辑器
- ❌ OpenClaw `browser upload` → 同上
- ❌ clipboard 只支持 PNG，JPEG 会报 `Type not supported`
- ✅ **clipboard.write(PNG blob) + keyboard Ctrl+V** → 唯一可行
### 2. 封面必须在 HTML 注入前设置
- ❌ HTML 注入后点"从正文选择" → 弹窗为空（innerHTML 不注册图片到微信服务端）
- ❌ 排版后点"从正文选择" → 弹窗为空（排版可能清除服务端注册）
- ✅ **粘贴图片后立即设封面**（此时 ProseMirror 追踪了粘贴的图片）
### 3. 一键排版不会丢图片
- ❌ innerHTML 注入后排版 → 排版读的是 ProseMirror 内部状态（空的），内容丢失
- ✅ **先粘贴图片让 ProseMirror 追踪 → 再注入 HTML → 再排版** → 图片保留
- 一键排版打开新标签页 `articlestruct`，需切换 targetId 后点"使用此排版"
### 4. 标题/作者用 JS evaluate
- ❌ Playwright `fill()` 在微信 textarea 上会超时
- ✅ `ta.value = ...` + `dispatchEvent('input')` via browser evaluate
### 5. 长 HTML 必须用 CDP 注入
- ❌ OpenClaw `evaluate` 的 fn 有字符长度限制，>2000字会被截断
- ✅ 先写 `/tmp/wechat-article.html` → CDP WebSocket `Runtime.evaluate` 注入
---
## 📋 逐步操作指南
### Step 1: 检查登录
```
browser(action="navigate", profile="openclaw", url="https://mp.weixin.qq.com")
browser(action="snapshot", profile="openclaw")
```
- 包含"新的创作"+ 账号名 → **已登录** ✅
- 包含"请登录"或 QR 码 → **未登录** → 截图发 Daniel 扫码
### Step 2: 新建文章
```
// 点"新的创作"
browser(action="act", kind="evaluate", fn="""
() => {
const h2s = document.querySelectorAll('h2');
for (const h of h2s) {
if (h.textContent.trim() === '新的创作') { h.click(); return 'clicked'; }
}
}
""")
// 等1秒 → 点"文章"（y>300 的第一个文本="文章"的元素）
// 等待6秒 → 用 tabs 找 appmsg_edit 标签页
browser(action="tabs", profile="openclaw")
```
### Step 3: 填标题
```
browser(action="act", kind="evaluate", targetId=编辑器, fn="""
() => {
const ta = document.querySelector('textarea[placeholder*="标题"]');
ta.focus(); ta.value = '文章标题';
ta.dispatchEvent(new Event('input', {bubbles:true}));
return 'filled: ' + ta.value;
}
""")
```
### Step 4: 填作者
```
browser(action="act", kind="evaluate", targetId=编辑器, fn="""
() => {
const inp = document.querySelector('input[placeholder*="作者"]');
inp.focus(); inp.value = 'Daniel';
inp.dispatchEvent(new Event('input', {bubbles:true}));
return 'filled';
}
""")
```
### Step 5: 粘贴素材图片
**必须用 CDP WebSocket 方式**（browser 工具的 evaluate 传 base64 太大）：
```python
# 写成独立脚本 /tmp/paste_images.py，exec 运行
import asyncio, json, base64, httpx, websockets, os
async def paste_all(images, target_id):
async with httpx.AsyncClient() as c:
r = await c.get("http://127.0.0.1:18800/json/list")
ws_url = next(t["webSocketDebuggerUrl"] for t in r.json() if target_id in t["id"])
async with websockets.connect(ws_url, max_size=50*1024*1024) as ws:
# Grant clipboard
await ws.send(json.dumps({"id":0,"method":"Browser.grantPermissions",
"params":{"permissions":["clipboard-read","clipboard-write"],"origin":"https://mp.weixin.qq.com"}}))
await ws.recv()
for img_path in images:
with open(img_path, "rb") as f:
b64 = base64.b64encode(f.read()).decode()
# Write to clipboard
await ws.send(json.dumps({"id":1,"method":"Runtime.evaluate",
"params":{"expression":f"""
(async () => {{
const b = await fetch('data:image/png;base64,{b64}').then(r=>r.blob());
await navigator.clipboard.write([new ClipboardItem({{'image/png': b}})]);
}})()
"""}}))
await ws.recv()
await asyncio.sleep(0.5)
# Focus + Ctrl+V
await ws.send(json.dumps({"id":2,"method":"Runtime.evaluate",
"params":{"expression":"document.querySelector('.ProseMirror').focus()"}}))
await ws.recv()
for ev in ["keyDown","keyUp"]:
await ws.send(json.dumps({"id":3,"method":"Input.dispatchKeyEvent",
"params":{"type":ev,"modifiers":2,"key":"v","code":"KeyV","windowsVirtualKeyCode":86}}))
await ws.recv()
await asyncio.sleep(8) # Wait for CDN conversion
```
**JPG 必须先转 PNG**（Pillow）：`Image.open(p).save(p.with_suffix('.png'), 'PNG')`
**收集 CDN URL**：
```
browser(action="act", kind="evaluate", targetId=编辑器, fn="""
() => JSON.stringify(
Array.from(document.querySelectorAll('.ProseMirror img'))
.filter(i => i.src.includes('mmbiz')).map(i => i.src)
)
""")
```
### Step 6: 设封面（从正文选择）
⚠️ **必须在 Step 7 HTML 注入之前做！**
```
// 1. 点"从正文选择"
browser(action="act", kind="evaluate", targetId=编辑器, fn="""
() => {
const items = document.querySelectorAll('#js_cover_description_area a, a');
for (const el of items) {
if (el.textContent.includes('从正文选择')) { el.click(); return 'clicked'; }
}
return 'not found';
}
""")
// 2. 选第一张图
browser(action="act", kind="evaluate", targetId=编辑器, fn="""
() => {
const items = document.querySelectorAll('.appmsg_content_img_item');
if (items.length > 0) { items[0].click(); return 'selected'; }
return 'empty';
}
""")
// 3. 下一步 → 确认
```
### Step 7: 注入正文 HTML
**长 HTML 必须用 CDP**（先写文件再注入）：
```bash
# 1. 生成 HTML 写入文件（图片 URL 替换为 CDN）
write(path="/tmp/wechat-article.html", content=生成的HTML)
# 2. CDP 注入
python3 << 'EOF'
import json, asyncio, httpx, websockets
async def inject():
async with httpx.AsyncClient() as c:
r = await c.get("http://127.0.0.1:18800/json/list")
ws_url = next(t["webSocketDebuggerUrl"] for t in r.json() if TARGET in t["id"])
with open("/tmp/wechat-article.html") as f:
html = f.read()
async with websockets.connect(ws_url) as ws:
await ws.send(json.dumps({"id":1,"method":"Runtime.evaluate","params":{
"expression": f"(() => {{ const e = document.querySelector('.ProseMirror'); e.innerHTML = {json.dumps(html)}; e.dispatchEvent(new Event('input', {{bubbles:true}})); return 'ok'; }})()",
"returnByValue": True
}}))
print(json.loads(await ws.recv())["result"]["result"]["value"])
asyncio.run(inject())
EOF
```
### Step 8: 一键排版
```
// 1. 在编辑器页点"一键排版"
browser(action="act", kind="evaluate", targetId=编辑器, fn="""
() => {
const all = document.querySelectorAll('span, div, button, a');
for (const el of all) {
if (el.textContent.trim() === '一键排版' && el.offsetParent !== null) {
el.click(); return 'clicked';
}
}
}
""")
// 2. 等待 → 用 tabs 找 articlestruct 标签页
// 3. 在排版页点"使用此排版"
browser(action="act", kind="click", ref=使用此排版ref, targetId=排版页)
// 4. 排版自动应用，回到编辑器
```
### Step 9: 保存草稿
```
browser(action="act", kind="evaluate", targetId=编辑器, fn="""
() => {
const btns = document.querySelectorAll('button');
for (const b of btns) {
if (b.textContent.includes('保存为草稿') && b.offsetParent !== null) {
b.click(); return 'clicked';
}
}
}
""")
```
---
## 🎨 Markdown → WeChat HTML 样式
| Markdown | HTML 样式 |
|----------|-----------|
| `# H1` | 22px bold, text-align center |
| `## H2` | 18px bold, border-left 4px #1a73e8 |
| `### H3` | 16px bold |
| `**bold**` | `<strong>` |
| `*italic*` | `<em>` |
| `` `code` `` | bg #f6f8fa, padding 2px 6px |
| `> quote` | border-left 3px #ddd, color #666 |
| `` | 居中, max-width 100% |
正文段落：`font-size:15px; color:#3f3f3f; line-height:1.75; margin:8px 0`
---
## 📦 输入输出
```yaml
输入:
article_path: string # Markdown 文章路径（必需）
author: string # 作者名（可选）
image_paths: list # 素材图片（可选，默认自动扫描 gzh/ 目录）
输出:
status: ok | error
draft_saved: true/false
appmsgid: string
title: string
images_uploaded: number
format_applied: boolean
cover_set: boolean
```
---
## 🏗️ 与其他 Skill 的关系
| Skill | 关系 |
|-------|------|
| `wemp-operator` | 全 API（统计/评论/粉丝/素材/群发） |
| `daily-gzh-content` | 公众号内容生成 |
| `wechat-toolkit` | 文章下载工具 |
---
## 更新日志
- **v3.2.0** (2026-04-22): 修复图片位置bug
- auto_insert_images: 检测到已有图片引用时跳过，不再重复插入
- 粘贴顺序修正: clipboard write → select placeholder → Ctrl+V（防止剪贴板写入破坏ProseMirror选区）
- 拆分 paste_image_at_selection 为 write_clipboard_image + paste_at_current_position
- **v3.1.0** (2026-04-18): 实战验证固化
- ✅ 确认一键排版不会丢失图片（需先粘贴图片让 ProseMirror 追踪）
- ✅ 封面必须在 HTML 注入前设置
- ✅ 移除排版后重新注入 HTML（不需要了）
- ✅ 精简 SKILL.md，删除过时陷阱和冗余流程
- 📋 9 步流程全部手动验证通过
- **v3.0.0** (2026-04-18): 大重写
- 自动扫描 gzh/ 目录图片
- 一键排版支持（articlestruct 新标签页）
- 封面从正文选择
- JPG→PNG 自动转换
- --no-format / --no-cover 标志