Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

ClawHub 是 OpenClaw 技能和插件 的公共注册表。
  • 使用原生 openclaw 命令来搜索、安装和更新技能，并从 ClawHub 安装插件。
  • 使用独立的 clawhub CLI 来进行注册表认证、发布、删除/恢复删除，以及同步工作流。
站点：clawhub.ai

​
快速开始

1

搜索

openclaw skills search "calendar"
2

安装

openclaw skills install <skill-slug>
3

使用

启动一个新的 OpenClaw 会话 —— 它会自动载入新技能。
4

发布（可选）

对于需要注册表认证的工作流（发布、同步、管理），请安装 独立的 clawhub CLI：
npm i -g clawhub
# 或
pnpm add -g clawhub

​
原生 OpenClaw 流程

openclaw skills search "calendar"
openclaw skills install <skill-slug>
openclaw skills update --all
原生 openclaw 命令会安装到你当前的工作区，并 保留源元数据，以便后续的 update 调用仍可从 ClawHub 获取更新。
openclaw plugins install clawhub:... 只接受可安装的插件 家族。如果某个 ClawHub 包实际上是一个技能，OpenClaw 会停止并 改为提示你使用 openclaw skills install <slug>。匿名 ClawHub 插件安装对私有包也会失败并阻止继续。社区或其他非官方渠道仍然可以安装，但 OpenClaw 会发出警告， 以便运维人员在启用前审查来源和验证信息。

​
什么是 ClawHub

  • OpenClaw 技能和插件的公共注册表。
  • 技能包及其元数据的版本化存储。
  • 用于搜索、标签和使用信号的发现入口。
一个典型的技能是由文件组成的版本化包，其中包括：
  • 一个 SKILL.md 文件，包含主要说明和用法。
  • 该技能使用的可选配置、脚本或辅助文件。
  • 标签、摘要和安装要求等元数据。
ClawHub 使用元数据来支持发现并安全地公开技能 能力。注册表会跟踪使用信号（星标、下载量）来改进排序 和可见性。每次发布都会创建一个新的 semver 版本，注册表会保留版本历史，以便用户审计 变更。

​
工作区和技能加载

独立的 clawhub CLI 也会将技能安装到你当前工作目录下的 ./skills 中。如果已配置 OpenClaw 工作区，clawhub 会回退到该工作区，除非你覆盖 --workdir （或 CLAWHUB_WORKDIR）。OpenClaw 会从 <workspace>/skills 加载工作区技能，并在下一次会话中识别它们。 如果你已经在使用 ~/.openclaw/skills 或内置技能，工作区 技能会优先生效。关于技能如何加载、 共享和受控的更多细节，请参见 Skills。

​
服务特性

特性说明
公开浏览技能及其 SKILL.md 内容可公开查看。
搜索基于嵌入（向量搜索），不只是关键词。
版本管理semver、变更日志和标签（包括 latest）。
下载每个版本一个 zip 包。
星标和评论社区反馈。
安全扫描摘要详情页会在安装或下载前显示最新扫描状态。
扫描器详情页VirusTotal、ClawScan 和静态分析结果都有深度链接。
所有者恢复仪表板发布者可在 /dashboard 查看被扫描拦截的自有内容。
所有者请求复扫所有者可请求有限次数的复扫以修复误报。
内容审核审批和审计。
适合 CLI 的 API适用于自动化和脚本编写。

​
安全与审核

ClawHub 默认是开放的——任何人都可以上传技能，但 GitHub 账户必须至少存在一周才可发布。这可以减缓 滥用行为，同时不会阻止合法贡献者。
ClawHub 会对已发布的技能和插件发布版本执行自动安全检查。公开详情页会概述当前结果，扫描器 行会链接到 VirusTotal、ClawScan 和静态 分析的专用详情页。处于扫描拦截或被阻止状态的发布内容，可能在公开目录和 安装入口不可用，但其所有者仍可在 /dashboard 中看到它们。
  • 任何已登录用户都可以举报技能。
  • 举报原因是必填项，并会被记录。
  • 每个用户一次最多可有 20 个有效举报。
  • 超过 3 个不同用户举报的技能默认会被自动隐藏。
  • 审核员可以查看被隐藏的技能，将其取消隐藏，删除它们，或封禁用户。
  • 滥用举报功能可能导致账户被封禁。
  • 想成为审核员？请在 OpenClaw Discord 中询问，并联系审核员或维护者。

​
ClawHub CLI

你只需要在注册表认证的工作流中使用它，例如 发布/同步。

​
全局选项

​
--workdir <dir>
string
工作目录。默认：当前目录；会回退到 OpenClaw 工作区。
​
--dir <dir>
string
default:"skills"
技能目录，相对于 workdir。
​
--site <url>
string
网站基础 URL（浏览器登录）。
​
--registry <url>
string
注册表 API 基础 URL。
​
--no-input
boolean
禁用提示（非交互式）。
​
-V, --cli-version
boolean
打印 CLI 版本。

​
命令

