跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

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

ClawHub 是 OpenClaw Skills 和插件 的公共注册表。
  • 使用原生 openclaw 命令搜索、安装和更新 Skills，并从 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
# or
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 Skills 和插件的公共注册表。
  • 技能包和元数据的版本化存储。
  • 用于搜索、标签和使用信号的发现界面。
一个典型技能是包含以下内容的版本化文件包：
  • 一个 SKILL.md 文件，包含主要描述和用法。
  • 技能使用的可选配置、脚本或支持文件。
  • 标签、摘要和安装要求等元数据。
ClawHub 使用元数据来支持发现，并安全地暴露技能 能力。注册表会跟踪使用信号（星标、下载量）来 改进排序和可见性。每次发布都会创建新的 semver 版本，注册表会保留版本历史，以便用户审计 变更。

​
工作区和技能加载

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

​
服务功能

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

​
安全和审核

ClawHub 默认开放，任何人都可以上传技能，但 GitHub 账号必须至少注册一周才能发布。这样可以减缓 滥用，同时不阻止合法贡献者。
ClawHub 会对已发布的技能和插件版本运行自动安全检查。 公共详情页面会汇总当前结果，扫描器行会链接到 VirusTotal、ClawScan 和静态分析的专用详情页面。被扫描保留或阻止的版本可能无法在公共目录和 安装界面中使用，但其所有者仍可在 /dashboard 中看到。
  • 任何已登录用户都可以举报技能。
  • 举报原因是必填项并会被记录。
  • 每个用户最多可同时拥有 20 条活跃举报。
  • 默认情况下，收到超过 3 个唯一举报的 Skills 会被自动隐藏。
  • 审核员可以查看隐藏的 Skills、取消隐藏、删除它们，或封禁用户。
  • 滥用举报功能可能导致账号被封禁。
  • 有兴趣成为审核员？请在 OpenClaw Discord 中询问，并联系审核员或维护者。

​
ClawHub CLI

你只有在发布/同步等需要注册表认证的工作流中才需要它。

​
全局选项

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

​
命令

clawhub login              # browser flow
clawhub login --token <token>
clawhub logout
clawhub whoami
登录选项：
  • --token <token> — 粘贴 API 令牌。
  • --label <label> — 为浏览器登录令牌存储的标签（默认：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。
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
重新扫描命令需要已登录的所有者令牌，并以最新 已发布技能版本或插件版本为目标。在非交互运行中，传入 --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）指向某个版本；移动标签可让你回滚。
  • 变更日志按版本附加，在同步或发布更新时可以为空。
更新会使用内容哈希将本地 skill 内容与注册表版本进行比较。如果本地文件与任何已发布版本都不匹配，CLI 会在覆盖前询问（或在非交互式运行中要求使用 --force）。
clawhub sync 会先扫描你的当前工作目录。如果没有找到 skills，它会回退到已知的旧版位置（例如 ~/openclaw/skills 和 ~/.openclaw/skills）。这旨在无需额外标志即可找到较旧的 skill 安装。
  • 已安装的 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 时禁用遥测。

​
相关