Appearance
ClawHub
ClawHub 是 OpenClaw 技能(Skills)和插件(Plugins)的公共注册中心。
- 使用原生
openclaw命令搜索/安装/更新技能,以及从 ClawHub 安装插件。 - 需要注册认证、发布、删除、恢复或同步工作流时,使用独立的
clawhubCLI。
网站: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 技能的公共注册中心。
- 技能包和元数据的版本化存储。
- 基于搜索、标签和使用信号的发现界面。
工作流程
- 用户发布一个技能包(文件 + 元数据)。
- ClawHub 存储包,解析元数据,分配版本号。
- 注册中心对技能建立索引,支持搜索和发现。
- 用户在 OpenClaw 中浏览、下载、安装技能。
能做什么
- 发布新技能和现有技能的新版本。
- 按名称、标签或搜索词发现技能。
- 下载技能包并检查其文件。
- 举报滥用或不安全的技能。
- 若你是管理员,可隐藏、恢复、删除或封禁。
面向新手的快速入门
如果你想为 OpenClaw Agent 添加新能力,ClawHub 是最简单的方式:
- 用日常语言搜索技能。
- 将技能安装到你的 workspace。
- 一条命令更新技能。
- 发布技能,作为自己的备份。
快速开始(非技术用户)
- 搜索你需要的功能:
openclaw skills search "calendar"
- 安装技能:
openclaw skills install <skill-slug>
- 启动新的 OpenClaw 会话,让 Agent 加载新技能。
- 如需发布或管理注册认证,还需安装独立的
clawhubCLI。
安装 ClawHub CLI
只有在需要注册认证相关工作流(如发布/同步)时才需要安装:
bash
npm i -g clawhubbash
pnpm add -g clawhub与 OpenClaw 的集成关系
原生 openclaw skills install 将技能安装到当前 workspace 的 skills/ 目录下。openclaw plugins install clawhub:... 记录一次普通的托管插件安装以及 ClawHub 来源元数据,用于后续更新。
独立的 clawhub CLI 也会将技能安装到当前工作目录的 ./skills 下。如果配置了 OpenClaw workspace,clawhub 会回退到该 workspace(除非你用 --workdir 或 CLAWHUB_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 logoutclawhub 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> --yesclawhub 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时的遥测。