clawhub login              # 浏览器流程
clawhub login --token <token>
clawhub logout
clawhub whoami
登录选项：
  • --token <token> — 粘贴一个 API token。
  • --label <label> — 浏览器登录 token 保存的标签（默认：CLI token）。
  • --no-browser — 不打开浏览器（需要 --token）。
clawhub search "query"
搜索技能。对于插件/包发现，请使用 clawhub package explore。
  • --limit <n> — 最大结果数。
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:<package>。选项：
  • --family skill|code-plugin|bundle-plugin — 过滤包家族。
  • --official — 仅显示官方包。
  • --executes-code — 仅显示会执行代码的包。
  • --version <version> / --tag <tag> — 检查特定包版本。
  • --versions, --files, --file <path> — 检查包历史和文件。
  • --json — 机器可读输出。
clawhub install <slug>
clawhub update <slug>
clawhub update --all
clawhub list
选项：
  • --version <version> — 安装或更新到特定版本（update 仅支持单个 slug）。
  • --force — 如果文件夹已存在，或本地文件与任何已发布版本都不匹配，则覆盖。
  • clawhub list 读取 .clawhub/lock.json。
clawhub skill publish <path>
选项：
  • --slug <slug> — 技能 slug。
  • --name <name> — 显示名称。
  • --version <version> — semver 版本。
  • --changelog <text> — 变更日志文本（可以为空）。
  • --tags <tags> — 以逗号分隔的标签（默认：latest）。
clawhub package publish <source>
<source> 可以是本地文件夹、owner/repo、owner/repo@ref，或一个 GitHub URL。选项：
  • --dry-run — 在不上传任何内容的情况下构建完整的发布计划。
  • --json — 为 CI 输出机器可读结果。
  • --source-repo, --source-commit, --source-ref — 当自动检测不够时可使用的可选覆盖项。
clawhub skill rescan <slug>
clawhub skill rescan <slug> --yes --json

clawhub package rescan <name>
clawhub package rescan <name> --yes --json
复扫命令需要已登录的所有者 token，并针对最新 已发布的技能版本或插件发布版本。在非交互运行中，请传入 --yes。JSON 响应包含目标类型、名称、版本、复扫状态，以及 该版本或发布剩余/最大请求次数。
clawhub delete <slug> --yes
clawhub undelete <slug> --yes

clawhub sync
选项：
  • --root <dir...> — 额外的扫描根目录。
  • --all — 无需提示上传全部内容。
  • --dry-run — 显示将要上传的内容。
  • --bump <type> — 更新时使用 patch|minor|major（默认：patch）。
  • --changelog <text> — 非交互式更新的变更日志。
  • --tags <tags> — 以逗号分隔的标签（默认：latest）。
  • --concurrency <n> — 注册表检查并发数（默认：4）。

​
常见工作流

clawhub search "postgres backups"

​
插件包元数据

代码插件必须在 package.json 中包含所需的 OpenClaw 元数据： 
{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./src/index.ts"],
    "runtimeExtensions": ["./dist/index.js"],
    "compat": {
      "pluginApi": ">=2026.3.24-beta.2",
      "minGatewayVersion": "2026.3.24-beta.2"
    },
    "build": {
      "openclawVersion": "2026.3.24-beta.2",
      "pluginSdkVersion": "2026.3.24-beta.2"
    }
  }
}
已发布的包应提供构建后的 JavaScript，并将 runtimeExtensions 指向该输出。即使没有构建产物，Git 检出安装也仍然可以 回退到 TypeScript 源码，但构建后的运行时条目可以避免在启动、doctor 以及 插件加载路径中进行运行时 TypeScript 编译。

​
版本控制、锁文件和遥测

  • 每次发布都会创建一个新的 semver SkillVersion。
  • 标签（如 latest）指向某个版本；移动标签可以让你回滚。
  • 变更日志按版本附加，并且在同步或发布更新时可以为空。
更新会使用内容哈希将本地技能内容与注册表版本进行比较。 如果本地文件与任何已发布版本都不匹配，CLI 会在覆盖前询问（或者在 非交互式运行中需要 --force）。
clawhub sync 会先扫描你当前的工作目录。如果没有找到技能， 它会回退到已知的旧位置（例如 ~/openclaw/skills 和 ~/.openclaw/skills）。这样设计是为了 在不额外添加标志的情况下找到更早期的技能安装。
  • 已安装的技能会记录在工作目录下的 .clawhub/lock.json 中。
  • 认证令牌存储在 ClawHub CLI 配置文件中（可通过 CLAWHUB_CONFIG_PATH 覆盖）。
当你登录后运行 clawhub sync 时，CLI 会发送一个最小 快照来计算安装次数。你可以完全禁用此功能：
export CLAWHUB_DISABLE_TELEMETRY=1

​
环境变量

变量作用
CLAWHUB_SITE覆盖站点 URL。
CLAWHUB_REGISTRY覆盖注册表 API URL。
CLAWHUB_CONFIG_PATH覆盖 CLI 存储令牌/配置的位置。
CLAWHUB_WORKDIR覆盖默认工作目录。
CLAWHUB_DISABLE_TELEMETRY=1禁用 sync 的遥测。

​
相关内容