Plugin

Gateway Plugin、フックパック、互換バンドルを管理します。

コマンド

openclaw plugins list [--enabled] [--verbose] [--json]openclaw plugins search <query> [--limit <n>] [--json]openclaw plugins install <path-or-spec> [--link] [--force] [--pin] [--marketplace <source>]openclaw plugins inspect <id> [--runtime] [--json]openclaw plugins inspect --all [--runtime] [--json]openclaw plugins info <id>                    # inspect のエイリアスopenclaw plugins enable <id>openclaw plugins disable <id>openclaw plugins uninstall <id> [--dry-run] [--keep-files] [--force]openclaw plugins update <id-or-npm-spec> | --all [--dry-run]openclaw plugins registry [--refresh] [--json]openclaw plugins doctoropenclaw plugins init <id> [--name <name>] [--type tool|provider] [--directory <path>]openclaw plugins build [--entry <path>] [--check]openclaw plugins validate [--entry <path>]openclaw plugins marketplace entries [--offline] [--feed-profile <name>] [--json]openclaw plugins marketplace list <source> [--json]openclaw plugins marketplace refresh [--feed-profile <name>] [--expected-sha256 <sha256>] [--json]

時間のかかるインストール、検査、アンインストール、またはレジストリ更新を調査する場合は、 OPENCLAW_PLUGIN_LIFECYCLE_TRACE=1 を付けてコマンドを実行します。トレースは各フェーズの所要時間を 標準エラー出力に書き込み、JSON 出力を解析可能な状態に保ちます。デバッグを参照してください。

作成

openclaw plugins init stock-quotes --name "Stock Quotes"cd stock-quotesnpm run plugin:buildnpm run plugin:validate

plugins init は、デフォルトで最小構成の TypeScript ツール Plugin を作成します。最初の 引数は Plugin ID で、--name は表示名を設定します。OpenClaw はこの ID をデフォルトの出力ディレクトリとパッケージ名に使用します。ツールのスキャフォールドは defineToolPlugin を使用し、openclaw plugins build/validate を呼び出す前にビルドする package.json スクリプト plugin:build と plugin:validate を生成します。

plugins build はビルド済みエントリをインポートし、その静的ツールメタデータを読み取り、 openclaw.plugin.json を書き込み、package.json の openclaw.extensions との整合性を維持します。 plugins validate は、生成されたマニフェスト、パッケージメタデータ、現在のエントリエクスポートが 引き続き一致していることを確認します。完全な作成ワークフローについては、 ツール Pluginを参照してください。

スキャフォールドは TypeScript ソースを書き込みますが、ビルド済みの ./dist/index.js エントリからメタデータを生成するため、このワークフローは公開済み CLI でも機能します。 エントリがデフォルトのパッケージエントリではない場合は --entry <path> を使用します。生成されたメタデータが古い場合に、 ファイルを書き換えず CI を失敗させるには plugins build --check を使用します。

プロバイダーのスキャフォールド

openclaw plugins init acme-models --name "Acme Models" --type providercd acme-modelsnpm installnpm run buildnpm testnpm run validate

プロバイダーのスキャフォールドは、API キー認証の基盤、clawhub package validate を実行する npm run validate スクリプト、ClawHub パッケージメタデータ、および将来 GitHub OIDC を介して信頼された公開を行うための手動実行 GitHub Actions ワークフローを備えた、汎用の OpenAI 互換モデルプロバイダー Plugin を作成します。プロバイダーのスキャフォールドは Skills を生成せず、 openclaw plugins build/validate も使用しません。これらのコマンドは、ツールスキャフォールドの生成メタデータパス用です。

公開する前に、プレースホルダーの API ベース URL、モデルカタログ、ドキュメントルート、認証情報のテキスト、および README の文面を実際のプロバイダーの詳細に置き換えてください。初回の ClawHub 公開と信頼された公開者の設定には、生成された README を使用してください。

