ClawHub Publish Doctor
Stabilize ClawHub publishing with preflight checks, safer publish commands, and post-publish verification that tolerates temporary registry states.
Quick workflow
- 1. Run preflight checks:
-
scripts/clawhub_preflight.sh
- 2. If login/browser issues appear, follow
references/error-map.md. - Publish with retry-aware verification:
-
scripts/clawhub_publish_safe.sh <skill_path> <slug> <name> <version> [changelog]
- 4. If inspect still fails, classify the error with
references/error-map.md before escalating.
Standard commands
Preflight
CODEBLOCK0
Login (token-based, headless-safe)
CODEBLOCK1
Safe publish
CODEBLOCK2
Manual inspect
CODEBLOCK3
Rules
- - Prefer token login in server/headless environments.
- Treat
inspect errors right after publish as potentially transient for a few minutes. - Verify with both CLI (
clawhub inspect) and web URL (/skills/<slug>). - Use canonical URLs:
- Skill:
https://clawhub.ai/skills/<slug>
- Owner/slug:
https://clawhub.ai/<handle>/<slug>
- User profile (if available): INLINECODE9
Resources
- -
references/error-map.md: quick diagnosis for common failure signatures. - INLINECODE11 : dependency + environment checks.
- INLINECODE12 : publish + retry verification wrapper.
ClawHub 发布医生
通过预检、更安全的发布命令以及能容忍临时注册表状态的发布后验证，稳定 ClawHub 发布流程。
快速工作流
- 1. 运行预检：
- scripts/clawhub_preflight.sh
- 2. 如果出现登录/浏览器问题，请参考 references/error-map.md。
- 使用带重试感知的验证进行发布：
- scripts/clawhub
publishsafe.sh <技能路径> <标识符> <名称> <版本> [更新日志]
- 4. 如果检查仍然失败，请在升级前使用 references/error-map.md 对错误进行分类。
标准命令
预检
bash
bash scripts/clawhub_preflight.sh
登录（基于令牌，无头环境安全）
bash
clawhub login --token
clawhub whoami
安全发布
bash
bash scripts/clawhubpublishsafe.sh ./my-skill my-skill 我的技能 1.0.0 初始版本
手动检查
bash
clawhub inspect my-skill --json
规则
- - 在服务器/无头环境中优先使用令牌登录。
- 将发布后立即出现的 inspect 错误视为可能几分钟内是暂时的。
- 同时使用 CLI（clawhub inspect）和网页 URL（/skills/<标识符>）进行验证。
- 使用规范 URL：
- 技能：https://clawhub.ai/skills/<标识符>
- 所有者/标识符：https://clawhub.ai/<用户名>/<标识符>
- 用户个人资料（如果可用）：https://clawhub.ai/users/<用户名>
资源
- - references/error-map.md：常见故障特征的快速诊断。
- scripts/clawhubpreflight.sh：依赖项 + 环境检查。
- scripts/clawhubpublish_safe.sh：发布 + 重试验证封装。
