はじめに
ClawHub
ClawHub
ClawHub は、OpenClaw の Skills と plugins の公開レジストリです。
- ネイティブの
openclawコマンドを使用して、Skills の検索、インストール、更新、および ClawHub からの plugins のインストールを行います。 - レジストリの認証、公開、および削除/削除取り消しのワークフローには、別個の
clawhubCLI を使用します。
サイト: clawhub.ai
クイックスタート
OpenClaw で Skills を検索してインストールします。
openclaw skills search "calendar"openclaw skills install @openclaw/demoopenclaw skills update --allOpenClaw で plugins を検索してインストールします。
openclaw plugins search "calendar"openclaw plugins install clawhub:<package>openclaw plugins update --all公開や削除/削除取り消しなど、レジストリ認証が必要なワークフローを使用する場合は、ClawHub CLI をインストールします。
npm i -g clawhub# またはpnpm add -g clawhubClawHub がホストするもの
| サーフェス | 保存するもの | 代表的なコマンド |
|---|---|---|
| Skills | SKILL.md と補助ファイルを含むバージョン管理されたテキストバンドル |
openclaw skills install @openclaw/demo |
| コード plugins | 互換性メタデータを含む OpenClaw plugin パッケージ | openclaw plugins install clawhub:<package> |
| バンドル plugins | OpenClaw 配布用にパッケージ化された plugin バンドル | clawhub package publish <source> |
ClawHub は、semver バージョン、latest などのタグ、変更履歴、ファイル、ダウンロード数、スター数、セキュリティスキャンの概要を追跡します。公開ページには現在のレジストリ状態が表示されるため、ユーザーはインストール前に Skill や plugin を確認できます。
ネイティブ OpenClaw フロー
ネイティブ OpenClaw コマンドは、アクティブな OpenClaw ワークスペースにインストールし、後続の更新コマンドが引き続き ClawHub を使用できるようにソースメタデータを永続化します。
plugin のインストールを ClawHub 経由で解決する必要がある場合は、clawhub:<package> を使用します。ベア形式の npm-safe plugin 指定は、リリース切り替え時に npm 経由で解決される場合があります。ソースを明示する必要がある場合、npm:<package> は引き続き npm 専用です。
plugin のインストールでは、アーカイブのインストールを実行する前に、提示された pluginApi および minGatewayVersion の互換性を検証します。パッケージバージョンで ClawPack アーティファクトが公開されている場合、OpenClaw はアップロードされた npm-pack の .tgz と完全に一致するものを優先し、ClawHub のダイジェストヘッダーとダウンロードされたバイト列を検証して、後続の更新用にアーティファクトのメタデータを記録します。
ClawHub CLI
ClawHub CLI は、レジストリ認証が必要な作業に使用します。
clawhub loginclawhub whoamiclawhub search "postgres backups"clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0clawhub package explore --family code-pluginclawhub package inspect episodic-clawclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginCLI には、レジストリを直接使用するワークフロー向けの Skill インストール/更新コマンドもあります。
clawhub install @openclaw/democlawhub update @openclaw/democlawhub update --allclawhub listこれらのコマンドは、現在の作業ディレクトリにある ./skills に Skills をインストールし、インストール済みバージョンを .clawhub/lock.json に記録します。
公開
SKILL.md を含むローカルフォルダーから Skills を公開します。
clawhub skill publish <path>一般的な公開オプション:
--slug <slug>: 公開される Skill の URL 名。--name <name>: 表示名。--version <version>: semver バージョン。--changelog <text>: 変更履歴のテキスト。--tags <tags>: カンマ区切りのタグ。デフォルトはlatest。
ローカルフォルダー、owner/repo、owner/repo@ref、または GitHub URL から plugins を公開します。
clawhub package publish <source>アップロードせずに正確な公開計画を作成するには --dry-run を使用し、CI 向けの出力には --json を使用します。
コード plugins では、package.json に必要な OpenClaw 互換性メタデータ(openclaw.compat.pluginApi および openclaw.build.openclawVersion を含む)を指定する必要があります。コマンドの完全なリファレンスについては CLI、Skill メタデータについては Skill 形式を参照してください。
セキュリティとモデレーション
ClawHub はデフォルトでオープンです。誰でもアップロードできますが、公開にはアップロード要件を満たす作成後一定期間が経過した GitHub アカウントが必要です。公開詳細ページには、インストールまたはダウンロードの前に最新のスキャン状態の概要が表示されます。
ClawHub は、公開された Skills と plugin リリースに対して自動チェックを実行します。スキャンによって保留またはブロックされたリリースは、/dashboard では所有者に引き続き表示されますが、公開カタログやインストール画面からは表示されなくなる場合があります。
サインイン済みのユーザーは、Skills とパッケージを報告できます。モデレーターは、報告の確認、コンテンツの非表示または復元、不正利用を行うアカウントの禁止を実行できます。ポリシーと適用の詳細については、セキュリティ、セキュリティ監査、モデレーションとアカウントの安全性、許容される使用方法を参照してください。
テレメトリと環境
ログイン中に clawhub install を実行すると、ClawHub がインストール数の集計値を算出できるよう、CLI がベストエフォートでインストールイベントを送信する場合があります。無効にするには、次のように設定します。
export CLAWHUB_DISABLE_TELEMETRY=1便利な環境オーバーライド:
| 変数 | 効果 |
|---|---|
CLAWHUB_SITE |
ブラウザログインに使用するサイト URL を上書きします。 |
CLAWHUB_REGISTRY |
レジストリ API の URL を上書きします。 |
CLAWHUB_CONFIG_PATH |
CLI がトークン/設定状態を保存する場所を上書きします。 |
CLAWHUB_WORKDIR |
デフォルトの作業ディレクトリを上書きします。 |
CLAWHUB_DISABLE_TELEMETRY=1 |
インストールテレメトリを無効にします。 |
さらに詳しいリファレンスについては、テレメトリ、HTTP API、トラブルシューティングを参照してください。