中文 ClawHub 工具页
- 原始链接：https://docs.openclaw.ai/zh-CN/tools/clawhub
- 来源章节：5. 官方文档：工具、技能、插件与自动化
- 来源小节：无
- 抓取方式：jina:https://r.jina.ai/http://docs.openclaw.ai/zh-CN/tools/clawhub
- 抓取时间：2026-04-05 13:47:10
- 状态：ok
中文内容
ClawHub 是 OpenClaw 的公共 Skills 与插件注册中心。你可以在网页应用中浏览资源，也可以使用 CLI 来搜索、安装、更新和发布 Skills / 插件。网站：clawhub.ai
适用人群（新手友好）
如果你想为 OpenClaw 智能体添加新功能，ClawHub 是查找和安装 Skills 的最简单方式。你不需要了解后端的工作原理。你可以：
- 使用自然语言搜索 Skills。
- 将 Skills 安装到你的工作区。
- 之后使用一条命令更新 Skills。
- 通过发布 Skills 来备份你自己的 Skills。
快速入门（非技术人员）
-
安装 CLI（参见下一节）。
-
搜索你需要的内容： *
clawhub search "calendar" -
安装一个 Skills： *
clawhub install <skill-slug> -
启动一个新的 OpenClaw 会话，以加载新 Skills。
安装 CLI
任选其一：
npm i -g clawhubpnpm add -g clawhub在 OpenClaw 中的定位
默认情况下，CLI 会将 Skills 安装到当前工作目录下的 ./skills。如果已配置 OpenClaw 工作区，clawhub 会回退到该工作区，除非你通过 --workdir（或 CLAWHUB_WORKDIR）进行覆盖。OpenClaw 从 <workspace>/skills 加载工作区 Skills，并会在下一个会话中生效。如果你已经在使用 ~/.openclaw/skills 或内置 Skills，工作区 Skills 优先级更高。有关 Skills 加载、共享和权限控制的更多详情，请参阅 Skills。
服务功能
- 公开浏览Skills 及其
SKILL.md内容。 - 基于嵌入向量（向量搜索）的搜索，而不仅仅是关键词匹配。
- 支持语义化版本号、变更日志和标签（包括
latest）的版本管理。 - 每个版本以 zip 格式下载。
- 星标和评论，支持社区反馈。
- 审核钩子，用于审批和审计。
- CLI 友好的 API，支持自动化和脚本编写。
CLI 命令和参数
全局选项（适用于所有命令）：
--workdir <dir>：工作目录（默认：当前目录；回退到 OpenClaw 工作区）。--dir <dir>：Skills 目录，相对于工作目录（默认：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 <n>：最大结果数。
安装：
clawhub install <slug>--version <version>：安装指定版本。--force：如果文件夹已存在则覆盖。
更新：
clawhub update <slug>clawhub update --all--version <version>：更新到指定版本（仅限单个 slug）。--force：当本地文件与任何已发布版本不匹配时强制覆盖。
列表：
clawhub list（读取.clawhub/lock.json）
发布 Skills：
clawhub skill publish <path>--slug <slug>：Skills 标识符。--name <name>：显示名称。--version <version>：语义化版本号。--changelog <text>：变更日志文本（可以为空）。--tags <tags>：逗号分隔的标签（默认：latest）。
发布插件：
clawhub package publish <source><source>可以是本地文件夹、owner/repo、owner/repo@ref或 GitHub URL。--dry-run：只生成发布计划，不实际上传。--json：为 CI 输出结构化 JSON。
删除/恢复（仅所有者/管理员）：
clawhub delete <slug> --yesclawhub undelete <slug> --yes
同步（扫描本地 Skills + 发布新增/更新的 Skills）：
clawhub sync--root <dir...>：额外的扫描根目录。--all：无提示上传所有内容。--dry-run：显示将要上传的内容。--bump <type>：更新的版本号递增类型patch|minor|major（默认：patch）。--changelog <text>：非交互更新的变更日志。--tags <tags>：逗号分隔的标签（默认：latest）。--concurrency <n>：注册中心检查并发数（默认：4）。
智能体常用工作流
搜索 Skills
clawhub search "postgres backups"下载新 Skills
clawhub install my-skill-pack更新已安装的 Skills
clawhub update --all备份你的 Skills（发布或同步）
对于单个 Skills 文件夹：
clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest一次扫描并备份多个 Skills：
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/your-plugin@v1.0.0
clawhub package publish https://github.com/your-org/your-plugin高级详情（技术性）
版本管理和标签
- 每次发布都会创建一个新的语义化版本
SkillVersion。 - 标签（如
latest）指向某个版本；移动标签可以实现回滚。 - 变更日志附加在每个版本上，在同步或发布更新时可以为空。
本地更改与注册中心版本
更新时会使用内容哈希将本地 Skills 内容与注册中心版本进行比较。如果本地文件与任何已发布版本不匹配，CLI 会在覆盖前询问确认（或在非交互模式下需要 --force）。
同步扫描和回退根目录
clawhub sync 首先扫描当前工作目录。如果未找到 Skills，它会回退到已知的旧版位置（例如 ~/openclaw/skills 和 ~/.openclaw/skills）。这样设计是为了在不需要额外标志的情况下找到旧版 Skills 安装。
存储和锁文件
- 已安装的 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的遥测功能。