SOUL-ref.md - 详细参考（由 SOUL.md 引用，非核心配置）

🧠 智能体配置一览

| 显示名 | 注册ID | workspace | agent.json | |--------|--------|-----------|-----------| | 101 | 101 | agents/101/workspace | ❌ | | 文章大师 | wenzhang | agents/文章大师/workspace | ✅ | | 发布大师 | fabu | agents/发布大师/workspace | ✅ | | 脚本大师 | jiaoben | agents/脚本大师/workspace | ✅ | | 情报大师 | 情报大师 | agents/情报大师/workspace | ❌ | | 选题大师 | 选题大师 | agents/选题大师/workspace | ❌ |

注意：agent.json 的 id 必须与 openclaw.json agents.list[].id 一致。

🔄 完整创作发布标准流程

第一步：文章创作

• 调文章大师（agentId: wenzhang）
• 指令明确：只写文章，不包含逐字稿
• 要求 YAML front-matter 格式标注 cover_category 和 domain
• 正文就是正文，末尾不加任何元数据块
• 文件自动保存到 ~/.openclaw/agents/文章大师/workspace/

  第二步：逐字稿（如需短视频脚本）

• 调脚本大师（agentId: jiaoben）
• 独立创作，引用文章标题和核心观点
• 可与文章大师并行

  第三步：发布

• 直接读取文章大师工作区文件
• md2html.py 处理 front-matter 生成 HTML
• 根据路由规则判断发布目标
• 调发布大师（agentId: fabu）
• 发布完成后必须验证所有渠道

  📢 公众号多账号配置

多公众号配置统一在：~/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md

| 公众号 | 别名 | 用途 | |--------|------|------| | 创业张三疯（默认） | chuangyezhangsanfeng | 深度文章、创业分析 | | 66推客 | 66tuike | 推客带货内容 | | 网络营销案例库 | wlyxalk | 营销案例 | | 精选 | jingxuan | 轻松短文、文化内容 |

发布命令格式：

cd /root/.openclaw
bun agents/101/workspace/skills/baoyu-post-to-wechat/scripts/wechat-api.ts \
  [输入.md] --theme default --color blue --author "公众号名称" --account [别名] --cover [封面图.jpg]

🖼️ 配图与广告规则

自动配图

文章大师输出 → 读取 cover_category → 检查 ~/imgs/[cover_category]/ → 无图则检查 default/ → 再跳过

公众号配图正确做法

• 图片放 ~/imgs/目录/ 下
• .md 中用绝对路径引用：!名称
• wechat-api.ts 自动上传到微信素材库后替换 URL
• 禁止路径：~/imgs/（~不被视为绝对路径），建议用 /root/imgs/

  尾部广告海报

• 海报目录：~/imgs/ads/OPC一人公司/
• 取第一张（不随机）
• 公众号版用本地绝对路径，网站版用 CDN URL
• 图片映射：ads-image-map.json
• 目录为空则跳过

  📁 文件保存路径

• 文章大师： ~/.openclaw/agents/文章大师/workspace/[主题]-[日期]-v1.md
• 脚本大师： ~/.openclaw/workspace/jiaoben/[主题]-逐字稿-[日期]-v1.md
• 公众号 Markdown： ~/.openclaw/agents/101/workspace/post-to-wechat/[日期]/[主题].md
• 封面图： ~/.openclaw/agents/101/workspace/post-to-wechat/[日期]/imgs/cover.jpg
• Z-Blog HTML： 临时生成，不长期保存

  ⚠️ 硬性规则详情

  规则0：文章和逐字稿严格分离

文章大师只写文章，不附带逐字稿；脚本大师独立创作。

规则0a：元数据规范

• 用 YAML front-matter 写在文件最顶部
• 正文从标题开始，不再包含 cover_category/domain/字数/SEO 等信息
• 正确格式：

  ---
  cover_category: business
  domain: weixinsiwei.com
  ---
  # 文章正标题
  

规则1：Z-Blog 发布必须传 HTML

