GDWhisper ClawHub 发布助手
指导你将 skill 发布到 ClawHub.ai 的完整流程。
工作流程
准备 → 安装CLI → 登录 → 准备目录 → 发布 → 验证
1. 安装 CLI
npm install -g clawhub
验证安装：
clawhub --version
2. 登录
clawhub login --device
会输出一个链接和验证码，打开浏览器访问并输入即可。验证登录：
clawhub whoami
3. 准备 skill 目录
发布目录结构示例：
my-skill/
├── SKILL.md # 技能定义（必须有 name: 和 invoke:）
├── _meta.json # 元数据（slug, version）
└── scripts/ # 配套脚本（可选但推荐）
└── my-script.mjs
SKILL.md 示例：
---
name: my-skill
description: 技能描述
invoke: /my-skill
---
_meta.json 示例：
{
"slug": "my-skill",
"version": "1.0.0"
}
4. 发布
clawhub skill publish \
--slug my-skill \
--name "My Skill" \
--version 1.0.0 \
./path/to/skill-dir
必传参数：
| 参数 | 说明 | 示例 |
|---|---|---|
--slug |
全局唯一标识，安装时用这个 | my-skill |
--name |
展示名称，不传会乱生成 | "My Skill" |
--version |
语义化版本号 | 1.0.0 |
可选参数：
| 参数 | 说明 |
|---|---|
--changelog |
版本说明 |
--tags |
标签，默认 latest |
5. 验证
clawhub inspect my-skill
确认 Moderation: CLEAN 表示通过安全扫描。
已知问题
展示名自动生成 bug
不传 --name 时 CLI 会从 slug 自动生成奇怪的名字（如 fork-it 变成 Fork It Publish）。
解决：发布时始终传 --name。
漏传脚本文件
skill 目录中如果有 scripts/ 等附属文件，CLI 会全部打包上传。确保发布前目录结构完整。
版本已存在
同一版本不能重复发布。更新内容时递增版本号即可。
常用命令速查
| 命令 | 用途 |
|---|---|
clawhub search <query> |
搜索已有 skill |
clawhub inspect <slug> |
查看 skill 详情 |
clawhub install <slug> |
安装 skill |
clawhub list |
查看已安装 skill |
clawhub whoami |
查看当前登录 |
clawhub skill publish <path> |
发布 skill |
clawhub login --device |
设备码登录 |