clawhub-cli

约 1158 字大约 4 分钟

2026-03-05

提示

注：文档直接由英文版经LLM翻译得来，原文地址：clawhub/docs/cli.md · openclaw/clawhub

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）

命令

默认：打开浏览器访问 <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。