Plugin

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

# コマンド

openclaw plugins list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw plugins list --json
openclaw plugins search <query>
openclaw plugins search <query> --limit 20
openclaw plugins search <query> --json
openclaw plugins install <path-or-spec>
openclaw plugins inspect <id>
openclaw plugins inspect <id> --runtime
openclaw plugins inspect <id> --json
openclaw plugins inspect --all
openclaw plugins info <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins registry
openclaw plugins registry --refresh
openclaw plugins uninstall <id>
openclaw plugins doctor
openclaw plugins update <id-or-npm-spec>
openclaw plugins update --all
openclaw plugins marketplace list <marketplace>
openclaw plugins marketplace list <marketplace> --json

遅いインストール、検査、アンインストール、またはレジストリ更新の調査では、OPENCLAW_PLUGIN_LIFECYCLE_TRACE=1 を付けてコマンドを実行します。トレースはフェーズごとのタイミングを stderr に書き込み、JSON 出力を解析可能なままにします。デバッグを参照してください。

# インストール

openclaw plugins search "calendar"                   # search ClawHub plugins
openclaw plugins install <package>                      # npm by default
openclaw plugins install clawhub:<package>              # ClawHub only
openclaw plugins install npm:<package>                  # npm only
openclaw plugins install npm-pack:<path.tgz>            # local npm pack through npm install semantics
openclaw plugins install git:github.com/<owner>/<repo>  # git repo
openclaw plugins install git:github.com/<owner>/<repo>@<ref>
openclaw plugins install <package> --force              # overwrite existing install
openclaw plugins install <package> --pin                # pin version
openclaw plugins install <package> --dangerously-force-unsafe-install
openclaw plugins install <path>                         # local path
openclaw plugins install <plugin>@<marketplace>         # marketplace
openclaw plugins install <plugin> --marketplace <name>  # marketplace (explicit)
openclaw plugins install <plugin> --marketplace https://github.com/<owner>/<repo>

plugins search は、インストール可能な Plugin パッケージを ClawHub に問い合わせ、インストール可能なパッケージ名を出力します。検索対象は code-plugin パッケージと bundle-plugin パッケージであり、Skills ではありません。ClawHub Skills には openclaw skills search を使用してください。

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

openclaw plugins install clawhub:openclaw-codex-app-server
openclaw plugins install clawhub:[email protected]

ローンチ切り替え期間中、裸の npm-safe Plugin spec はデフォルトで npm からインストールされます。

openclaw plugins install openclaw-codex-app-server

npm のみの解決を明示するには npm: を使用します。

openclaw plugins install npm:openclaw-codex-app-server
openclaw plugins install npm:@scope/[email protected]

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

# マーケットプレイス短縮表記

マーケットプレイス名が Claude のローカルレジストリキャッシュ ~/.claude/plugins/known_marketplaces.json に存在する場合は、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 Plugins (openclaw.plugin.json)
• Codex 互換バンドル (.codex-plugin/plugin.json)
• Claude 互換バンドル (.claude-plugin/plugin.json またはデフォルトの Claude コンポーネントレイアウト)
• Cursor 互換バンドル (.cursor-plugin/plugin.json)

# 一覧

openclaw plugins list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw plugins list --json
openclaw plugins search <query>
openclaw plugins search <query> --limit 20
openclaw plugins search <query> --json

--enabledboolean

有効な Plugins のみを表示します。

--verboseboolean

テーブルビューから、ソース/出所/バージョン/アクティベーションメタデータを含む Plugin ごとの詳細行に切り替えます。

--jsonboolean

機械可読のインベントリに加え、レジストリ診断とパッケージ依存関係のインストール状態を出力します。

plugins search はリモート ClawHub カタログ検索です。ローカル状態の検査、config の変更、パッケージのインストール、Plugin ランタイムコードの読み込みは行いません。検索結果には、ClawHub パッケージ名、ファミリー、チャネル、バージョン、概要、および openclaw plugins install clawhub:<package> などのインストールヒントが含まれます。

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

ランタイム hook のデバッグには次を使用します。

• openclaw plugins inspect <id> --runtime --json は、モジュール読み込みの検査パスから登録済み hooks と診断を表示します。ランタイム検査は依存関係をインストールしません。従来の依存関係状態を整理したり、config で参照されている不足したダウンロード可能 Plugins を復旧したりするには、openclaw doctor --fix を使用してください。
• openclaw gateway status --deep --require-rpc は、到達可能な Gateway、サービス/プロセスのヒント、config パス、RPC ヘルスを確認します。
• 非バンドル会話 hooks (llm_input, llm_output, before_model_resolve, before_agent_reply, before_agent_run, before_agent_finalize, agent_end) には plugins.entries.<id>.hooks.allowConversationAccess=true が必要です。

ローカルディレクトリのコピーを避けるには --link を使用します (plugins.load.paths に追加されます)。

