Pluginを管理する

Control UI は、一般的な検出、インストール、有効化、無効化の ワークフローに対応しています。CLI ではさらに、更新、アンインストール、高度な設定、明示的な インストール元の制御を行えます。コマンドの完全な仕様、フラグ、ソース選択 ルール、エッジケースについては、openclaw pluginsを参照してください。

一般的な CLI ワークフローは、パッケージを見つけ、ClawHub、npm、git、または ローカルパスからインストールし、管理対象の Gateway を自動再起動させる（または手動で再起動する）、 その後 Plugin のランタイム登録を検証する、という流れです。

Control UI を使用する

Control UI で Plugins を開くか、設定済みの Control UI ベースパスを基準に /settings/plugins を使用します。たとえば、ベースパスが /openclaw の場合は /openclaw/settings/plugins を使用します。このページには 2 つのタブがあります。

• Installed には、カテゴリ（チャンネル、 モデルプロバイダー、メモリ、ツール）別に分類されたローカルインベントリ全体が表示されます。各行から詳細ビューを開けます。オーバーフロー （…）メニューでは Plugin を有効または無効にでき、外部からインストールされた Plugin では Remove も選択できます。このタブには、設定済みの MCP サーバーも一覧表示され、同じメニュー操作で有効化、無効化、削除を行い、 Gateway 設定内の mcp.servers を編集します。
• Discover はストアです。OpenClaw に含まれる注目の Plugin、公式の 外部 Plugin、厳選されたコネクター一覧が表示されます。コネクターカードでは、ホスト型 MCP サーバーをワンクリックで追加する（GitHub、Notion、Linear、Sentry、 Home Assistant）か、検索条件が入力済みの ClawHub 検索に移動できます。検索 ボックスに入力すると、ClawHub がインラインで検索され、ダウンロード数とソース検証バッジを含む From ClawHub セクションが追加されます。

同梱 Plugin ではパッケージのインストールは不要です。メニュー操作は Enable または Disable です。たとえば Workboard は OpenClaw に同梱され、デフォルトでは 無効になっているため、オンにするには Enable を選択します。バンドルされた Plugin は 削除できず、無効化のみ可能です。

カタログおよび検索へのアクセスには operator.read が必要です。インストール、有効化、無効化、 削除、および MCP サーバーの変更には operator.admin が必要です。ClawHub からのインストールは Gateway によって実行され、信頼性、整合性、Plugin インストール ポリシーのチェックが維持されます。管理者としてインストール済み Plugin を有効化すると、 選択した Plugin を既存の制限付き plugins.allow リストに追加することで、その明示的な信頼も記録されます。明示的な plugins.deny エントリは引き続き優先され、 Plugin を有効化する前に削除する必要があります。

Plugin コードのインストールまたは削除には Gateway の再起動が必要です。有効化状態の 変更は、インストール済み Plugin と現在の Gateway ランタイムが対応していれば再起動なしで適用できます。対応していない場合は、UI に再起動が必要であることが表示されます。 OAuth ベースの MCP コネクターでは、追加後も CLI から 1 回だけ openclaw mcp login <name> を実行する必要があります。

Control UI では、任意の npm、git、ローカルパスのソースからのインストール、 Plugin の更新、高度な Plugin 設定の操作はできません。これらの操作には、以下の CLI ワークフローを 使用してください。

Plugin の一覧表示と検索

openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --jsonopenclaw plugins search "calendar"

スクリプトでは --json を使用します。

openclaw plugins list --json \  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list はコールドインベントリチェックです。OpenClaw が 設定、マニフェスト、永続化された Plugin レジストリから検出できる内容を確認します。すでに実行中の Gateway が Plugin ランタイムをインポートしたことを証明するものではありません。JSON 出力には、 レジストリ診断と各 Plugin の dependencyStatus（宣言された dependencies/optionalDependencies がディスク上で解決されるかどうか）が含まれます。

plugins search は、インストール可能な Plugin パッケージを ClawHub で検索し、 結果ごとにインストールのヒント（openclaw plugins install clawhub:<package>）を表示します。

Plugin を有効化および無効化する

openclaw plugins enable <plugin-id>openclaw plugins disable <plugin-id>

インストール済みファイルには触れずに、Plugin の設定エントリを切り替えます。一部の バンドルされた Plugin（バンドルされたモデル／音声プロバイダー、バンドルされたブラウザー Plugin）は デフォルトで有効です。その他はインストール後に enable が必要です。

Plugin をインストールする

# ClawHub で Plugin パッケージを検索します。openclaw plugins search "calendar" # ClawHub からインストールします。openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # npm からインストールします。openclaw plugins install npm:<package>openclaw plugins install npm:@scope/openclaw-plugin@1.2.3openclaw plugins install npm:@openclaw/codex # ローカルの npm-pack アーティファクトからインストールします。openclaw plugins install npm-pack:<path.tgz> # git またはローカルの開発用チェックアウトからインストールします。openclaw plugins install git:github.com/acme/openclaw-plugin@v1.0.0openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

起動移行期間中、プレフィックスのないパッケージ指定は npm からインストールされます。ただし、 名前がバンドル済みまたは公式 Plugin の ID と一致する場合、OpenClaw は 代わりにそのローカル／公式コピーを使用します。ソースを確実に選択するには clawhub:、npm:、git:、または npm-pack: を使用します。OpenClaw のバンドル済みおよび公式 カタログパッケージは、ClawHub パッケージと同様に信頼されます。新しい任意の npm、 git、ローカルパス／アーカイブ、npm-pack:、またはマーケットプレイスのソースでは、 ソースを確認して信頼した後、非対話型インストール時に --force が必要です。

