技能

ClawHub

ClawHub 是 OpenClaw Skills 和插件 的公共注册表。

使用原生 openclaw 命令搜索、安装和更新 Skills，并从 ClawHub 安装插件。
使用单独的 clawhub CLI 进行注册表身份验证、发布、删除/恢复删除，以及同步工作流。

快速开始

搜索

openclaw skills search "calendar"

安装

openclaw skills install <skill-slug>

使用

启动新的 OpenClaw 会话 - 它会加载新的 skill。

发布（可选）

对于需要注册表身份验证的工作流（发布、同步、管理），安装单独的 clawhub CLI：

npm i -g clawhub
# or
pnpm add -g clawhub

原生 OpenClaw 流程

Skills

openclaw skills search "calendar"
openclaw skills install <skill-slug>
openclaw skills update --all

原生 openclaw 命令会安装到你的活动工作区，并持久化源元数据，因此后续 update 调用可以继续使用 ClawHub。

插件

openclaw plugins search "calendar"
openclaw plugins install clawhub:<package>
openclaw plugins update --all

plugins search 会查询 ClawHub 插件目录，并打印可直接安装的包名称。当你想使用 ClawHub 解析时，请使用 clawhub:<package>。在发布切换期间，裸 npm 安全插件规格会从 npm 安装：

openclaw plugins install openclaw-codex-app-server

npm:<package> 也仅使用 npm，当规格可能存在歧义时很有用：

openclaw plugins install npm:openclaw-codex-app-server

插件安装会在归档安装运行前验证声明的 pluginApi 和 minGatewayVersion 兼容性，因此不兼容的主机会提前失败关闭，而不是部分安装该包。当某个包版本发布了 ClawPack 工件时， OpenClaw 会优先使用精确上传的 npm-pack .tgz，验证 ClawHub 摘要头和下载字节，并记录工件类型、npm 完整性、npm shasum、 tarball 名称和 ClawPack 摘要元数据，以供后续更新使用。没有 ClawPack 元数据的较旧包版本仍使用旧版包归档验证路径。

ClawHub 是什么

OpenClaw Skills 和插件的公共注册表。
skill 包和元数据的版本化存储。
用于搜索、标签和使用信号的发现界面。

典型的 skill 是包含以下内容的版本化文件包：

一个包含主要描述和用法的 SKILL.md 文件。
skill 使用的可选配置、脚本或支持文件。
标签、摘要和安装要求等元数据。

ClawHub 使用元数据来支持发现，并安全地暴露 skill 能力。注册表会跟踪使用信号（星标、下载量）以改进排序和可见性。每次发布都会创建新的 semver 版本，注册表会保留版本历史，以便用户审计变更。

工作区和 skill 加载

单独的 clawhub CLI 也会将 Skills 安装到当前工作目录下的 ./skills。如果配置了 OpenClaw 工作区， clawhub 会回退到该工作区，除非你覆盖 --workdir （或 CLAWHUB_WORKDIR）。OpenClaw 会从 <workspace>/skills 加载工作区 Skills，并在下一个会话中加载它们。

如果你已经使用 ~/.openclaw/skills 或内置 Skills，工作区 Skills 会优先生效。关于 Skills 如何加载、共享和门控的更多详情，请参阅 Skills。

服务功能

功能	说明
公开浏览	Skills 及其 `SKILL.md` 内容可公开查看。
搜索	由嵌入驱动（向量搜索），不只是关键词。
版本控制	Semver、变更日志和标签（包括 `latest`）。
下载	每个版本一个 Zip。
星标和评论	社区反馈。
安全扫描摘要	详情页面会在安装或下载前显示最新扫描状态。
扫描器详情页面	VirusTotal、ClawScan 和静态分析结果都有深层链接。
所有者恢复仪表板	发布者可以从 `/dashboard` 查看被扫描暂留的自有内容。
所有者请求重新扫描	所有者可以为误报恢复请求有限次数的重新扫描。
审核	批准和审计。
CLI 友好 API	适合自动化和脚本编写。

安全和审核

ClawHub 默认开放 - 任何人都可以上传 Skills，但 GitHub 账号必须至少创建满一周才能发布。这会减缓滥用，同时不阻碍合法贡献者。

安全扫描

ClawHub 会对已发布的 Skills 和插件发布版本运行自动安全检查。公开详情页面会汇总当前结果，扫描器行会链接到 VirusTotal、ClawScan 和静态分析的专用详情页面。

被扫描暂留或阻止的发布版本可能无法在公共目录和安装界面使用，但其所有者仍可在 /dashboard 中看到。

报告

任何已登录用户都可以报告 skill。
必须提供并记录报告原因。
每个用户一次最多可以有 20 个活动报告。
默认情况下，收到超过 3 个唯一报告的 Skills 会自动隐藏。

审核

审核员可以查看隐藏的 Skills、取消隐藏、删除它们或封禁用户。
滥用报告功能可能导致账号被封禁。
有兴趣成为审核员？请在 OpenClaw Discord 中询问，并联系审核员或维护者。

ClawHub CLI

你只需要在发布/同步等需要注册表身份验证的工作流中使用它。

全局选项

"--workdir

"--dir

"--site

"--registry

--no-inputboolean

禁用提示（非交互）。

-V, --cli-versionboolean

打印 CLI 版本。

命令

身份验证（登录 / 退出登录 / whoami）

clawhub login              # browser flow
clawhub login --token <token>
clawhub logout
clawhub whoami

登录选项：

--token <token> - 粘贴 API token。
--label <label> - 为浏览器登录 token 存储的标签（默认值：CLI token）。
--no-browser - 不打开浏览器（需要 --token）。

搜索

clawhub search "query"

搜索 Skills。对于插件/包发现，请使用 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。

发布 Skills

clawhub skill publish <path>

选项：

--slug <slug> - skill 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，并以最新发布的 skill 版本或插件发布版本为目标。在非交互式运行中，传入 --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"

查找插件

clawhub package explore --family code-plugin
clawhub package explore "memory" --family code-plugin
clawhub package inspect episodic-claw

安装

clawhub install my-skill-pack

全部更新

clawhub update --all

发布单个技能

clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

同步多个技能

clawhub sync --all

从 GitHub 发布插件

clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/[email protected]
clawhub package publish https://github.com/your-org/your-plugin

插件包元数据

代码插件必须在 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` 的遥测。

ClawHub

快速开始

搜索

安装

使用

发布（可选）

原生 OpenClaw 流程

Skills

插件

ClawHub 是什么

工作区和 skill 加载

服务功能

安全和审核

ClawHub CLI

全局选项

命令

常见工作流

搜索

查找插件

安装

全部更新

发布单个技能

同步多个技能

从 GitHub 发布插件

插件包元数据

版本控制、锁文件和遥测

环境变量

相关

Ask OpenClaw

# 快速开始

搜索

安装

使用

发布（可选）

# 原生 OpenClaw 流程

Skills

插件

# ClawHub 是什么

# 工作区和 skill 加载

# 服务功能

# 安全和审核

# ClawHub CLI

# 全局选项

# 命令

# 常见工作流

搜索

查找插件

安装

全部更新

发布单个技能

同步多个技能

从 GitHub 发布插件

# 插件包元数据

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

# 环境变量

# 相关

快速开始

原生 OpenClaw 流程

ClawHub 是什么

工作区和 skill 加载

服务功能

安全和审核

ClawHub CLI

全局选项

命令

常见工作流

插件包元数据

版本控制、锁文件和遥测

环境变量

相关