インストール

openclaw plugins search "calendar"                      # ClawHub の Plugin を検索openclaw plugins install @openclaw/<package>            # 信頼された公式カタログopenclaw plugins install <package>                       # 任意の npm パッケージopenclaw plugins install clawhub:<package>                # ClawHub のみopenclaw plugins install npm:<package>                    # npm のみopenclaw plugins install npm-pack:<path.tgz>               # ローカルの npm-pack tarballopenclaw plugins install git:github.com/<owner>/<repo>     # git リポジトリopenclaw plugins install git:github.com/<owner>/<repo>@<ref>openclaw plugins install <path>                            # ローカルパスまたはアーカイブopenclaw plugins install -l <path>                         # コピーの代わりにリンクopenclaw plugins install <plugin>@<marketplace>             # マーケットプレイスの省略記法openclaw plugins install <plugin> --marketplace <name>      # マーケットプレイス（明示指定）openclaw plugins install <package> --force                  # ソースを確認／既存を上書きopenclaw plugins install <package> --pin                    # 解決された npm バージョンを固定openclaw plugins install clawhub:<package> --acknowledge-clawhub-riskopenclaw plugins install <package> --dangerously-force-unsafe-install

セットアップ時のインストールをテストするメンテナーは、保護された環境変数を使用して Plugin の自動インストールソースを上書きできます。Plugin インストールの上書きを参照してください。

plugins search は、インストール可能な code-plugin および bundle-plugin パッケージについて ClawHub に問い合わせます（Skills ではありません。Skills には openclaw skills search を使用してください）。 デフォルトの --limit は 20 で、上限は 100 です。リモートカタログの読み取りのみを行い、ローカル状態の検査、設定の変更、パッケージのインストール、Plugin ランタイムの読み込みは行いません。結果には、ClawHub パッケージ名、ファミリー、チャンネル、バージョン、概要、および openclaw plugins install clawhub:<package> のようなインストールヒントが含まれます。

ClawHub からのインストールでは、明示的な clawhub:<package> ロケーターを使用します。

openclaw plugins install clawhub:openclaw-codex-app-serveropenclaw plugins install clawhub:openclaw-codex-app-server@1.2.3

npm で安全に使用できるベア Plugin spec は、公式 Plugin ID と一致しない限り、ローンチ移行期間中はデフォルトで npm からインストールされます。

openclaw plugins install openclaw-codex-app-server

npm のみでの解決を明示するには npm: を使用してください。

openclaw plugins install npm:openclaw-codex-app-serveropenclaw plugins install npm:@openclaw/discord@2026.5.20openclaw plugins install npm:@scope/plugin-name@1.0.1

OpenClaw はインストール前に、公開されている Plugin API / Gateway の最小互換性を確認します。選択した ClawHub バージョンで ClawPack アーティファクトが公開されている場合、OpenClaw はバージョン付きの npm-pack .tgz をダウンロードし、ClawHub のダイジェストヘッダーとアーティファクトのダイジェストを検証してから、通常のアーカイブパスを通じてインストールします。ClawPack メタデータのない古い ClawHub バージョンは、引き続き従来のパッケージアーカイブ検証パスを通じてインストールされます。記録されるインストールには、後の更新に備えて、ClawHub のソースメタデータ、アーティファクトの種類、npm integrity、npm shasum、tarball 名、および ClawPack ダイジェスト情報が保持されます。 バージョンを指定しない ClawHub インストールでは、バージョン未指定の spec が記録されるため、openclaw plugins update はより新しい ClawHub リリースに追随できます。clawhub:pkg@1.2.3 や clawhub:pkg@beta のような明示的なバージョンまたはタグセレクターは、そのセレクターに固定されたままになります。

マーケットプレイスの省略記法

マーケットプレイス名が ~/.claude/plugins/known_marketplaces.json にある Claude のローカルレジストリキャッシュに存在する場合は、plugin@marketplace の省略記法を使用してください。

