CLI

CLI 包：packages/clawdhub/ （发布为 clawhub，二进制文件：clawhub）。

在此仓库中，你可以通过以下包装脚本运行它：

bun clawhub --help

全局标志

• --workdir <dir>：工作目录（默认：当前工作目录；如果配置了 Clawdbot 工作区，则回退到该目录）
• --dir <dir>：工作目录下的安装目录（默认：skills）
• --site <url>：浏览器登录的基础 URL（默认：https：//clawhub.ai）
• --registry <url>：API 基础 URL（默认：自动发现，否则为 https：//clawhub.ai）
• --no-input：禁用提示

等效的环境变量：

• CLAWHUB_SITE（旧名 CLAWDHUB_SITE）
• CLAWHUB_REGISTRY（旧名 CLAWDHUB_REGISTRY）
• CLAWHUB_WORKDIR（旧名 CLAWDHUB_WORKDIR）

HTTP 代理

对于位于公司代理或受限网络后面的系统，CLI 会遵守标准的 HTTP 代理环境变量：

• HTTPS_PROXY / https_proxy
• HTTP_PROXY / http_proxy
• NO_PROXY / no_proxy

当设置了这些变量中的任何一个时，CLI 会通过指定的代理路由出站请求。HTTPS_PROXY 用于 HTTPS 请求，HTTP_PROXY 用于纯 HTTP 请求。NO_PROXY / no_proxy 用于绕过特定主机或域的代理。

这在直接出站连接被阻止的系统上是必需的（例如 Docker 容器、仅通过代理上网的 Hetzner VPS、公司防火墙）。

示例：

export HTTPS_PROXY=http：//proxy.example.com：3128
export NO_PROXY=localhost,127.0.0.1
clawhub search "my query"

当未设置代理变量时，行为不变（直接连接）。

配置文件

存储你的 API 令牌 + 缓存的 registry URL。

• macOS： ~/Library/Application Support/clawhub/config.json
• 覆盖： CLAWHUB_CONFIG_PATH（旧名 CLAWDHUB_CONFIG_PATH）

命令

login / auth login

• 默认：打开浏览器访问 <site>/cli/auth，并通过环回回调完成。
• 无头模式： clawhub login --token clh_...

whoami

• 通过 /api/v1/whoami 验证存储的令牌。

star <slug> / unstar <slug>

• 添加/移除你高亮的 skill。
• 调用 POST /api/v1/stars/<slug> 和 DELETE /api/v1/stars/<slug>。
• --yes 跳过确认。

search <query...>

• 调用 /api/v1/search？q=...。

explore

• 通过 /api/v1/skills？limit=... 列出最新更新的 skills（按 updatedAt 降序排序）。
• 标志：
  • --limit <n> （1-200， 默认： 25）
  • --sort newest|downloads|rating|installs|installsAllTime|trending（默认： newest）
  • --json（机器可读的输出）
• 输出： <slug> v<version> <age> <summary>（摘要截断为 50 个字符）。

inspect <slug>

• 获取 skill 元数据和版本文件，但不安装。
• --version <version>：检查特定版本（默认：最新）。
• --tag <tag>：检查标记的版本（例如 latest）。
• --versions：列出版本历史（第一页）。
• --limit <n>：要列出的最大版本数（1-200）。
• --files：列出所选版本的文件。
• --file <path>：获取原始文件内容（仅限文本文件；200KB 限制）。
• --json：机器可读的输出。

install <slug>

• 通过 /api/v1/skills/<slug> 解析最新版本。
• 通过 /api/v1/download 下载 zip 文件。
• 解压到 <workdir>/<dir>/<slug>。
• 写入：
  • <workdir>/.clawhub/lock.json（旧名 .clawdhub）
  • <skill>/.clawhub/origin.json（旧名 .clawdhub）

uninstall <slug>

• 移除 <workdir>/<dir>/<slug> 并删除锁文件中的条目。
• 交互式：请求确认。
• 非交互式（--no-input）：需要 --yes。

list

• 读取 <workdir>/.clawhub/lock.json（旧名 .clawdhub）。

update [slug] / update --all

• 从本地文件计算指纹。
• 如果指纹与已知版本匹配：不提示。
• 如果指纹不匹配：
  • 默认拒绝
  • 使用 --force 覆盖（或提示，如果是交互式）

publish <path>

• 通过 POST /api/v1/skills （multipart） 发布。
• 需要 semver： --version 1.2.3。

delete <slug>

• 软删除一个 skill（所有者、版主或管理员）。
• 调用 DELETE /api/v1/skills/{slug}。
• --yes 跳过确认。

undelete <slug>

• 恢复一个隐藏的 skill（所有者、版主或管理员）。
• 调用 POST /api/v1/skills/{slug}/undelete。
• --yes 跳过确认。

hide <slug>

• 隐藏一个 skill（所有者、版主或管理员）。
• delete 的别名。

unhide <slug>

• 取消隐藏一个 skill（所有者、版主或管理员）。
• undelete 的别名。

ban-user <handleOrId>

• 封禁用户并删除其拥有的 skills（仅限版主/管理员）。
• 调用 POST /api/v1/users/ban。
• --id 将参数视为用户 ID 而非 handle。
• --fuzzy 通过模糊用户搜索解析 handle（仅限管理员）。
• --reason 记录可选的封禁原因。
• --yes 跳过确认。

set-role <handleOrId> <role>

• 更改用户角色（仅限管理员）。
• 调用 POST /api/v1/users/role。
• --id 将参数视为用户 ID 而非 handle。
• --fuzzy 通过模糊用户搜索解析 handle（仅限管理员）。
• --yes 跳过确认。

sync

• 扫描本地 skill 文件夹并发布新的/已更改的。
• 根目录可以是任何文件夹：一个 skills 目录或一个包含 SKILL.md 的单个 skill 文件夹。
• 当存在 ~/.clawdbot/clawdbot.json 时，自动添加 Clawdbot skill 根目录：
  • agent.workspace/skills（主 agent）
  • routing.agents.*.workspace/skills（每个 agent）
  • ~/.clawdbot/skills（共享）
  • skills.load.extraDirs（共享包）
• 遵循 CLAWDBOT_CONFIG_PATH / CLAWDBOT_STATE_DIR 和 OPENCLAW_CONFIG_PATH / OPENCLAW_STATE_DIR。
• 标志：
  • --root <dir...> 额外的扫描根目录
  • --all 不提示直接上传
  • --dry-run 仅显示计划
  • --bump patch|minor|major（默认： patch）
  • --changelog <text>（非交互式）
  • --tags a，b，c（默认： latest）
  • --concurrency <n>（默认： 4）

遥测：

• 登录后，在 sync 期间发送，除非设置了 CLAWHUB_DISABLE_TELEMETRY=1（旧名 CLAWDHUB_DISABLE_TELEMETRY=1）。
• 详细信息： docs/telemetry.md。