ClawHub 发版操作 SOP
发版前必做 5 步
CODEBLOCK0
账号矩阵（token / proxy / IP）
详见 INLINECODE0
速率限制规则（死规定）
- - 同一账号相邻发版间隔 ≥15 分钟（不能卡固定值，太像脚本）
- 不同账号可以串行（宿主机 config 文件只有一个，不能并行，否则 token 互相覆盖）
- 发版脚本
/Users/user/.openclaw/workspace-master/铁柱-workspace/scripts/publish-with-proxy.sh 已内置间隔检查，<15 分钟直接 exit 1
已知 CLI Bug
- 1.
whoami 返回缓存：永远返回第一次登录的账号名，不可信。验证归属必须 curl URL publish 必须加 --version：不读 frontmatter version 字段，必须显式传--name 参数必填：frontmatter displayName 不生效，必须用 INLINECODE6
macOS 双 config 路径（致命陷阱）
- - CLI 优先读 INLINECODE7
- 次级读 INLINECODE8
- INLINECODE9 环境变量在 CLI v0.9.0 中被完全忽略
- 切换账号必须同时更新两个路径
Downloads 数据查询
CODEBLOCK1
⚠️ trpc /api/trpc/skill.bySlug 和 REST /api/skills/<slug> 均已失效
SEO 策略
- - slug 含关键词 = 不可逾越的排名优势（score 3.0+ vs 品牌 slug 2.0）
- displayName 每个词都计入向量，宁可长不删词
- description 嵌入多语种关键词，一个 Skill 覆盖多语言搜索
- 触发词黑名单：
free trial / free credits / 100 credits（触发 spam 检测）
发布审核铁律
发布前检查：
- - API 域名必须是 INLINECODE15
- displayName 必须是带关键词的长名（≥50字符）
- 无触发词（grep "free trial\|free credits"）
- 与已发 Skill 差异度 > 40%
详细操作见 INLINECODE16
ClawHub 发版操作 SOP
发版前必做 5 步
bash
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=PROXYURL npx clawhub@latest publish
--slug --version 1.0.0 --name <长关键词名>
5. 发完验证归属（8秒后）
sleep 8 && curl -sL -x http://127.0.0.1:7897 -o /dev/null -w %{url_effective} https://clawhub.ai/skills/
账号矩阵（token / proxy / IP）
详见 references/accounts.md
速率限制规则（死规定）
- - 同一账号相邻发版间隔 ≥15 分钟（不能卡固定值，太像脚本）
- 不同账号可以串行（宿主机 config 文件只有一个，不能并行，否则 token 互相覆盖）
- 发版脚本 /Users/user/.openclaw/workspace-master/铁柱-workspace/scripts/publish-with-proxy.sh 已内置间隔检查，<15 分钟直接 exit 1
已知 CLI Bug
- 1. whoami 返回缓存：永远返回第一次登录的账号名，不可信。验证归属必须 curl URL
- publish 必须加 --version：不读 frontmatter version 字段，必须显式传
- --name 参数必填：frontmatter displayName 不生效，必须用 --name <全称>
macOS 双 config 路径（致命陷阱）
- - CLI 优先读 ~/Library/Application Support/clawhub/config.json
- 次级读 ~/.config/clawhub/config.json
- CLAWHUB_TOKEN 环境变量在 CLI v0.9.0 中被完全忽略
- 切换账号必须同时更新两个路径
Downloads 数据查询
bash
标准查询脚本（格式：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// \
| grep -o downloads:[0-9]* | head -1 | cut -d: -f2
⚠️ trpc /api/trpc/skill.bySlug 和 REST /api/skills/ 均已失效
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