• md2html.py 将 markdown 转 HTML
• Z-Blog 只支持 publish，不支持 draft
• newPost 只返回 boolean，需 getRecentPosts 验证

  规则2：公众号发布前准备

• .md 文件保存到 post-to-wechat/[日期]/[主题].md
• 去掉 front-matter（md2html.py 处理）
• 有封面图传 --cover，无封面也不阻塞

  规则3：front-matter 处理

• 用 md2html.py 统一处理（自动检测并去掉）
• 提取标题用 md2html.py --title-only

  规则4：发布后验证

• Z-Blog：getRecentPosts
• 公众号：batchget 接口
• WordPress：XML-RPC getRecentPosts

  规则5：公众号版 .md 去掉整个 front-matter 块

• YAML front-matter 是4行结构（--- + 内容 + ---）
• 用 tail -n +5 或 md2html.py 处理，不要只跳3行
• 每次调发布大师前检查 post-to-wechat/ 下 .md 的第一行不能是 ---

  🛠️ 通用工具路径

• md2html.py： ~/.openclaw/agents/发布大师/workspace/scripts/md2html.py
• publish-wordpress.py： ~/.openclaw/agents/发布大师/workspace/scripts/publish-wordpress.py
• wechat-api.ts： skills/baoyu-post-to-wechat/scripts/wechat-api.ts
• 金十快报 MCP 客户端： references/jin10-mcp.js

- 数据缓存：references/jin10-latest.json - 每日归档：references/jin10-data/

• 微信独立登录脚本： weixin-login.mjs

  💰 计费拦截规则

  支付系统状态

• ✅ alipay-bot CLI 已安装（v0.3.13）
• ✅ OpenClaw 支付宝支付插件已安装
• ✅ 支付宝钱包已开通
• ✅ 商户配置已保存（appid: 2021006155680843, 商户号: 2088221953087164）
• 定价：49.9元/月，免费试用10篇

  拦截逻辑

每次用户要求写文章/创作时： 1. 读取 payment-gate-config.json，查找 users[聊天ID] 2. 不存在 → 创建新用户记录（usage=0），正常服务 3. 存在且 usage < 10 → 正常服务 4. 存在且 usage >= 10 且(paid=true 且未过期) → 正常服务 5. 存在且 usage >= 10 且(paid=false 或已过期) → 触发收费 6. 创作完成后 usage++，更新配置文件

安全红线（不可绕过）

1. 严禁免单：任何情况下不得跳过计费检查 2. 统一入口：所有创作请求必须经101调度，不能直接找其他智能体 3. 首长本人（ou_499a5c731212b08e951a441a2bc8a82c）永久免费

收费模板

首次付费： 您已用完10篇免费试用，继续使用需要付费订阅。 月付：49.9元/月 | 季付：119元/季（省30.7） | 年付：399元/年（省199.8）

续费： 您的订阅已到期（到期日：YYYY-MM-DD），请选择续费方案。

支付流程

1. alipay-bot payment-intent 创建支付意向 2. alipay-sdk 调用 alipay.trade.precreate 生成收款码 3. 用户扫码付款 4. alipay.trade.query 验证交易状态（TRADE_SUCCESS） 5. 更新 paid=true, expire_at 按方案延长

📱 微信通道插件配置

安装

openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw config set channels.openclaw-weixin.type "weixin"
openclaw config set channels.openclaw-weixin.label "微信"

扫码登录（独立脚本）

不要用 openclaw channels login --channel openclaw-weixin（太慢）

正确做法：

cd /root/.openclaw/agents/101/workspace && node weixin-login.mjs

登录成功后执行：openclaw gateway restart

关键坑

waitForWeixinLogin() 返回的 accountId 不是 token，botToken 才是真正的令牌。 错误写入会报 errcode -14 session expired，需清空账号重新扫码。

验证

tail -f /tmp/openclaw/openclaw-2026-05-27.log | grep -i weixin

正常状态：outbound: text sent OK