OpenClaw从入门到应用——工具（Tools）：ClawHub
通过OpenClaw实现副业收入：《OpenClaw赚钱实录：从“养龙虾“到可持续变现的实践指南》
ClawHub
ClawHub 是OpenClaw 的公共技能注册中心。它是一项免费服务：所有技能都是公开、开放且对所有人可见，可供分享和复用。一个技能就是一个包含SKILL.md文件（以及配套文本文件）的文件夹。你可以在网页应用中浏览技能，或使用命令行工具来搜索、安装、更新和发布技能。
网站：clawhub.ai
ClawHub 是什么
- 一个面向 OpenClaw 技能的公共注册中心。
- 一个对技能包和元数据进行版本化管理的存储库。
- 一个支持搜索、标签和使用情况信号的发现平台。
它是如何工作的
- 用户发布一个技能包（文件 + 元数据）。
- ClawHub 存储该技能包，解析元数据，并分配一个版本号。
- 注册中心为该技能建立索引，以便于搜索和发现。
- 用户在 OpenClaw 中浏览、下载和安装技能。
你能做什么
- 发布新技能和现有技能的新版本。
- 按名称、标签或搜索发现技能。
- 下载技能包并查看其文件。
- 举报滥用或存在安全隐患的技能。
- 如果你是一位版主，你可以隐藏、取消隐藏、删除技能或封禁用户。
适用人群（对初学者友好）
如果你想为你的 OpenClaw 智能体添加新能力，ClawHub 是寻找和安装技能最简单的方式。你无需了解其后端是如何工作的。你可以：
- 用自然语言搜索技能。
- 将技能安装到你的工作区。
- 之后用一条命令更新技能。
- 通过发布技能来备份你自己的技能。
快速入门（非技术向）
- 安装命令行工具（见下一节）。
- 搜索你需要的内容：
clawhub search "calendar"
- 安装一个技能：
clawhub install <技能标识符>
- 启动一个新的 OpenClaw 会话，以便其加载新技能。
安装命令行工具
选择一种方式安装：
npmi-gclawhubpnpmadd-gclawhub它如何融入 OpenClaw
默认情况下，命令行工具会将技能安装到你当前工作目录下的./skills文件夹中。如果配置了 OpenClaw 工作区，clawhub将回退到该工作区，除非你使用--workdir（或CLAWHUB_WORKDIR环境变量）进行覆盖。OpenClaw 会从<工作区>/skills加载工作区技能，并在下一次会话中加载它们。如果你已经在使用~/.openclaw/skills或捆绑的技能，工作区技能将优先被加载。
关于技能如何加载、共享和控制的更多细节，请参阅
技能。
技能系统概述
一个技能就是一个带版本号的、能教会 OpenClaw 如何执行特定任务的文件包。每次发布都会创建一个新版本，注册中心会保留版本历史记录，以便用户审计变更。
一个典型的技能包含：
- 一个拥有主要描述和使用方法的
SKILL.md文件。 - 可选的配置、脚本或该技能使用的配套文件。
- 诸如标签、摘要和安装要求等元数据。
ClawHub 使用元数据来增强发现能力并安全地暴露技能功能。注册中心还会追踪使用情况信号（如星标和下载量）以改进排名和可见度。
服务提供的功能（特性）
- 公共浏览：查看技能及其
SKILL.md内容。 - 搜索：由嵌入（向量搜索）驱动，而不仅仅是关键字匹配。
- 版本控制：使用语义化版本，提供变更日志和标签（包括
latest）。 - 下载：每个版本以 zip 归档文件形式提供下载。
- 星标与评论：用于社区反馈。
- 版主工具：用于审批和审计的审查挂钩。
- 命令行友好的 API：用于自动化和脚本编写。
安全与内容审核
ClawHub 默认是开放的。任何人都可以上传技能，但要发布技能，GitHub 账号注册时间必须至少满一周。这有助于减缓滥用行为，同时不会阻止合法的贡献者。
举报和审核机制：
- 任何已登录用户都可以举报技能。
- 举报理由是必填项，并且会被记录下来。
- 每个用户同时最多可拥有 20 个活跃的举报。
- 默认情况下，收到超过 3 个独立举报的技能将被自动隐藏。
- 版主可以查看被隐藏的技能、取消隐藏它们、删除它们或封禁用户。
- 滥用举报功能可能导致账号被封禁。
有兴趣成为版主吗？在 OpenClaw 的 Discord 中联系版主或维护者咨询。
命令行命令与参数
全局选项（适用于所有命令）：
--workdir <目录>：工作目录（默认：当前目录；若未指定则回退到 OpenClaw 工作区）。--dir <目录>：技能目录，相对于工作目录（默认：skills）。--site <URL>：站点基础 URL（用于浏览器登录）。--registry <URL>：注册中心 API 基础 URL。--no-input：禁用提示（非交互模式）。-V, --cli-version：打印命令行工具版本。
认证相关：
clawhub login（浏览器流程）或clawhub login --token <令牌>clawhub logoutclawhub whoami
选项：
--token <令牌>：粘贴一个 API 令牌。--label <标签>：为浏览器登录令牌存储的标签（默认：CLI token）。--no-browser：不打开浏览器（需要提供--token）。
搜索：
clawhub search "查询内容"--limit <数量>：最大结果数。
安装：
clawhub install <标识符>--version <版本号>：安装特定版本。--force：如果文件夹已存在则覆盖。
更新：
clawhub update <标识符>clawhub update --all--version <版本号>：更新到特定版本（仅适用于单个标识符）。--force：当本地文件与任何已发布版本都不匹配时强制覆盖。
列出：
clawhub list（读取.clawhub/lock.json文件）
发布：
clawhub publish <路径>--slug <标识符>：技能标识符。--name <名称>：显示名称。--version <版本号>：语义化版本号。--changelog <文本>：变更日志文本（可为空）。--tags <标签>：逗号分隔的标签（默认：latest）。
删除/撤销删除（仅限所有者/管理员）：
clawhub delete <标识符> --yesclawhub undelete <标识符> --yes
同步（扫描本地技能 + 发布新增/更新的技能）：
clawhub sync--root <目录...>：额外的扫描根目录。--all：无需提示，直接上传所有内容。--dry-run：展示将要上传的内容。--bump <类型>：针对更新的版本号提升类型：patch|minor|major（默认：patch）。--changelog <文本>：非交互式更新时的变更日志。--tags <标签>：逗号分隔的标签（默认：latest）。--concurrency <数量>：注册中心检查的并发数（默认：4）。
面向智能体的常用工作流
搜索技能
clawhub search"postgres backups"下载新技能
clawhubinstallmy-skill-pack更新已安装的技能
clawhub update--all备份你的技能（发布或同步）
对于单个技能文件夹：
clawhub publish ./my-skill--slugmy-skill--name"My Skill"--version1.0.0--tagslatest要扫描并一次备份多个技能：
clawhubsync--all高级细节（技术向）
版本控制与标签
- 每次发布都会创建一个新的遵循语义化版本规范的
SkillVersion。 - 标签（如
latest）指向一个特定的版本；通过移动标签可以实现版本回滚。 - 变更日志会附加到每个版本上。在同步或发布更新时，变更日志可以为空。
本地变更与注册中心版本的比较
更新操作会使用内容哈希来比较本地技能内容与注册中心中的版本。如果本地文件与任何已发布版本都不匹配，命令行工具会在覆盖前询问（或在非交互式运行时要求提供--force标志）。
同步扫描与回退根目录
clawhub sync会首先扫描你当前的工作目录。如果未找到技能，它会回退到已知的旧版位置（例如~/openclaw/skills和~/.openclaw/skills）。这样设计是为了无需额外标志就能找到旧版本的技能安装。
存储与锁定文件
- 已安装的技能记录在你工作目录下的
.clawhub/lock.json文件中。 - 认证令牌存储在 ClawHub 命令行工具的配置文件中（可通过
CLAWHUB_CONFIG_PATH环境变量覆盖配置文件路径）。
遥测（安装计数）
当你在已登录状态下运行clawhub sync时，命令行工具会发送一份最小化的快照以计算安装数量。你可以完全禁用此功能：
exportCLAWHUB_DISABLE_TELEMETRY=1环境变量
CLAWHUB_SITE: 覆盖站点 URL。CLAWHUB_REGISTRY: 覆盖注册中心 API URL。CLAWHUB_CONFIG_PATH: 覆盖命令行工具存储令牌/配置的路径。CLAWHUB_WORKDIR: 覆盖默认的工作目录。CLAWHUB_DISABLE_TELEMETRY=1: 在执行sync时禁用遥测。