クイックスタート

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 に npm や別のソースではなく ClawHub 経由でパッケージを解決させたい場合は、clawhub: プレフィックスを使います。

公開のためにサインインする

ClawHub CLI をインストールします。

npm i -g clawhub# orpnpm 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 ref、または既存のアーカイブからプラグインを公開します。

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

公開せずに、解決されたパッケージメタデータ、互換性フィールド、ソースの帰属、アップロード計画をプレビューするには、先に --dry-run を使います。

コードプラグインでは、openclaw.compat.pluginApi と openclaw.build.openclawVersion を含む OpenClaw 互換性メタデータを package.json に含める必要があります。

インストール前に確認する

インストールする前に、ClawHub の Web ページまたは CLI の詳細コマンドを使って、メタデータ、ソースリンク、バージョン、変更履歴、スキャン状態を確認します。

clawhub inspect @openclaw/democlawhub package inspect <package>

公開リスティングには最新のスキャン状態が表示されます。モデレーションにより保留またはブロックされているリリースは、解決されるまで検索やインストールの画面に表示されない場合があります。