openclaw plugins marketplace list <marketplace-name>openclaw plugins install <plugin-name>@<marketplace-name>

マーケットプレイスのソースを明示的に渡すには --marketplace を使用してください。

openclaw plugins install <plugin-name> --marketplace <marketplace-name>openclaw plugins install <plugin-name> --marketplace <owner/repo>openclaw plugins install <plugin-name> --marketplace https://github.com/<owner>/<repo>openclaw plugins install <plugin-name> --marketplace ./my-marketplace

ローカルパスとアーカイブについて、OpenClaw は次を自動検出します。

• OpenClaw ネイティブ Plugin（openclaw.plugin.json）
• Codex 互換バンドル（.codex-plugin/plugin.json）
• Claude 互換バンドル（.claude-plugin/plugin.json、またはそのマニフェストファイルがない場合はデフォルトの Claude コンポーネントレイアウト）
• Cursor 互換バンドル（.cursor-plugin/plugin.json）

管理対象のローカルインストールは、Plugin ディレクトリまたはアーカイブでなければなりません。単独の .js、 .mjs、.cjs、および .ts Plugin ファイルは、plugins install によって管理対象の Plugin ルートへコピーされません。また、~/.openclaw/extensions または <workspace>/.openclaw/extensions に直接配置しても読み込まれません。これらの 自動検出ルートは Plugin パッケージまたはバンドルのディレクトリを読み込み、トップレベルのスクリプトファイルはローカルヘルパーとしてスキップします。代わりに、単独ファイルを plugins.load.paths に明示的に指定してください。

ローカル Plugin ディレクトリをコピーせずに参照するには、-l/--link を使用してください（ plugins.load.paths に追加されます）。

openclaw plugins install -l ./my-plugin

--link は --marketplace または git: インストールではサポートされず、 すでに存在するローカルパスが必要です。非対話型のローカルリンクでは、 ソースを確認した後に --force を渡してください。これは出所を確認しますが、リンク先ディレクトリを コピーまたは上書きしません。

一覧

openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --json

起動ログに plugins.allow is empty; discovered non-bundled plugins may auto-load: ... が記録された場合は、 openclaw plugins list --enabled --verbose、または一覧に表示されたプラグイン ID を指定して openclaw plugins inspect <id> を実行し、プラグイン ID を確認して、信頼できる ID を openclaw.json の plugins.allow にコピーします。警告に検出されたすべてのプラグインを一覧表示できる場合は、それらの ID がすでに含まれた、そのまま貼り付け可能な plugins.allow スニペットが出力されます。インストール元/ロードパスの来歴情報なしでプラグインがロードされる場合は、そのプラグイン ID を調査し、信頼できる ID を plugins.allow に固定するか、信頼できるソースからプラグインを再インストールして、OpenClaw にインストール元の来歴情報を記録させます。

パッケージ化された Docker イメージ内でバンドル済みプラグインを扱う場合は、プラグインのソースディレクトリを、 /app/extensions/synology-chat などの対応するパッケージ内ソースパスにバインドマウントします。OpenClaw は、そのマウントされたソースオーバーレイを /app/dist/extensions/synology-chat より前に検出します。単にコピーしたソースディレクトリは非アクティブなままなので、通常のパッケージインストールでは引き続きコンパイル済みの dist が使用されます。

ランタイムフックをデバッグする場合:

• openclaw plugins inspect <id> --runtime --json は、モジュールをロードする検査パスから登録済みのフックと診断を表示します。ランタイム検査で依存関係がインストールされることはありません。従来の依存関係状態をクリーンアップするか、設定から参照されている不足中のダウンロード可能なプラグインを復旧するには、openclaw doctor --fix を使用します。
• openclaw gateway status --deep --require-rpc は、到達可能な Gateway の URL/プロファイル、サービス/プロセスのヒント、設定パス、RPC の正常性を確認します。
• バンドルされていない会話フック（llm_input、llm_output、before_model_resolve、before_agent_reply、before_agent_run、before_agent_finalize、agent_end）には plugins.entries.<id>.hooks.allowConversationAccess=true が必要です。

