Skip to content

ClawHub

ClawHub 是 OpenClaw 技能(Skills)和插件(Plugins)的公共注册中心

  • 使用原生 openclaw 命令搜索/安装/更新技能,以及从 ClawHub 安装插件。
  • 需要注册认证、发布、删除、恢复或同步工作流时,使用独立的 clawhub CLI。

网站:clawhub.ai

这里就是你的龙虾零件商城,缺什么技能,搜一搜就能装上。

原生 OpenClaw 命令流程

技能操作:

bash
openclaw skills search "calendar"
openclaw skills install <skill-slug>
openclaw skills update --all

插件操作:

bash
openclaw plugins install clawhub:<package>
openclaw plugins update --all

裸 npm 风格的插件规格也会先在 ClawHub 中查找,再尝试 npm:

bash
openclaw plugins install openclaw-codex-app-server

原生 openclaw 命令将技能安装到当前活跃 workspace,并持久化来源元数据,以便后续 update 命令继续从 ClawHub 获取更新。

ClawHub 是什么

  • OpenClaw 技能的公共注册中心。
  • 技能包和元数据的版本化存储。
  • 基于搜索、标签和使用信号的发现界面。

工作流程

  1. 用户发布一个技能包(文件 + 元数据)。
  2. ClawHub 存储包,解析元数据,分配版本号。
  3. 注册中心对技能建立索引,支持搜索和发现。
  4. 用户在 OpenClaw 中浏览、下载、安装技能。

能做什么

  • 发布新技能和现有技能的新版本。
  • 按名称、标签或搜索词发现技能。
  • 下载技能包并检查其文件。
  • 举报滥用或不安全的技能。
  • 若你是管理员,可隐藏、恢复、删除或封禁。

面向新手的快速入门

如果你想为 OpenClaw Agent 添加新能力,ClawHub 是最简单的方式:

  • 用日常语言搜索技能。
  • 将技能安装到你的 workspace。
  • 一条命令更新技能。
  • 发布技能,作为自己的备份。

快速开始(非技术用户)

  1. 搜索你需要的功能:
    • openclaw skills search "calendar"
  2. 安装技能:
    • openclaw skills install <skill-slug>
  3. 启动新的 OpenClaw 会话,让 Agent 加载新技能。
  4. 如需发布或管理注册认证,还需安装独立的 clawhub CLI。

安装 ClawHub CLI

只有在需要注册认证相关工作流(如发布/同步)时才需要安装:

bash
npm i -g clawhub
bash
pnpm add -g clawhub

与 OpenClaw 的集成关系

原生 openclaw skills install 将技能安装到当前 workspace 的 skills/ 目录下。openclaw plugins install clawhub:... 记录一次普通的托管插件安装以及 ClawHub 来源元数据,用于后续更新。

独立的 clawhub CLI 也会将技能安装到当前工作目录的 ./skills 下。如果配置了 OpenClaw workspace,clawhub 会回退到该 workspace(除非你用 --workdirCLAWHUB_WORKDIR 覆盖)。OpenClaw 从 <workspace>/skills 加载 workspace 技能,下次会话时生效。若你已使用 ~/.openclaw/skills 或捆绑技能,workspace 技能优先级更高。

关于技能如何加载、共享和授权的更多细节,见 Skills

技能系统概述

技能是一个版本化的文件包,教 OpenClaw 如何执行特定任务。每次发布创建一个新版本,注册中心保留版本历史,供用户审计变更。

典型技能包含:

  • 包含主要描述和用法的 SKILL.md 文件。
  • 可选的配置文件、脚本或技能所用的支持文件。
  • 标签、摘要、安装要求等元数据。

ClawHub 利用元数据驱动发现,并安全地暴露技能能力。注册中心还追踪使用信号(如 star 数和下载量),以改善排名和可见度。

服务功能

  • 公开浏览技能及其 SKILL.md 内容。
  • 基于向量(语义)搜索,不只是关键词匹配。
  • 版本控制,支持语义化版本、变更日志和标签(包括 latest)。
  • 按版本下载 zip 包。
  • Star 和评论,供社区反馈。
  • 审核钩子,支持审批和审计。
  • CLI 友好的 API,便于自动化和脚本集成。

安全与审核

ClawHub 默认开放。任何人都可以上传技能,但 GitHub 账号需至少一周历史才能发布,以减缓滥用而不阻碍正常贡献者。

举报与审核:

  • 任何已登录用户都可以举报技能。
  • 举报时需提供原因,记录在案。
  • 每个用户最多同时有 20 条活跃举报。
  • 来自 3 个以上不同用户的举报会导致技能默认自动隐藏。
  • 管理员可查看隐藏技能,恢复、删除或封禁用户。
  • 滥用举报功能可能导致账号被封禁。

想成为管理员?在 OpenClaw Discord 中询问,联系管理员或维护者。

CLI 命令与参数

全局选项(适用于所有命令):

  • --workdir <dir>:工作目录(默认:当前目录;回退到 OpenClaw workspace)。
  • --dir <dir>:技能目录,相对于 workdir(默认: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 token。
  • --label <label>:为浏览器登录 token 设置标签(默认: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>:技能 slug。
  • --name <name>:显示名称。
  • --version <version>:语义化版本号。
  • --changelog <text>:变更日志(可为空)。
  • --tags <tags>:逗号分隔的标签(默认:latest)。

删除/恢复(仅所有者/管理员):

  • 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)。

Agent 常用工作流

搜索技能

bash
clawhub search "postgres backups"

下载新技能

bash
clawhub install my-skill-pack

更新已安装的技能

bash
clawhub update --all

备份你的技能(发布或同步)

单个技能文件夹:

bash
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

一次性批量备份多个技能:

bash
clawhub sync --all

高级细节(技术向)

版本控制与标签

  • 每次发布创建一个新的语义化版本 SkillVersion
  • 标签(如 latest)指向某个版本,移动标签可以回滚。
  • 变更日志按版本附加,同步或发布更新时可为空。

本地变更 vs 注册中心版本

更新时,CLI 会通过内容哈希将本地技能内容与注册中心版本进行比较。若本地文件与任何已发布版本不匹配,CLI 会在覆盖前询问(非交互式运行时需要 --force)。

同步扫描与回退目录

clawhub sync 先扫描当前 workdir。若未找到技能,则回退到已知的旧版位置(例如 ~/openclaw/skills~/.openclaw/skills)。这样无需额外参数就能找到旧版技能安装。

存储与锁定文件

  • 已安装技能记录在 workdir 下的 .clawhub/lock.json 中。
  • Auth token 存储在 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 存储 token/配置的位置。
  • CLAWHUB_WORKDIR:覆盖默认 workdir。
  • CLAWHUB_DISABLE_TELEMETRY=1:禁用 sync 时的遥测。