| name | agent-publisher |
| description | 微信公众号发布工具：本地 Markdown/HTML 上传到文章管理，自动处理本地图片并渲染（wenyan），再按公众号账号发布到微信草稿箱。支持按 account 发布，避免与 agent_id 语义混淆。 |
| metadata | {"openclaw":{"emoji":"�","requires":{"bins":["uv"]},"primaryEnv":"AP_EMAIL"}} |
Agent Publisher — 微信公众号发布工具
本地编辑好内容，通过 CLI 上传、美化排版、发布到微信草稿箱。
前置条件
- Agent Publisher 后端运行中（默认
http://localhost:9099）
- 邮箱已加入白名单
- 已安装
uv
环境变量
| 变量 | 说明 | 默认值 |
|---|
AP_URL | 后端地址 | http://localhost:9099 |
AP_EMAIL | 认证邮箱 | — |
核心工作流
1. 认证
uv run {baseDir}/scripts/agent_publisher.py auth --email "you@example.com"
2. 绑定公众号（首次使用）
uv run {baseDir}/scripts/agent_publisher.py create-account --name "我的公众号" --appid wx123 --appsecret sec456
获取 AppID/AppSecret：登录 https://mp.weixin.qq.com → 设置与开发 → 基本配置。
3. 上传文章
上传文章时可二选一：
- 按
agent_id 归档（适合已有内容生产 Agent）
- 按
account_id 归档（适合仅做手动上传/发布，不关心 Agent 概念）
如果使用 --account-id，系统会自动选择该公众号下的 Agent；若不存在会自动创建一个“手动发布”Agent。
从 Markdown 文件创建（推荐，自动通过 wenyan 引擎转为精美排版）：
uv run {baseDir}/scripts/agent_publisher.py create-article --agent-id 1 --title "文章标题" --content-file ./article.md
uv run {baseDir}/scripts/agent_publisher.py create-article --account-id 1 --title "文章标题" --content-file ./article.md
强烈推荐使用 Markdown：Markdown 文件会通过 wenyan 渲染引擎自动转为精美排版，
并支持 beautify 主题切换和 ai-beautify 增强美化。HTML 文件无法使用这些功能。
Markdown 内的本地图片（如 ./images/a.png）会自动上传到素材库并改写为可发布链接。
从 HTML 文件创建（不推荐，仅向后兼容）：
uv run {baseDir}/scripts/agent_publisher.py create-article --agent-id 1 --title "文章标题" --content-file ./article.html --force-html
uv run {baseDir}/scripts/agent_publisher.py create-article --account-id 1 --title "文章标题" --content-file ./article.html --force-html
设置封面图（素材库 ID 或外部 URL）：
uv run {baseDir}/scripts/agent_publisher.py create-article --agent-id 1 --title "标题" --content-file ./article.md --cover media:5
uv run {baseDir}/scripts/agent_publisher.py create-article --agent-id 1 --title "标题" --content-file ./article.md --cover "https://example.com/cover.jpg"
4. 排版美化
wenyan 主题美化（8 个内置主题，纯本地渲染）：
uv run {baseDir}/scripts/agent_publisher.py beautify <article_id>
uv run {baseDir}/scripts/agent_publisher.py beautify <article_id> --theme orangeheart
可选主题：default、orangeheart、rainbow、lapis、pie、maize、purple、phycat
AI 增强美化（基于 wenyan 排版，LLM 做装饰增强）：
uv run {baseDir}/scripts/agent_publisher.py ai-beautify <article_id>
uv run {baseDir}/scripts/agent_publisher.py ai-beautify <article_id> --style-hint "科技极简风，大量留白"
uv run {baseDir}/scripts/agent_publisher.py ai-beautify <article_id> --theme orangeheart --style-hint "暖色调"
推荐工作流：先 beautify 选主题 → 再 ai-beautify 做精细调整。
ai-beautify 会自动先用 wenyan 渲染基底，再让 AI 在此基础上增强，不会从零重建排版。
5. 发布到微信
uv run {baseDir}/scripts/agent_publisher.py publish <article_id>
uv run {baseDir}/scripts/agent_publisher.py publish <article_id> --target-account-id 1
uv run {baseDir}/scripts/agent_publisher.py publish <article_id> --target-account-id 1 --target-account-id 2
发布后文章进入微信草稿箱，在微信后台确认群发。
publish 基于 article_id 执行，发布目标由 --target-account-id 决定；
不传时默认发布到文章归属 Agent 绑定的公众号。
编辑后重新同步到草稿箱：
uv run {baseDir}/scripts/agent_publisher.py edit-article <article_id> --content-file ./updated.md
uv run {baseDir}/scripts/agent_publisher.py beautify <article_id> --theme lapis
uv run {baseDir}/scripts/agent_publisher.py sync-article <article_id>
uv run {baseDir}/scripts/agent_publisher.py sync-article <article_id> --target-account-id 1
命令速查
以下省略前缀 uv run {baseDir}/scripts/agent_publisher.py。
认证
| 命令 | 说明 |
|---|
auth --email <email> | 邮箱认证 |
whoami | 查看当前身份 |
公众号
| 命令 | 说明 |
|---|
accounts | 列出我的公众号 |
agents | 列出我的 Agent（可选） |
create-account --name <名称> --appid <ID> --appsecret <Secret> | 绑定公众号 |
文章（核心）
| 命令 | 说明 |
|---|
create-article (--agent-id <ID> | --account-id <ID>) --title <标题> --content-file <file> | 上传文章（推荐 .md） |
edit-article <ID> --title/--content-file/--cover | 编辑文章 |
article <ID> | 查看文章详情 |
articles [--status draft] | 列出文章 |
美化排版
| 命令 | 说明 |
|---|
beautify <ID> [--theme orangeheart] | wenyan 主题排版 |
ai-beautify <ID> [--theme lapis] [--style-hint "风格描述"] | AI 增强美化（基于 wenyan 基底） |
发布
| 命令 | 说明 |
|---|
publish <article_id> [--target-account-id <ID> ...] | 发布到微信草稿箱 |
sync-article <article_id> [--target-account-id <ID> ...] | 同步编辑到草稿箱 |
batch-publish <id1> <id2> ... [--target-account-id <ID> ...] | 批量发布（管理员） |
素材库
| 命令 | 说明 |
|---|
media | 列出素材 |
upload-media <文件路径> | 上传图片 |
数据
| 命令 | 说明 |
|---|
followers <account_id> | 粉丝趋势 |
article-stats <account_id> | 阅读数据 |
注意事项
- Token 有效期 30 天，过期重新
auth
create-article 需要 --agent-id 或 --account-id 二选一- 若只想“上传文章并发布到某公众号”，优先用
--account-id + publish --target-account-id
- 文章内容建议使用 Markdown 格式，wenyan 会自动渲染为微信适配的精美 HTML
- HTML 文件虽然支持，但无法使用 beautify 主题美化和 AI 增强美化
- Markdown 中本地图片路径会在上传时自动入库并改写，确保后续发布可上传到草稿箱
- 封面图支持
media:<id>（素材库 ID）或 http(s):// URL
- AppSecret 敏感信息不会被打印