プラグインインデックス

プラグインのインストールメタデータは機械管理される状態であり、ユーザー設定ではありません。インストールと更新では、アクティブな OpenClaw 状態ディレクトリ配下の共有 SQLite 状態データベースに書き込まれます。installed_plugin_index 行には、破損または欠落しているプラグインマニフェストのレコードを含む永続的な installRecords メタデータに加え、openclaw plugins update、アンインストール、診断、およびコールドプラグインレジストリで使用される、マニフェストから導出したコールドレジストリキャッシュが格納されます。

plugins.installs は廃止された手動設定サーフェスです。ランタイムおよび更新コマンドは、SQLite のインストール済みプラグインインデックスのみを読み取ります。通常のランタイム利用を開始する前に openclaw doctor --fix を実行し、従来の設定レコードをインデックスへインポートして、廃止されたキーを削除してください。

アンインストール

openclaw plugins uninstall <id>openclaw plugins uninstall <id> --dry-runopenclaw plugins uninstall <id> --keep-filesopenclaw plugins uninstall <id> --force

uninstall は、plugins.entries、永続化されたプラグインインデックス、プラグインの許可/拒否リストのエントリ、および該当する場合はリンクされた plugins.load.paths エントリからプラグインレコードを削除します。--keep-files が設定されていない限り、アンインストール時には追跡対象の管理インストールディレクトリも削除されますが、削除されるのは、そのディレクトリが OpenClaw のプラグイン拡張機能ルート内に解決される場合に限られます。プラグインが現在 memory または contextEngine スロットを所有している場合、そのスロットはデフォルト（メモリでは memory-core、コンテキストエンジンでは legacy）にリセットされます。

uninstall は削除対象のプレビューを表示し、変更を加える前に Uninstall plugin "<id>"? と確認を求めます。確認プロンプトを省略するには --force を渡します（スクリプトや非対話実行に便利です）。これを指定しない場合、アンインストールには対話型 TTY が必要です。--dry-run は同じプレビューを表示し、確認を求めたり変更を加えたりせずに終了します。

更新

openclaw plugins update <id-or-npm-spec>openclaw plugins update --allopenclaw plugins update <id-or-npm-spec> --dry-runopenclaw plugins update @openclaw/voice-callopenclaw plugins update @acme/demoopenclaw plugins update openclaw-codex-app-server --acknowledge-clawhub-riskopenclaw plugins update openclaw-codex-app-server --dangerously-force-unsafe-install

更新は、管理対象プラグインインデックスで追跡されているプラグインのインストールと、共有 SQLite 状態で追跡されているフックパックのインストールに適用されます。プラグインのインストール時にユーザーがすでに選択したソースを再利用するため、ソースについて再度確認する必要はありません。

検査

openclaw plugins inspect <id>openclaw plugins inspect <id> --runtimeopenclaw plugins inspect <id> --jsonopenclaw plugins inspect --all

デフォルトではプラグインランタイムをインポートせずに、識別情報、ロード状態、ソース、マニフェストの機能、ポリシーフラグ、診断、インストールメタデータ、バンドル機能、および検出された MCP または LSP サーバーのサポートを表示します。JSON 出力には contracts.agentToolResultMiddleware や contracts.trustedToolPolicies などのプラグインマニフェスト契約が含まれるため、オペレーターはプラグインを有効化または再起動する前に、信頼対象サーフェスの宣言を監査できます。--runtime を追加すると、プラグインモジュールがロードされ、登録済みのフック、ツール、コマンド、サービス、Gateway メソッド、および HTTP ルートが含まれます。ランタイム検査では、不足しているプラグイン依存関係が直接報告されます。インストールと修復は、引き続き openclaw plugins install、openclaw plugins update、および openclaw doctor --fix で行います。