--force は、ClawHub 以外のソースをプロンプトなしで承認し、必要に応じて 既存のインストール先を上書きします。追跡対象の npm、 ClawHub、または hook-pack インストールを通常どおりアップグレードする場合は、代わりに openclaw plugins update を使用します。 --link を指定した場合、--force はソースの承認のみを行い、リンクされたディレクトリは コピーも上書きもされません。

新しくインストールした Plugin に、まだ存在しない設定が必要な場合、 OpenClaw はインストールを記録しますが、Plugin は無効のままにします。 plugins.entries.<id>.config を設定してから、openclaw plugins enable <id> を実行します。既存の 設定エントリが存在していて無効な場合、書き換えずにインストールが失敗します。

再起動して検査する

設定の再読み込みが有効な実行中の管理対象 Gateway は、Plugin コードのインストール、更新、 アンインストール後に自動的に再起動します。Gateway が管理対象外であるか、 再読み込みが無効な場合は、ライブのランタイムサーフェスを確認する前に手動で再起動してください。

openclaw gateway restartopenclaw plugins inspect <plugin-id> --runtime --json

inspect --runtime は Plugin モジュールを読み込み、ランタイム サーフェス（ツール、フック、サービス、Gateway メソッド、HTTP ルート、Plugin 所有の CLI コマンド）が登録されたことを証明します。通常の inspect と list は、 マニフェスト／設定／レジストリのコールドチェックのみです。

Plugin を更新する

openclaw plugins update <plugin-id>openclaw plugins update <npm-package-or-spec>openclaw plugins update --allopenclaw plugins update <plugin-id> --dry-run

Plugin ID を渡すと、追跡されているインストール指定が再利用されます。保存済みの dist-tag （@beta）と厳密に固定されたバージョンは、後続の update <plugin-id> 実行にも引き継がれます。

openclaw plugins update --all は一括メンテナンス用の経路です。通常の 追跡対象インストール指定は引き続き尊重されますが、信頼済みの公式 OpenClaw Plugin レコードは、古い厳密な公式パッケージに固定されたままではなく、 現在の公式カタログのターゲットと同期されます。update.channel が beta の場合、その同期ではベータリリース系列が優先されます。厳密な指定またはタグ付きの公式指定を変更しない場合は、 対象を指定した update <plugin-id> を使用します。

npm インストールでは、明示的なパッケージ指定を渡すことで追跡対象の レコードを切り替えます。

openclaw plugins update @scope/openclaw-plugin@betaopenclaw plugins update @scope/openclaw-plugin

2 番目のコマンドは、以前に厳密なバージョンまたはタグへ固定されていた Plugin を、 レジストリのデフォルトリリース系列に戻します。

正確なフォールバックおよび 固定ルールについては、openclaw pluginsを参照してください。

Plugin をアンインストールする

openclaw plugins uninstall <plugin-id> --dry-runopenclaw plugins uninstall <plugin-id>openclaw plugins uninstall <plugin-id> --keep-files

アンインストールすると、Plugin の設定エントリ、永続化された Plugin インデックスレコード、 許可／拒否リストのエントリ、および該当する場合はリンクされた plugins.load.paths エントリが 削除されます。--keep-files を渡さない限り、管理対象のインストールディレクトリも 削除されます。アンインストールによって Plugin のソースが変更されると、実行中の管理対象 Gateway は 自動的に再起動します。

Nix モード（OPENCLAW_NIX_MODE=1）では、Plugin のインストール、更新、アンインストール、 有効化、無効化はすべて無効です。これらの選択は、代わりにインストール用の Nix ソースで 管理してください。

ソースを選択する

管理対象のローカルパスからのインストール対象は、Plugin ディレクトリまたはアーカイブである必要があります。 単独の Plugin ファイルは plugins install でインストールせず、 plugins.load.paths に配置してください。

Plugin を公開する

ClawHub は、OpenClaw Plugin の主要な公開検出サーフェスです。ユーザーがインストール前に Plugin のメタデータ、バージョン履歴、レジストリのスキャン結果、インストールのヒントを 見つけられるようにする場合は、ClawHub で公開してください。

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/your-plugin@v1.0.0

ネイティブ npm Plugin は、公開前に Plugin マニフェスト（openclaw.plugin.json）と package.json メタデータを含める必要があります。

{  "name": "@acme/openclaw-plugin",  "version": "1.0.0",  "type": "module",  "openclaw": {    "extensions": ["./dist/index.js"]  }}

npm publish --access publicopenclaw plugins install npm:@acme/openclaw-pluginopenclaw plugins install npm:@acme/openclaw-plugin@betaopenclaw plugins install npm:@acme/openclaw-plugin@1.0.0

このページを公開仕様のリファレンスとして扱うのではなく、完全な公開仕様については 次のページを使用してください。

• ClawHub での公開では、所有者、スコープ、 リリース、レビュー、パッケージ検証、パッケージ移管について説明します。
• Plugin の構築では、Plugin パッケージの完全な構成（openclaw.plugin.json を含む）と最初の公開 ワークフローを示します。
• Plugin マニフェストでは、ネイティブ Plugin マニフェストの フィールドを定義します。

同じパッケージが ClawHub と npm の両方で利用可能な場合は、明示的な clawhub: または npm: プレフィックスを使用してソースを指定します。

関連項目

• Plugin - インストール、設定、再起動、トラブルシューティング
• openclaw plugins - CLI の完全なリファレンス
• コミュニティ Plugin - 公開検索と ClawHub への公開
• ClawHub - レジストリの CLI 操作
• Plugin の構築 - Plugin パッケージの作成
• Plugin マニフェスト - マニフェストとパッケージのメタデータ