Lord1Egypt ClawHub Publisher — Skill 自动发布器
把本地 skill 目录一键发布到 clawhub.com，自动处理所有已知坑。
需要用户提供
| 参数 | 说明 | 示例 |
|---|---|---|
skill 目录路径 |
本地 skill 文件夹（必须包含 SKILL.md） | /root/.openclaw/workspace/skills/SKILL-xxx |
clawhub token |
格式 clh_xxx，clawhub.com → Profile → API Keys 获取 |
clh_7XoVic... |
slug |
URL 名称，全小写+连字符 | my-skill-name |
displayName |
展示名称 | My Skill — 一句话描述 |
tags |
逗号分隔（可选） | productivity,writing |
如果缺少任何必填项，只问缺少的那个，不要重复已知信息。
执行流程
Step 1：环境检查
# 确认 clawhub CLI 已安装
which clawhub || npm install -g clawhub
clawhub --version
# 确认 skill 目录存在且包含 SKILL.md
ls {skill_dir}/SKILL.md
Step 2：Patch CLI（如需要）
clawhub CLI 存在一个 bug：publish 时 payload 缺少 acceptLicenseTerms: true，服务端会返回 400。
检查并修复：
PUBLISH_JS=$(find /usr/local/lib /usr/lib -name "publish.js" -path "*/clawhub/*" 2>/dev/null | head -1)
# 检查是否已 patch
grep -q "acceptLicenseTerms" "$PUBLISH_JS" && echo "已 patch" || \
# 在 payload 构建处加入 acceptLicenseTerms: true
sed -i 's/skillName:/acceptLicenseTerms: true, skillName:/' "$PUBLISH_JS" && echo "patch 完成"
💡 patch 是幂等的，重复执行无害。
Step 3：查重（可选但推荐）
# 用 knot_skills 搜索是否已有同名/同功能 skill
knot_skills search "{slug关键词}"
如果发现完全重复的 skill，告知用户，询问是否继续（换 slug 或放弃）。
Step 4：执行发布
CLAWHUB_TOKEN={token} \
clawhub publish {skill_dir} \
--slug {slug} \
--name "{displayName}" \
--version {version:-1.0.0} \
--changelog "{changelog:-Initial release}" \
--tags "{tags:-latest}"
Step 5：错误处理
遇到以下错误时，按对应方案处理：
Error: Path must be a folder
→ 检查传入的是目录路径还是文件路径，修正后重试
slug already taken / 409
→ 在 slug 后加 -v2 或更具体的后缀，询问用户确认后重试
rate limit exceeded / 429
→ 使用 qqbot-cron skill 创建定时重试任务：
约 65 分钟后执行相同的 publish 命令
任务名：clawhub-publish-retry-{slug}
完成后通知用户
400 Bad Request（含 acceptLicenseTerms）
→ 重新执行 Step 2 的 patch，再重试
401 Unauthorized
→ token 无效或已过期，请用户在 clawhub.com 重新生成
Step 6：验证上架
knot_skills search "{slug}"
发布成功后回复：
✅ 发布成功：{displayName}
📦 slug：{slug}
🌐 https://clawhub.com/skills/{slug}
安装命令：clawhub install {slug}
快速调用示例
用户说：
"把 /workspace/skills/SKILL-my-tool 发布到 clawhub，token 是 clh_abc，slug 用 my-tool"
直接执行 Step 1-6，完成后汇报结果，无需逐步确认。