プラグイン所有の CLI コマンドは通常、ルートの openclaw コマンドグループとしてインストールされますが、プラグインは openclaw nodes などのコアの親コマンド配下にネストされたコマンドを登録することもできます。inspect --runtime で cliCommands 配下にコマンドが表示されたら、表示されたパスで実行します。たとえば、demo-git を登録するプラグインは、openclaw demo-git ping で検証できます。

各プラグインは、ランタイムで実際に登録する内容に基づいて分類されます。

機能モデルの詳細については、プラグインの形態を参照してください。

Doctor

openclaw plugins doctor

doctor は、Plugin の読み込みエラー、マニフェスト／検出の診断、互換性に関する通知、および欠落した Plugin スロットなどの古い Plugin 設定参照を報告します。インストールツリーと Plugin 設定に問題がなければ、No plugin issues detected. と出力されます。古い設定が残っているものの、インストールツリーがそれ以外は正常な場合、概要では Plugin が完全に正常であると示唆せず、その状態を明示します。

設定済みの Plugin がディスク上に存在していても、ローダーのパス安全性チェックによってブロックされている場合、設定検証は Plugin エントリを維持し、present but blocked として報告します。plugins.entries.<id> または plugins.allow の設定を削除するのではなく、パスの所有権や全ユーザー書き込み可能な権限など、先に表示されたブロック済み Plugin の診断内容を修正してください。

register/activate エクスポートの欠落など、モジュール形状のエラーについては、OPENCLAW_PLUGIN_LOAD_DEBUG=1 を指定して再実行すると、診断出力にエクスポート形状の簡潔な概要が含まれます。

レジストリ

openclaw plugins registryopenclaw plugins registry --refreshopenclaw plugins registry --json

ローカル Plugin レジストリは、インストール済み Plugin の識別情報、有効化状態、ソースメタデータ、およびコントリビューションの所有権に関する、OpenClaw の永続化されたコールドリードモデルです。通常の起動、プロバイダー所有者の検索、チャネル設定の分類、Plugin インベントリでは、Plugin のランタイムモジュールをインポートせずにこのレジストリを読み取れます。

plugins registry を使用して、永続化されたレジストリが存在するか、最新か、古くなっているかを確認します。--refresh を使用すると、永続化された Plugin インデックス、設定ポリシー、マニフェスト／パッケージメタデータからレジストリを再構築できます。これは修復手段であり、ランタイムを有効化する手段ではありません。

