ClawHub 发版操作 SOP

发版前必做 5 步

# 1. 确认当前 token
cat "~/Library/Application Support/clawhub/config.json"

# 2. 同时写入两个 config 路径（缺一不可）
echo '{"registry":"https://clawhub.ai","token":"TOKEN"}' > ~/Library/Application\ Support/clawhub/config.json
echo '{"registry":"https://clawhub.ai","token":"TOKEN"}' > ~/.config/clawhub/config.json

# 3. 确认出口 IP（必须与账号绑定 IP 一致）
curl -s --proxy "PROXY_URL" https://api.ipify.org

# 4. 发版（必须加 --name 和 --version 参数）
HTTPS_PROXY=PROXY_URL npx clawhub@latest publish \x3Cpath> --slug \x3Cslug> --version 1.0.0 --name "\x3C长关键词名>"

# 5. 发完验证归属（8秒后）
sleep 8 && curl -sL -x http://127.0.0.1:7897 -o /dev/null -w "%{url_effective}" "https://clawhub.ai/skills/\x3Cslug>"

账号矩阵（token / proxy / IP）

详见 references/accounts.md

速率限制规则（死规定）

• 同一账号相邻发版间隔 ≥15 分钟（不能卡固定值，太像脚本）
• 不同账号可以串行（宿主机 config 文件只有一个，不能并行，否则 token 互相覆盖）
• 发版脚本 /Users/user/.openclaw/workspace-master/铁柱-workspace/scripts/publish-with-proxy.sh 已内置间隔检查，\x3C15 分钟直接 exit 1

已知 CLI Bug

1. whoami 返回缓存：永远返回第一次登录的账号名，不可信。验证归属必须 curl URL
2. publish 必须加 --version：不读 frontmatter version 字段，必须显式传
3. --name 参数必填：frontmatter displayName 不生效，必须用 --name "\x3C全称>"

macOS 双 config 路径（致命陷阱）

• CLI 优先读 ~/Library/Application Support/clawhub/config.json
• 次级读 ~/.config/clawhub/config.json
• CLAWHUB_TOKEN 环境变量在 CLI v0.9.0 中被完全忽略
• 切换账号必须同时更新两个路径

Downloads 数据查询

# 标准查询脚本（格式：downloads:N，无引号无空格）
bash /Users/user/.openclaw/workspace-master/shared/scripts/clawhub-downloads.sh \
  nemo-video nemo-edit nemo-subtitle ...

# 手动单个查询
curl -sL -x http://127.0.0.1:7897 "https://clawhub.ai/\x3Caccount>/\x3Cslug>" \
  | grep -o 'downloads:[0-9]*' | head -1 | cut -d: -f2

⚠️ trpc /api/trpc/skill.bySlug 和 REST /api/skills/\x3Cslug> 均已失效

SEO 策略

• slug 含关键词 = 不可逾越的排名优势（score 3.0+ vs 品牌 slug 2.0）
• displayName 每个词都计入向量，宁可长不删词
• description 嵌入多语种关键词，一个 Skill 覆盖多语言搜索
• 触发词黑名单：free trial / free credits / 100 credits（触发 spam 检测）

发布审核铁律

发布前检查：

• API 域名必须是 mega-api-prod.nemovideo.ai
• displayName 必须是带关键词的长名（≥50字符）
• 无触发词（grep "free trial|free credits"）
• 与已发 Skill 差异度 > 40%

详细操作见 references/publish-checklist.md