Skills

ClawHub

ClawHub は OpenClaw の Skills と plugins の公開レジストリです。

  • ネイティブの openclaw コマンドを使って Skills の検索、インストール、更新を行い、ClawHub から plugins をインストールします。
  • レジストリ認証、公開、削除/削除解除、同期ワークフローには、別個の clawhub CLI を使います。

サイト: clawhub.ai

クイックスタート

  • 検索

    openclaw skills search "calendar"
    
  • インストール

    openclaw skills install <skill-slug>
    
  • 使用

    新しい OpenClaw セッションを開始します。新しい skill が読み込まれます。

  • 公開 (任意)

    レジストリ認証済みワークフロー (公開、同期、管理) には、別個の clawhub CLI をインストールします。

    npm i -g clawhub
    # or
    pnpm add -g clawhub
    
  • ネイティブ OpenClaw フロー

    Skills

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

    ネイティブの openclaw コマンドはアクティブなワークスペースにインストールし、ソースメタデータを保持するため、後続の update 呼び出しで ClawHub を使い続けられます。

    Plugins

    openclaw plugins search "calendar"
    openclaw plugins install clawhub:<package>
    openclaw plugins update --all
    

    plugins search は ClawHub plugin カタログを照会し、すぐにインストールできるパッケージ名を出力します。ClawHub の解決を使いたい場合は clawhub:<package> を使います。ローンチ移行期間中、npm で安全な plugin 指定をそのまま使うと npm からインストールされます。

    openclaw plugins install openclaw-codex-app-server
    

    npm:<package> も npm 専用で、指定が曖昧になり得る場合に便利です。

    openclaw plugins install npm:openclaw-codex-app-server
    

    Plugin のインストールでは、アーカイブインストールの実行前に、公開されている pluginApiminGatewayVersion の互換性を検証します。そのため、互換性のないホストはパッケージを部分的にインストールするのではなく、早期に fail closed します。パッケージバージョンが ClawPack アーティファクトを公開している場合、OpenClaw はアップロードされた正確な npm-pack .tgz を優先し、ClawHub ダイジェストヘッダーとダウンロード済みバイトを検証し、アーティファクト種別、npm integrity、npm shasum、tarball 名、ClawPack ダイジェストメタデータを後続の更新用に記録します。ClawPack メタデータがない古いパッケージバージョンは、引き続き従来のパッケージアーカイブ検証パスを使います。

    ClawHub とは

    • OpenClaw の Skills と plugins の公開レジストリ。
    • skill バンドルとメタデータのバージョン管理されたストア。
    • 検索、タグ、利用シグナルのための発見サーフェス。

    一般的な skill は、次を含むファイルのバージョン管理されたバンドルです。

    • 主な説明と使用方法を含む SKILL.md ファイル。
    • skill が使用する任意の設定、スクリプト、またはサポートファイル。
    • タグ、概要、インストール要件などのメタデータ。

    ClawHub はメタデータを使って発見機能を支え、skill の機能を安全に公開します。レジストリは利用シグナル (スター、ダウンロード) を追跡して、ランキングと可視性を向上させます。公開のたびに新しい semver バージョンが作成され、レジストリはバージョン履歴を保持するため、ユーザーは変更を監査できます。

    ワークスペースと skill の読み込み

    別個の clawhub CLI も、現在の作業ディレクトリ配下の ./skills に Skills をインストールします。OpenClaw ワークスペースが設定されている場合、clawhub--workdir (または CLAWHUB_WORKDIR) で上書きしない限り、そのワークスペースへフォールバックします。OpenClaw は <workspace>/skills からワークスペース Skills を読み込み、次回のセッションでそれらを反映します。

    すでに ~/.openclaw/skills またはバンドルされた Skills を使用している場合、ワークスペース Skills が優先されます。Skills の読み込み、共有、ゲート制御の詳細については、Skills を参照してください。

    サービス機能

    機能 注記
    公開ブラウズ Skills とその SKILL.md 内容は公開で閲覧できます。
    検索 キーワードだけでなく、埋め込みベース (ベクトル検索) です。
    バージョニング Semver、変更履歴、タグ (latest を含む)。
    ダウンロード バージョンごとの zip。
    スターとコメント コミュニティのフィードバック。
    セキュリティスキャン概要 詳細ページに、インストールまたはダウンロード前の最新スキャン状態が表示されます。
    スキャナー詳細ページ VirusTotal、ClawScan、静的解析結果にはディープリンクがあります。
    所有者復旧ダッシュボード 公開者は /dashboard からスキャンで保留された所有コンテンツを確認できます。
    所有者リクエストの再スキャン 所有者は誤検知からの復旧のため、制限付きの再スキャンをリクエストできます。
    モデレーション 承認と監査。
    CLI 向け API 自動化とスクリプトに適しています。

    セキュリティとモデレーション

    ClawHub はデフォルトでオープンです。誰でも Skills をアップロードできますが、公開するには GitHub アカウントが少なくとも 1 週間前に作成されている必要があります。これにより、正当なコントリビューターを妨げることなく悪用を遅らせます。

    セキュリティスキャン

    ClawHub は公開された Skills と plugin リリースに対して自動セキュリティチェックを実行します。公開詳細ページには現在の結果が要約され、スキャナー行は VirusTotal、ClawScan、静的解析の専用詳細ページにリンクします。

    スキャンで保留またはブロックされたリリースは、所有者には /dashboard で引き続き表示される一方で、公開カタログやインストールサーフェスでは利用できない場合があります。

    報告
    • サインイン済みのユーザーは誰でも skill を報告できます。
    • 報告理由は必須で、記録されます。
    • 各ユーザーは同時に最大 20 件のアクティブな報告を保持できます。
    • 3 件を超える一意の報告がある Skills は、デフォルトで自動的に非表示になります。
    モデレーション
    • モデレーターは非表示の Skills を表示し、再表示、削除、またはユーザーの禁止を行えます。
    • 報告機能を悪用すると、アカウント禁止につながる可能性があります。
    • モデレーターになることに関心がありますか? OpenClaw Discord で質問し、モデレーターまたはメンテナーに連絡してください。

    ClawHub CLI

    これは、公開/同期などのレジストリ認証済みワークフローにのみ必要です。

    グローバルオプション

    "--workdir
    "--dir
    "--site
    "--registry
    --no-inputboolean

    プロンプトを無効化します (非対話)。

    -V, --cli-versionboolean

    CLI バージョンを出力します。

    コマンド

    認証 (ログイン / ログアウト / whoami)
    clawhub login              # browser flow
    clawhub login --token <token>
    clawhub logout
    clawhub whoami
    

    ログインオプション:

    • --token <token> - API トークンを貼り付けます。
    • --label <label> - ブラウザログイン用トークンに保存されるラベル (デフォルト: CLI token)。
    • --no-browser - ブラウザを開きません (--token が必要)。
    検索
    clawhub search "query"
    

    Skills を検索します。plugin/package の発見には clawhub package explore を使います。

    • --limit <n> - 最大結果数。
    Plugins のブラウズ / 検査
    clawhub package explore --family code-plugin
    clawhub package explore "episodic-claw" --family code-plugin
    clawhub package inspect episodic-claw
    

    package explorepackage inspect は、plugin/package の発見とメタデータ検査のための ClawHub CLI サーフェスです。ネイティブの OpenClaw インストールでは、引き続き openclaw plugins install clawhub:<package> を使います。

    オプション:

    • --family skill|code-plugin|bundle-plugin - パッケージファミリーでフィルターします。
    • --official - 公式パッケージのみを表示します。
    • --executes-code - コードを実行するパッケージのみを表示します。
    • --version <version> / --tag <tag> - 特定のパッケージバージョンを検査します。
    • --versions, --files, --file <path> - パッケージ履歴とファイルを検査します。
    • --json - 機械可読な出力。
    インストール / 更新 / 一覧
    clawhub install <slug>
    clawhub update <slug>
    clawhub update --all
    clawhub list
    

    オプション:

    • --version <version> - 特定のバージョンをインストールまたは更新します (update では単一 slug のみ)。
    • --force - フォルダーがすでに存在する場合、またはローカルファイルが公開済みバージョンのどれとも一致しない場合に上書きします。
    • clawhub list.clawhub/lock.json を読み取ります。
    Skills の公開
    clawhub skill publish <path>
    

    オプション:

    • --slug <slug> - skill slug。
    • --name <name> - 表示名。
    • --version <version> - semver バージョン。
    • --changelog <text> - 変更履歴テキスト (空でも可)。
    • --tags <tags> - カンマ区切りのタグ (デフォルト: latest)。
    Plugins の公開
    clawhub package publish <source>
    

    <source> には、ローカルフォルダー、owner/repoowner/repo@ref、または GitHub URL を指定できます。

    オプション:

    • --dry-run - 何もアップロードせず、正確な公開計画を作成します。
    • --json - CI 向けに機械可読な出力を出力します。
    • --source-repo, --source-commit, --source-ref - 自動検出だけでは不十分な場合の任意の上書き。
    再スキャンのリクエスト
    clawhub skill rescan <slug>
    clawhub skill rescan <slug> --yes --json
    
    clawhub package rescan <name>
    clawhub package rescan <name> --yes --json
    

    再スキャンコマンドには、ログイン済みの所有者トークンが必要で、最新の公開済み skill バージョンまたは plugin リリースを対象にします。非対話実行では --yes を渡します。

    JSON レスポンスには、対象の種別、名前、バージョン、再スキャン状態、およびそのバージョンまたはリリースの残り/最大リクエスト数が含まれます。

    削除 / 削除解除 (所有者または管理者)
    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)。

    一般的なワークフロー

    検索

    clawhub search "postgres backups"
    

    Plugin を探す

    clawhub package explore --family code-plugin
    clawhub package explore "memory" --family code-plugin
    clawhub package inspect episodic-claw
    

    インストール

    clawhub install my-skill-pack
    

    すべて更新

    clawhub update --all
    

    単一の skill を公開

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

    多数の Skills を同期

    clawhub sync --all
    

    GitHub から Plugin を公開

    clawhub package publish your-org/your-plugin --dry-run
    clawhub package publish your-org/your-plugin
    clawhub package publish your-org/[email protected]
    clawhub package publish https://github.com/your-org/your-plugin
    

    Plugin パッケージメタデータ

    コード Plugin は、必須の OpenClaw メタデータを package.json に含める必要があります。

    {
      "name": "@myorg/openclaw-my-plugin",
      "version": "1.0.0",
      "type": "module",
      "openclaw": {
        "extensions": ["./src/index.ts"],
        "runtimeExtensions": ["./dist/index.js"],
        "compat": {
          "pluginApi": ">=2026.3.24-beta.2",
          "minGatewayVersion": "2026.3.24-beta.2"
        },
        "build": {
          "openclawVersion": "2026.3.24-beta.2",
          "pluginSdkVersion": "2026.3.24-beta.2"
        }
      }
    }
    

    公開済みパッケージは ビルド済み JavaScript を同梱し、 runtimeExtensions がその出力を指すようにしてください。Git checkout インストールでは、ビルド済みファイルが存在しない場合でも TypeScript ソースにフォールバックできますが、ビルド済みランタイムエントリにすると、起動、doctor、Plugin 読み込みパスでのランタイム TypeScript コンパイルを避けられます。

    バージョニング、lockfile、テレメトリ

    バージョニングとタグ
    • 各公開は新しい semver SkillVersion を作成します。
    • タグ(latest など)はバージョンを指します。タグを移動するとロールバックできます。
    • 変更履歴はバージョンごとに添付され、更新の同期や公開時には空でもかまいません。
    ローカル変更とレジストリバージョン

    更新では、コンテンツハッシュを使用してローカルの skill 内容をレジストリバージョンと比較します。ローカルファイルが公開済みバージョンのいずれにも一致しない場合、CLI は上書き前に確認します(または非対話実行では --force が必要です)。

    同期スキャンとフォールバックルート

    clawhub sync は最初に現在の作業ディレクトリをスキャンします。Skills が見つからない場合は、既知のレガシー場所(たとえば ~/openclaw/skills~/.openclaw/skills)にフォールバックします。これは、追加のフラグなしで古い skill インストールを見つけるように設計されています。

    ストレージと lockfile
    • インストール済み Skills は、作業ディレクトリ配下の .clawhub/lock.json に記録されます。
    • 認証トークンは ClawHub CLI 設定ファイルに保存されます(CLAWHUB_CONFIG_PATH で上書きできます)。
    テレメトリ(インストール数)

    ログイン中に clawhub sync を実行すると、CLI はインストール数を計算するための最小限のスナップショットを送信します。これは完全に無効化できます。

    export CLAWHUB_DISABLE_TELEMETRY=1
    

    環境変数

    変数 効果
    CLAWHUB_SITE サイト URL を上書きします。
    CLAWHUB_REGISTRY レジストリ API URL を上書きします。
    CLAWHUB_CONFIG_PATH CLI がトークン/設定を保存する場所を上書きします。
    CLAWHUB_WORKDIR 既定の作業ディレクトリを上書きします。
    CLAWHUB_DISABLE_TELEMETRY=1 sync のテレメトリを無効化します。

    関連