openclaw plugins install -l ./my-plugin

# Plugin インデックス

Plugin インストールメタデータは、ユーザー config ではなく機械管理の状態です。インストールと更新は、アクティブな OpenClaw 状態ディレクトリ配下の plugins/installs.json にこれを書き込みます。そのトップレベルの installRecords マップは、壊れている、または欠落している Plugin マニフェストのレコードを含む、インストールメタデータの永続的なソースです。plugins 配列は、マニフェストから導出されたコールドレジストリキャッシュです。このファイルには編集禁止の警告が含まれ、openclaw plugins update、アンインストール、診断、コールド Plugin レジストリで使用されます。

OpenClaw が config 内に出荷済みの従来の plugins.installs レコードを見つけた場合、ランタイム読み取りはそれらを openclaw.json を書き換えずに互換性入力として扱います。明示的な Plugin 書き込みと openclaw doctor --fix は、config 書き込みが許可されている場合にそれらのレコードを Plugin インデックスへ移動し、config キーを削除します。どちらかの書き込みが失敗した場合、インストールメタデータが失われないように config レコードは保持されます。

# アンインストール

openclaw plugins uninstall <id>
openclaw plugins uninstall <id> --dry-run
openclaw plugins uninstall <id> --keep-files

uninstall は、該当する場合に plugins.entries、永続化された Plugin インデックス、Plugin allow/deny list エントリ、リンクされた plugins.load.paths エントリから Plugin レコードを削除します。--keep-files が設定されていない限り、アンインストールは OpenClaw の Plugin extensions ルート内にある追跡対象の管理インストールディレクトリも削除します。Active Memory Plugins では、memory slot が memory-core にリセットされます。

# 更新

openclaw plugins update <id-or-npm-spec>
openclaw plugins update --all
openclaw plugins update <id-or-npm-spec> --dry-run
openclaw plugins update @openclaw/voice-call
openclaw plugins update openclaw-codex-app-server --dangerously-force-unsafe-install

更新は、管理対象 Plugin インデックスで追跡されている Plugin インストールと、hooks.internal.installs で追跡されている hook-pack インストールに適用されます。

# 検査

openclaw plugins inspect <id>
openclaw plugins inspect <id> --runtime
openclaw plugins inspect <id> --json

Inspect はデフォルトでは Plugin ランタイムをインポートせずに、ID、読み込み状態、ソース、マニフェスト機能、ポリシーフラグ、診断、インストールメタデータ、バンドル機能、および検出された MCP または LSP server サポートを表示します。--runtime を追加すると Plugin モジュールを読み込み、登録済み hooks、tools、commands、services、gateway methods、HTTP routes を含めます。ランタイム検査は不足している Plugin 依存関係を直接報告します。インストールと修復は openclaw plugins install、openclaw plugins update、openclaw doctor --fix に留まります。

Plugin 所有の CLI コマンドは、ルート openclaw コマンドグループとしてインストールされます。inspect --runtime が cliCommands の下にコマンドを表示したら、openclaw <command> ... として実行します。たとえば demo-git を登録する Plugin は、openclaw demo-git ping で検証できます。

各 Plugin は、ランタイムで実際に登録する内容によって分類されます。

• plain-capability — 1 つの機能タイプ（例: プロバイダー専用 Plugin）
• hybrid-capability — 複数の機能タイプ（例: テキスト + 音声 + 画像）
• hook-only — フックのみで、機能やサーフェスはなし
• non-capability — ツール/コマンド/サービスはあるが機能はなし

機能モデルの詳細は Plugin の形状 を参照してください。

# Doctor

openclaw plugins doctor

doctor は、Plugin の読み込みエラー、マニフェスト/検出診断、互換性通知を報告します。すべて問題ない場合は No plugin issues detected. と表示します。

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

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

# レジストリ

openclaw plugins registry
openclaw plugins registry --refresh
openclaw plugins registry --json

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

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

openclaw doctor --fix は、レジストリ周辺の管理対象 npm ドリフトも修復します。管理対象 Plugin npm ルート配下にある孤立または復元された @openclaw/* パッケージがバンドル済み Plugin を隠している場合、doctor はその古いパッケージを削除し、レジストリを再構築して、起動時にバンドル済みマニフェストに対して検証できるようにします。

# マーケットプレイス

openclaw plugins marketplace list <source>
openclaw plugins marketplace list <source> --json

マーケットプレイス一覧は、ローカルマーケットプレイスパス、marketplace.json パス、owner/repo のような GitHub 省略形、GitHub リポジトリ URL、または git URL を受け付けます。--json は、解決されたソースラベルに加えて、解析済みのマーケットプレイスマニフェストと Plugin エントリを出力します。

# 関連

• Plugin の構築
• CLI リファレンス
• コミュニティ Plugin