快速开始

ClawHub 是 OpenClaw 技能和插件的注册中心。

向 OpenClaw 中安装内容时，请使用 OpenClaw。登录、发布、管理自己的条目或使用注册中心专属工作流时，请使用 clawhub CLI。

查找并安装技能

从 OpenClaw 中搜索：

openclaw skills search "calendar"

安装技能：

openclaw skills install @openclaw/demo

更新已安装的技能：

openclaw skills update --all

OpenClaw 会记录技能的来源，以便后续更新仍可通过 ClawHub 解析。

查找并安装插件

从 OpenClaw 中搜索：

openclaw plugins search "calendar"

使用明确的 ClawHub 来源安装 ClawHub 托管的插件：

openclaw plugins install clawhub:<package>

更新已安装的插件：

openclaw plugins update --all

如果希望 OpenClaw 通过 ClawHub 而非 npm 或其他来源解析软件包，请使用 clawhub: 前缀。

登录以进行发布

安装 ClawHub CLI：

npm i -g clawhub# 或pnpm add -g clawhub

使用 GitHub 登录：

clawhub loginclawhub whoami

无头环境可以使用 ClawHub Web UI 中的 API 令牌：

clawhub login --token clh_...

发布技能

技能是一个包含必需的 SKILL.md 文件和可选辅助文件的文件夹。

clawhub skill publish ./my-skill \  --slug my-skill \  --name "My Skill" \  --changelog "Initial release"

该命令会跳过未更改的内容。新技能从 1.0.0 开始；后续更改会自动发布下一个补丁版本。使用 --dry-run 进行预览，或使用 --version 选择明确的版本。

发布前，请检查 SKILL.md 中的元数据。声明所需的环境变量、工具和权限，以便用户在安装技能之前了解其要求。请参阅技能格式。

对于包含多个技能的仓库，可复用的 GitHub 工作流会为 skills/ 下的每个直接技能文件夹调用 skill publish：

jobs:  preview:    uses: openclaw/clawhub/.github/workflows/skill-publish.yml@main    with:      dry_run: true

发布插件

从本地文件夹、GitHub 仓库、GitHub 引用或现有归档发布插件：

clawhub package publish <source> --family code-plugin --dry-runclawhub package publish <source> --family code-plugin

先使用 --dry-run，以便在不发布的情况下预览解析后的软件包元数据、兼容性字段、来源归属和上传计划。

代码插件必须在 package.json 中包含 OpenClaw 兼容性元数据，包括 openclaw.compat.pluginApi 和 openclaw.build.openclawVersion。

安装前检查

安装前，请使用 ClawHub 网页或 CLI 详情命令检查元数据、源代码链接、版本、变更日志和扫描状态：

clawhub inspect @openclaw/democlawhub package inspect <package>

公开条目会显示最新的扫描状态。被审核流程暂扣或阻止的版本在问题解决前，可能不会显示在搜索和安装界面中。