openclaw doctor --fix は、レジストリ周辺の管理対象 npm の不整合も修復します。管理対象 Plugin の npm プロジェクトまたは従来のフラットな管理対象 npm ルートにある、孤立または復元された @openclaw/* パッケージがバンドル済み Plugin を覆い隠している場合、doctor はその古いパッケージを削除し、起動時にバンドル済みマニフェストを基準として検証されるようにレジストリを再構築します。信頼できるインストールレコードが管理対象の世代を1つ選択していても、古いフラットディレクトリや世代ディレクトリが残っている場合、doctor は Gateway の再起動後に剪定できるよう、それらの古いツリーを廃止対象にします。また doctor は、peerDependencies.openclaw を宣言する管理対象 npm Plugin にホストの openclaw パッケージを再リンクし、更新または npm 修復後も openclaw/plugin-sdk/* などのパッケージローカルなランタイムインポートが解決されるようにします。

マーケットプレイス

openclaw plugins marketplace entriesopenclaw plugins marketplace entries --offlineopenclaw plugins marketplace entries --jsonopenclaw plugins marketplace entries --feed-profile <name>openclaw plugins marketplace entries --feed-url <url>openclaw plugins marketplace list <source>openclaw plugins marketplace list <source> --jsonopenclaw plugins marketplace refreshopenclaw plugins marketplace refresh --feed-profile <name>openclaw plugins marketplace refresh --feed-url <url>openclaw plugins marketplace refresh --expected-sha256 <sha256> --json

plugins marketplace entries は、設定された OpenClaw マーケットプレイスフィードのエントリを一覧表示します。デフォルトではホストされたフィードの取得を試み、取得できない場合は、最後に受理されたスナップショットまたはバンドル済みデータへフォールバックします。特定の設定済みプロファイルを読み取るには --feed-profile <name>、明示的なホスト済みフィード URL を読み取るには --feed-url <url>、フィードを取得せずに最後に受理されたスナップショットを読み取るには --offline を使用します。

plugins marketplace refresh は、設定されたホスト済みフィードのスナップショットを更新し、OpenClaw がホスト済みデータ、ホスト済みスナップショット、バンドル済みフォールバックデータのいずれを受理したかを報告します。固定されたチェックサムに一致する新しいホスト済みペイロードが得られない限りコマンドを失敗させる必要がある場合は、--expected-sha256 を使用します。

マーケットプレイスの list は、ローカルマーケットプレイスのパス、marketplace.json パス、owner/repo のような GitHub 短縮表記、GitHub リポジトリ URL、または git URL を受け付けます。--json は、解決されたソースラベルと、解析されたマーケットプレイスマニフェストおよび Plugin エントリを出力します。

マーケットプレイスの更新では、ホストされた OpenClaw マーケットプレイスフィードを読み込み、 検証済みのレスポンスをローカルのホスト済みフィードスナップショットとして永続化します。オプションを指定しない場合は、 設定されたデフォルトのフィードプロファイルを使用します。特定の設定済みプロファイルを 更新するには --feed-profile <name>、明示的なホスト済み フィード URL を更新するには --feed-url <url>、一致するペイロードチェックサム （sha256:<hex> または64文字の16進ダイジェストのみ）を必須にするには --expected-sha256 <sha256>、 機械可読出力には --json を使用します。明示的なホスト済みフィード URL に 認証情報、クエリ文字列、フラグメントを含めてはなりません。固定しない更新では、 コマンドを失敗させずにホスト済みスナップショットまたはバンドル済みフォールバックの結果を 報告できます。固定した更新は、新しいホスト済みペイロードを受理した場合にのみ成功し、 ホスト済みデータの更新に成功しても、OpenClaw が検証済みスナップショットを永続化できない場合は 失敗します。

組み込みの clawhub-public プロファイルでは、ペイロードの識別情報として clawhub-official が想定されています。ClawHub が本番環境用の公開鍵を生成して 引き渡した後、OpenClaw はその鍵をバンドルします。それまでは、組み込みプロファイルに 署名付きフィードからインストールする権限はありません。公開鍵は、フィードホスト上の 鍵エンドポイントではなく、信頼できるリリースまたは運用者のチャネルから取得する必要があります。

OpenClaw は DSSE エンベロープを検証し、プロファイルで feedId が宣言されている場合は、 デコードされたペイロード ID がそれに一致することを要求します。組み込みの clawhub-public プロファイルでは常に識別情報が宣言されるため、別のフィード用の有効なドキュメントが そのプロファイルを介して再利用されることを防ぎます。

段階的な展開中は、feedId を省略している既存のカスタム署名付きプロファイルで、 ペイロード識別情報とのバインドなしの署名検証が維持されます。新しいカスタム プロファイルでは feedId を宣言する必要があります。フィードプロファイルの設定項目は、 Control UI に必要な表示メタデータとともに別途導入されます。その Doctor 診断では、識別情報が欠落している場合に運用者へ入力を求める必要があり、 フィード URL から推測してはなりません。この信頼バインドによって、廃止された ルートの marketplaces キーが復元されることはありません。

関連項目

• Plugin の構築
• CLI リファレンス
• ClawHub