ClawHub
ClawHub 是 OpenClaw 的公共技能注册中心。它是一个免费服务：所有技能都是公开、开放的，对所有人可见，可用于分享和复用。一个技能本质上就是一个包含 SKILL.md 文件（以及辅助文本文件）的文件夹。你可以在 Web 应用中浏览技能，也可以使用 CLI 搜索、安装、更新和发布技能。
站点：clawhub.ai
ClawHub 是什么
- 一个 OpenClaw 技能的公共注册中心。
- 一个版本化的技能包和元数据存储。
- 一个支持搜索、标签和使用信号的发现平台。
工作原理
- 用户发布技能包（文件 + 元数据）。
- ClawHub 存储技能包，解析元数据并分配版本号。
- 注册中心为技能编制索引以供搜索和发现。
- 用户在 OpenClaw 中浏览、下载和安装技能。
你可以做什么
- 发布新技能和已有技能的新版本。
- 通过名称、标签或搜索发现技能。
- 下载技能包并检查其文件。
- 举报滥用或不安全的技能。
- 如果你是管理员，可以隐藏、恢复显示、删除技能或封禁用户。
适用人群（新手友好）
如果你想为 OpenClaw 代理添加新功能，ClawHub 是查找和安装技能最简单的方式。你不需要了解后端如何工作。你可以：
- 用自然语言搜索技能。
- 将技能安装到你的工作区。
- 之后用一条命令更新技能。
- 通过发布技能来备份你自己的技能。
快速开始（非技术用户）
- 安装 CLI（见下一节）。
- 搜索你需要的内容：
clawhub search "calendar"
- 安装技能：
clawhub install <slug>
- 启动一个新的 OpenClaw 会话以使其加载新技能。
安装 CLI
选择其一：
npm i -g clawhubpnpm add -g clawhubClawHub 如何融入 OpenClaw
默认情况下，CLI 将技能安装到当前工作目录下的 ./skills。如果已配置 OpenClaw 工作区，clawhub 会回退到该工作区，除非你通过 --workdir（或 CLAWHUB_WORKDIR）覆盖。
OpenClaw 从 /skills 加载工作区技能，并在下一个会话中使用它们。如果你已经使用 ~/.openclaw/skills 或捆绑的技能，工作区技能具有更高优先级。有关技能如何加载、共享和控制的更多详情，请参见 技能。
技能系统概述
技能是一个版本化的文件包，教导 OpenClaw 如何执行特定任务。每次发布创建一个新版本，注册中心保留版本历史记录，以便用户审计更改。
典型的技能包括：
- 一个
SKILL.md文件，包含主要描述和用法。 - 技能使用的可选配置、脚本或辅助文件。
- 元数据，如标签、摘要和安装要求。
ClawHub 使用元数据来驱动发现并安全地暴露技能能力。注册中心还跟踪使用信号（如星标和下载量）以改善排名和可见性。
服务提供的功能
- 公开浏览 技能及其
SKILL.md内容。 - 搜索 基于嵌入向量（向量搜索），而非仅仅关键词。
- 版本控制 支持 semver、变更日志和标签（包括
latest）。 - 下载 每个版本提供 zip 包。
- 星标和评论 用于社区反馈。
- 审核 钩子用于审批和审计。
- CLI 友好的 API 用于自动化和脚本编写。
安全与审核
ClawHub 默认开放。任何人都可以上传技能，但 GitHub 账户需要至少注册一周才能发布。这有助于减缓滥用而不阻止合法贡献者。
举报和审核：
- 任何已登录用户都可以举报技能。
- 举报原因是必需的并会被记录。
- 每个用户最多可以同时有 20 个活跃举报。
- 超过 3 个不同用户举报的技能默认自动隐藏。
- 管理员可以查看已隐藏的技能、恢复显示、删除技能或封禁用户。
- 滥用举报功能可能导致账户被封禁。
有兴趣成为管理员？请在 OpenClaw Discord 中提问并联系管理员或维护者。
CLI 命令和参数
全局选项（适用于所有命令）：
--workdir <path>：工作目录（默认：当前目录；回退到 OpenClaw 工作区）。--dir <path>：技能目录，相对于 workdir（默认：skills）。--site <url>：站点基础 URL（浏览器登录）。--registry <url>：注册中心 API 基础 URL。--no-input：禁用提示（非交互模式）。-V, --cli-version：打印 CLI 版本。
认证
clawhub login（浏览器流程）或clawhub login --token <token>clawhub logoutclawhub whoami
选项：
--token <token>：粘贴 API 令牌。--label <label>：为浏览器登录令牌存储的标签（默认：CLI token）。--no-browser：不打开浏览器（需要--token）。
搜索
clawhub search "query"--limit <number>：最大结果数。
安装
clawhub install <slug>--version <version>：安装特定版本。--force：如果文件夹已存在则覆盖。
更新
clawhub update <slug>clawhub update --all--version <version>：更新到特定版本（仅限单个 slug）。--force：当本地文件与任何已发布版本不匹配时覆盖。
列表
clawhub list（读取.clawhub/lock.json）
发布
clawhub publish <path>--slug <slug>：技能 slug。--name <name>：显示名称。--version <version>：semver 版本。--changelog <text>：变更日志文本（可为空）。--tags <tags>：逗号分隔的标签（默认：latest）。
删除/恢复（仅所有者/管理员）
clawhub delete --yesclawhub undelete --yes
同步（扫描本地技能 + 发布新增/更新的技能）
clawhub sync--root <path>：额外的扫描根目录。--all：无提示上传所有内容。--dry-run：显示将要上传的内容。--bump <type>：patch|minor|major用于更新（默认：patch）。--changelog <text>：非交互更新的变更日志。--tags <tags>：逗号分隔的标签（默认：latest）。--concurrency <number>：注册中心检查并发数（默认：4）。
代理的常见工作流
搜索技能
clawhub search "postgres backups"下载新技能
clawhub install my-skill-pack更新已安装的技能
clawhub update --all备份你的技能（发布或同步）
对于单个技能文件夹：
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest批量扫描和备份多个技能：
clawhub sync --all高级详情（技术向）
版本控制和标签
- 每次发布创建一个新的 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时禁用遥测。