diff --git a/docs/zh-CN/tools/clawhub.md b/docs/zh-CN/tools/clawhub.md index 090e00aba..5f3c736c5 100644 --- a/docs/zh-CN/tools/clawhub.md +++ b/docs/zh-CN/tools/clawhub.md @@ -1,24 +1,24 @@ --- read_when: - - 搜索、安装或更新 Skills 或插件。 - - 将 Skills 或插件发布到注册表。 - - 配置 clawhub CLI 或其环境变量覆盖项。 + - 搜索、安装或更新 Skills 或插件 + - 将 Skills 或插件发布到注册表 + - 配置 `clawhub` CLI 或其环境变量覆盖项 sidebarTitle: ClawHub -summary: ClawHub：用于 OpenClaw Skills 和插件的公共注册表、原生安装流程，以及 clawhub CLI +summary: ClawHub：用于 OpenClaw Skills 和插件的公共注册表、原生安装流程以及 `clawhub` CLI title: ClawHub x-i18n: - generated_at: "2026-04-27T09:30:20Z" + generated_at: "2026-04-27T19:30:28Z" model: gpt-5.4 provider: openai - source_hash: 71b0666f6013ef722bfa218c41f0b8f00ec056d5e39924193d8aaa8866203f46 + source_hash: c67e20db6d267c9c256c3f72badc76b5f92e79b84c8c0dc3b6f13769de50c3e4 source_path: tools/clawhub.md workflow: 15 --- -ClawHub 是 **OpenClaw Skills 和插件**的公共注册表。 +ClawHub 是 **OpenClaw Skills 和插件** 的公共注册表。 -- 使用原生 `openclaw` 命令来搜索、安装和更新 Skills，并从 ClawHub 安装插件。 -- 使用单独的 `clawhub` CLI 进行注册表认证、发布、删除/恢复删除和同步工作流。 +- 使用原生 `openclaw` 命令来搜索、安装和更新 Skills，以及从 ClawHub 安装插件。 +- 使用单独的 `clawhub` CLI 进行注册表认证、发布、删除/恢复删除以及同步工作流。 网站：[clawhub.ai](https://clawhub.ai) @@ -36,14 +36,15 @@ ClawHub 是 **OpenClaw Skills 和插件**的公共注册表。 ``` - 启动一个新的 OpenClaw 会话——它会加载这个新 Skill。 + 启动一个新的 OpenClaw 会话——它会自动加载新 Skill。 - 对于需要注册表认证的工作流（发布、同步、管理），请安装单独的 `clawhub` CLI： + 对于需要注册表认证的工作流（发布、同步、管理），请安装 + 单独的 `clawhub` CLI： ```bash npm i -g clawhub - # 或 + # or pnpm add -g clawhub ``` @@ -60,7 +61,7 @@ ClawHub 是 **OpenClaw Skills 和插件**的公共注册表。 openclaw skills update --all ``` - 原生 `openclaw` 命令会安装到你当前的工作区，并持久化源元数据，这样后续 `update` 调用就可以继续保持在 ClawHub 上。 + 原生 `openclaw` 命令会安装到你当前的工作区中，并持久化保存来源元数据，以便后续的 `update` 调用可以继续从 ClawHub 获取更新。 @@ -69,48 +70,48 @@ ClawHub 是 **OpenClaw Skills 和插件**的公共注册表。 openclaw plugins update --all ``` - 裸 npm-safe 插件 spec 也会在 npm 之前先尝试 ClawHub： + 纯 npm 安全的插件规格在尝试 npm 之前，也会先尝试从 ClawHub 解析： ```bash openclaw plugins install openclaw-codex-app-server ``` - 当你希望仅通过 npm 解析，而不进行 ClawHub 查找时，请使用 `npm:`： + 当你希望仅通过 npm 解析、而不进行 ClawHub 查询时，请使用 `npm:`： ```bash openclaw plugins install npm:openclaw-codex-app-server ``` - 插件安装会在运行归档安装之前验证声明的 `pluginApi` 和 `minGatewayVersion` 兼容性，因此不兼容的宿主会及早以失败关闭的方式终止，而不是部分安装该包。 + 插件安装会在归档安装运行之前验证声明的 `pluginApi` 和 `minGatewayVersion` 兼容性，因此不兼容的宿主会及早以封闭失败方式终止，而不是在软件包部分安装后才失败。 -`openclaw plugins install clawhub:...` 仅接受可安装的插件系列。如果某个 ClawHub 包实际上是 Skill，OpenClaw 会停止，并改为提示你使用 `openclaw skills install `。 +`openclaw plugins install clawhub:...` 只接受可安装的插件系列。如果某个 ClawHub 软件包实际上是一个 Skill，OpenClaw 会停止，并改为提示你使用 `openclaw skills install `。 -匿名 ClawHub 插件安装对私有包也会以失败关闭的方式终止。社区或其他非官方渠道仍然可以安装，但 OpenClaw 会发出警告，以便运维人员在启用前审查其来源和验证情况。 +匿名安装 ClawHub 插件时，私有软件包同样会以封闭失败方式终止。社区或其他非官方渠道仍然可以安装，但 OpenClaw 会发出警告，以便运维人员在启用它们之前审查来源和验证情况。 ## ClawHub 是什么 - OpenClaw Skills 和插件的公共注册表。 -- Skills 捆绑包和元数据的版本化存储。 -- 用于搜索、标签和使用信号的发现入口。 +- 用于存储 Skill 打包内容和元数据的版本化仓库。 +- 用于搜索、标签和使用信号的发现界面。 -一个典型的 Skill 是一组带版本的文件捆绑包，通常包括： +一个典型的 Skill 是一个带版本的文件打包，其中包括： -- 包含主要说明和用法的 `SKILL.md` 文件。 +- 一个 `SKILL.md` 文件，包含主要说明和用法。 - Skill 使用的可选配置、脚本或支持文件。 -- 诸如标签、摘要和安装要求等元数据。 +- 诸如标签、摘要和安装要求之类的元数据。 -ClawHub 使用元数据来支持发现能力，并安全地公开 Skill 能力。注册表会跟踪使用信号（收藏、下载），以改进排序和可见性。每次发布都会创建一个新的 semver 版本，注册表会保留版本历史，以便用户审计变更。 +ClawHub 使用元数据来支持发现能力，并安全地公开 Skill 功能。注册表会跟踪使用信号（星标、下载量）以改进排序和可见性。每次发布都会创建一个新的 semver 版本，注册表会保留版本历史，以便用户审计变更。 ## 工作区和 Skill 加载 -单独的 `clawhub` CLI 还会将 Skills 安装到你当前工作目录下的 `./skills` 中。如果已配置 OpenClaw 工作区，`clawhub` 会回退到该工作区，除非你使用 `--workdir`（或 `CLAWHUB_WORKDIR`）进行覆盖。OpenClaw 会从 `/skills` 加载工作区 Skills，并在**下一次**会话中拾取它们。 +单独的 `clawhub` CLI 还会将 Skills 安装到当前工作目录下的 `./skills` 中。如果配置了 OpenClaw 工作区，除非你使用 `--workdir`（或 `CLAWHUB_WORKDIR`）覆盖，否则 `clawhub` 会回退到该工作区。OpenClaw 会从 `/skills` 加载工作区 Skills，并在**下一次**会话中将其加载。 -如果你已经在使用 `~/.openclaw/skills` 或内置 Skills，则工作区 Skills 具有更高优先级。关于 Skills 如何加载、共享和受控的更多细节，请参阅 [Skills](/zh-CN/tools/skills)。 +如果你已经在使用 `~/.openclaw/skills` 或内置 Skills，则工作区 Skills 具有更高优先级。有关 Skills 如何加载、共享和受控的更多细节，请参见 [Skills](/zh-CN/tools/skills)。 ## 服务功能 @@ -119,25 +120,24 @@ ClawHub 使用元数据来支持发现能力，并安全地公开 Skill 能力 | 公开浏览 | Skills 及其 `SKILL.md` 内容可公开查看。 | | 搜索 | 由嵌入驱动（向量搜索），而不只是关键词。 | | 版本管理 | Semver、变更日志和标签（包括 `latest`）。 | -| 下载 | 每个版本提供 Zip。 | -| 收藏和评论 | 社区反馈。 | +| 下载 | 每个版本提供 Zip 包。 | +| 星标和评论 | 社区反馈。 | | 审核 | 审批和审计。 | -| 适合 CLI 的 API | 适用于自动化和脚本。 | +| 适用于 CLI 的 API | 适合自动化和脚本编写。 | ## 安全和审核 -ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitHub -账号必须**至少注册一周**。这可以减缓滥用行为，同时不阻碍真实贡献者。 +ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitHub 账号必须**至少注册满一周**。这样可以减缓滥用行为，同时不阻碍合法贡献者。 - - 任何已登录用户都可以举报一个 Skill。 - - 举报原因是必填的，并会被记录。 - - 每个用户最多可同时拥有 20 条活跃举报。 - - 被超过 3 个不同用户举报的 Skills 默认会被自动隐藏。 + - 任何已登录用户都可以举报 Skill。 + - 必须填写并记录举报原因。 + - 每位用户同时最多可有 20 个有效举报。 + - 被超过 3 位不同用户举报的 Skills 默认会被自动隐藏。 - - 审核员可以查看已隐藏的 Skills、取消隐藏、删除它们，或封禁用户。 + - 审核员可以查看隐藏的 Skills、取消隐藏、删除它们，或封禁用户。 - 滥用举报功能可能导致账号被封禁。 - 有兴趣成为审核员？请到 OpenClaw Discord 中联系审核员或维护者。 @@ -145,7 +145,7 @@ ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitH ## ClawHub CLI -你只在需要注册表认证的工作流（如发布/同步）时才需要它。 +你只在需要注册表认证的工作流（例如发布/同步）时才需要它。 ### 全局选项 @@ -162,7 +162,7 @@ ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitH 注册表 API 基础 URL。 - 禁用提示（非交互式）。 + 禁用提示（非交互模式）。 打印 CLI 版本。 @@ -171,9 +171,9 @@ ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitH ### 命令 - + ```bash - clawhub login # 浏览器流程 + clawhub login # browser flow clawhub login --token clawhub logout clawhub whoami @@ -181,8 +181,8 @@ ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitH 登录选项： - - `--token ` — 粘贴一个 API token。 - - `--label @@ -191,10 +191,31 @@ ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitH clawhub search "query" ``` + 搜索 Skills。若要发现插件/软件包，请使用 `clawhub package explore`。 + - `--limit ` — 最大结果数。 - + + ```bash + clawhub package explore --family code-plugin + clawhub package explore "episodic-claw" --family code-plugin + clawhub package inspect episodic-claw + ``` + + `package explore` 和 `package inspect` 是 ClawHub CLI 中用于插件/软件包发现和元数据检查的界面。原生 OpenClaw 安装仍使用 `openclaw plugins install clawhub:`。 + + 选项： + + - `--family skill|code-plugin|bundle-plugin` — 按软件包系列筛选。 + - `--official` — 仅显示官方软件包。 + - `--executes-code` — 仅显示会执行代码的软件包。 + - `--version ` / `--tag ` — 检查特定软件包版本。 + - `--versions`, `--files`, `--file ` — 检查软件包历史和文件。 + - `--json` — 机器可读输出。 + + + ```bash clawhub install clawhub update @@ -204,8 +225,8 @@ ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitH 选项： - - `--version ` — 安装或更新到指定版本（在 `update` 中仅支持单个 slug）。 - - `--force` — 如果文件夹已存在，或者本地文件不匹配任何已发布版本，则覆盖。 + - `--version ` — 安装或更新到特定版本（`update` 时仅支持单个 slug）。 + - `--force` — 如果文件夹已存在，或本地文件与任何已发布版本都不匹配，则覆盖。 - `clawhub list` 会读取 `.clawhub/lock.json`。 @@ -228,13 +249,13 @@ ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitH clawhub package publish ``` - `` 可以是本地文件夹、`owner/repo`、`owner/repo@ref`，或 GitHub URL。 + `` 可以是本地文件夹、`owner/repo`、`owner/repo@ref`，或一个 GitHub URL。 选项： - `--dry-run` — 构建精确的发布计划，但不上传任何内容。 - - `--json` — 为 CI 输出机器可读格式。 - - `--source-repo`、`--source-commit`、`--source-ref` — 当自动检测不足时的可选覆盖项。 + - `--json` — 为 CI 输出机器可读结果。 + - `--source-repo`, `--source-commit`, `--source-ref` — 当自动检测不够用时的可选覆盖项。 @@ -243,7 +264,7 @@ ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitH clawhub undelete --yes ``` - + ```bash clawhub sync ``` @@ -254,7 +275,7 @@ ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitH - `--all` — 不提示，上传所有内容。 - `--dry-run` — 显示将要上传的内容。 - `--bump ` — 更新时使用 `patch|minor|major`（默认：`patch`）。 - - `--changelog ` — 非交互式更新的变更日志。 + - `--changelog ` — 用于非交互式更新的变更日志。 - `--tags ` — 逗号分隔的标签（默认：`latest`）。 - `--concurrency ` — 注册表检查并发数（默认：`4`）。 @@ -269,6 +290,13 @@ ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitH clawhub search "postgres backups" ``` + + ```bash + clawhub package explore --family code-plugin + clawhub package explore "memory" --family code-plugin + clawhub package inspect episodic-claw + ``` + ```bash clawhub install my-skill-pack @@ -299,7 +327,7 @@ ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitH -### 插件包元数据 +### 插件软件包元数据 代码插件必须在 `package.json` 中包含所需的 OpenClaw 元数据： @@ -323,28 +351,28 @@ ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitH } ``` -已发布的包应包含**已构建的 JavaScript**，并将 `runtimeExtensions` 指向该输出。Git checkout 安装在没有已构建文件时仍可回退到 TypeScript 源码，但使用已构建的运行时入口可以避免在启动、doctor 和插件加载路径中进行运行时 TypeScript 编译。 +已发布的软件包应当附带**已构建的 JavaScript**，并将 `runtimeExtensions` 指向该输出。Git 检出安装在不存在已构建文件时仍可回退到 TypeScript 源码，但使用已构建的运行时入口可避免在启动、Doctor 和插件加载路径中进行运行时 TypeScript 编译。 ## 版本管理、锁文件和遥测 - 每次发布都会创建一个新的 **semver** `SkillVersion`。 - - 标签（如 `latest`）指向某个版本；移动标签可以让你回滚。 + - 标签（如 `latest`）指向某个版本；移动标签可让你回滚。 - 变更日志按版本附加，在同步或发布更新时可以为空。 - - 更新会使用内容哈希将本地 Skill 内容与注册表版本进行比较。如果本地文件不匹配任何已发布版本，CLI 会在覆盖前进行询问（或者在非交互式运行中要求使用 `--force`）。 + + 更新会使用内容哈希将本地 Skill 内容与注册表版本进行比较。如果本地文件与任何已发布版本都不匹配，CLI 会在覆盖前询问（或在非交互式运行中要求使用 `--force`）。 - `clawhub sync` 会先扫描你当前的 workdir。如果没有找到 Skills，它会回退到已知的旧版位置（例如 `~/openclaw/skills` 和 `~/.openclaw/skills`）。这样设计是为了在无需额外标志的情况下找到较旧的 Skill 安装。 + `clawhub sync` 会先扫描你当前的 workdir。如果未找到任何 Skills，则会回退到已知的旧版位置（例如 `~/openclaw/skills` 和 `~/.openclaw/skills`）。这样设计是为了在无需额外标志的情况下找到旧的 Skill 安装。 - - 已安装的 Skills 会记录在你 workdir 下的 `.clawhub/lock.json` 中。 - - 认证 token 会存储在 ClawHub CLI 配置文件中（可通过 `CLAWHUB_CONFIG_PATH` 覆盖）。 + - 已安装的 Skills 会记录在 workdir 下的 `.clawhub/lock.json` 中。 + - 认证令牌会存储在 ClawHub CLI 配置文件中（可通过 `CLAWHUB_CONFIG_PATH` 覆盖）。 - 当你在已登录状态下运行 `clawhub sync` 时，CLI 会发送一个最小快照来计算安装计数。你可以完全禁用此行为： + 当你在已登录状态下运行 `clawhub sync` 时，CLI 会发送一个最小快照以计算安装计数。你可以完全禁用此功能： ```bash export CLAWHUB_DISABLE_TELEMETRY=1 @@ -355,16 +383,16 @@ ClawHub 默认开放——任何人都可以上传 Skills，但发布者的 GitH ## 环境变量 -| 变量 | 作用 | +| Variable | Effect | | ----------------------------- | ----------------------------------------------- | -| `CLAWHUB_SITE` | 覆盖站点 URL。 | -| `CLAWHUB_REGISTRY` | 覆盖注册表 API URL。 | -| `CLAWHUB_CONFIG_PATH` | 覆盖 CLI 存储 token/配置的位置。 | -| `CLAWHUB_WORKDIR` | 覆盖默认 workdir。 | +| `CLAWHUB_SITE` | 覆盖站点 URL。 | +| `CLAWHUB_REGISTRY` | 覆盖注册表 API URL。 | +| `CLAWHUB_CONFIG_PATH` | 覆盖 CLI 存储令牌/配置的位置。 | +| `CLAWHUB_WORKDIR` | 覆盖默认 workdir。 | | `CLAWHUB_DISABLE_TELEMETRY=1` | 禁用 `sync` 的遥测。 | ## 相关内容 - [社区插件](/zh-CN/plugins/community) -- [插件](/zh-CN/tools/plugin) +- [Plugins](/zh-CN/tools/plugin) - [Skills](/zh-CN/tools/skills)