@gguf/claw

--- read_when: - 向新用户介绍 ClawHub - 安装、搜索或发布 Skills - 说明 ClawHub CLI 标志和同步行为 summary: ClawHub 指南：公共 Skills 注册中心 + CLI 工作流 title: ClawHub x-i18n: generated_at: "2026-02-01T21:42:32Z" model: claude-opus-4-5 provider: pi source_hash: 8b7f8fab80a34e409f37fa130a49ff5b487966755a7b0d214dfebf5207c7124c source_path: tools/clawhub.md workflow: 15 --- # ClawHub ClawHub 是 **OpenClaw 的公共 Skills 注册中心**。它是一项免费服务：所有 Skills 都是公开的、开放的，所有人都可以查看、共享和复用。Skills 就是一个包含 `SKILL.md` 文件（以及辅助文本文件）的文件夹。你可以在网页应用中浏览 Skills，也可以使用 CLI 来搜索、安装、更新和发布 Skills。网站：[clawhub.com](https://clawhub.com) ## 适用人群（新手友好）如果你想为 OpenClaw 智能体添加新功能，ClawHub 是查找和安装 Skills 的最简单方式。你不需要了解后端的工作原理。你可以： - 使用自然语言搜索 Skills。 - 将 Skills 安装到你的工作区。 - 之后使用一条命令更新 Skills。 - 通过发布 Skills 来备份你自己的 Skills。 ## 快速入门（非技术人员） 1. 安装 CLI（参见下一节）。 2. 搜索你需要的内容： - `clawhub search "calendar"` 3. 安装一个 Skills： - `clawhub install <skill-slug>` 4. 启动一个新的 OpenClaw 会话，以加载新 Skills。 ## 安装 CLI 任选其一： ```bash npm i -g clawhub ``` ```bash pnpm add -g clawhub ``` ## 在 OpenClaw 中的定位默认情况下，CLI 会将 Skills 安装到当前工作目录下的 `./skills`。如果已配置 OpenClaw 工作区，`clawhub` 会回退到该工作区，除非你通过 `--workdir`（或 `CLAWHUB_WORKDIR`）进行覆盖。OpenClaw 从 `<workspace>/skills` 加载工作区 Skills，并会在**下一个**会话中生效。如果你已经在使用 `~/.openclaw/skills` 或内置 Skills，工作区 Skills 优先级更高。有关 Skills 加载、共享和权限控制的更多详情，请参阅 [Skills](/tools/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 logout` - `clawhub 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`）发布： - `clawhub publish <path>` - `--slug <slug>`：Skills 标识符。 - `--name <name>`：显示名称。 - `--version <version>`：语义化版本号。 - `--changelog <text>`：变更日志文本（可以为空）。 - `--tags <tags>`：逗号分隔的标签（默认：`latest`）。删除/恢复（仅所有者/管理员）： - `clawhub delete <slug> --yes` - `clawhub 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 ```bash clawhub search "postgres backups" ``` ### 下载新 Skills ```bash clawhub install my-skill-pack ``` ### 更新已安装的 Skills ```bash clawhub update --all ``` ### 备份你的 Skills（发布或同步）对于单个 Skills 文件夹： ```bash clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest ``` 一次扫描并备份多个 Skills： ```bash clawhub sync --all ``` ## 高级详情（技术性） ### 版本管理和标签 - 每次发布都会创建一个新的**语义化版本** `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 会发送一个最小快照用于计算安装次数。你可以完全禁用此功能： ```bash export CLAWHUB_DISABLE_TELEMETRY=1 ``` ## 环境变量 - `CLAWHUB_SITE`：覆盖网站 URL。 - `CLAWHUB_REGISTRY`：覆盖注册中心 API URL。 - `CLAWHUB_CONFIG_PATH`：覆盖 CLI 存储令牌/配置的位置。 - `CLAWHUB_WORKDIR`：覆盖默认工作目录。 - `CLAWHUB_DISABLE_TELEMETRY=1`：禁用 `sync` 的遥测功能。