openclaw pluginsを参照してください。
典型的なワークフロー: パッケージを見つけ、ClawHub、npm、git、または
ローカルパスからインストールし、管理対象Gatewayを自動再起動させる
（または手動で再起動する）。その後、Pluginのランタイム登録を確認します。
Pluginの一覧表示と検索
--json:
plugins listはコールドなインベントリ確認です。OpenClawが
設定、マニフェスト、永続化されたPluginレジストリから検出できるものを示します。
すでに実行中のGatewayがPluginランタイムをインポートしたことは証明しません。
JSON出力には、レジストリ診断と各PluginのdependencyStatus（宣言された
dependencies/optionalDependenciesがディスク上で解決できるかどうか）が含まれます。
plugins searchはClawHubにインストール可能なPluginパッケージを問い合わせ、
結果ごとにインストールヒント（openclaw plugins install clawhub:<package>）を出力します。
Pluginの有効化と無効化
enableが必要です。
Pluginのインストール
clawhub:、npm:、git:、または
npm-pack:を使用してください。
--forceは、異なるソースからの既存のインストール先を上書きする場合にのみ使用します。
追跡済みのnpm、ClawHub、またはhook-packインストールの日常的なアップグレードには、
代わりにopenclaw plugins updateを使用してください。--forceは
--linkではサポートされません。
再起動と検査
設定リロードが有効な実行中の管理対象Gatewayは、Pluginコードの インストール、更新、アンインストール後に自動で再起動します。Gatewayが 管理対象外、またはリロードが無効な場合は、ライブランタイムサーフェスを確認する前に 自分で再起動してください。inspect --runtimeはPluginモジュールを読み込み、ランタイム
サーフェス（ツール、フック、サービス、Gatewayメソッド、HTTPルート、Plugin所有の
CLIコマンド）が登録されたことを証明します。通常のinspectとlistは、
コールドなマニフェスト/設定/レジストリ確認にすぎません。
Pluginの更新
@beta）と正確に固定されたバージョンは、後続のupdate <plugin-id>
実行にも引き継がれます。
openclaw plugins update --allは一括メンテナンス用の経路です。通常の
追跡済みインストール指定は引き続き尊重しますが、信頼済みの公式OpenClaw
Pluginレコードは、古い正確な公式パッケージに固定されたままにせず、
現在の公式カタログターゲットへ同期します。update.channelが
betaの場合、その同期はbetaリリースラインを優先します。正確な、またはタグ付きの
公式指定をそのまま保つには、対象を絞ったupdate <plugin-id>を使用してください。
npmインストールでは、追跡済みレコードを切り替えるために明示的なパッケージ指定を渡します。
openclaw pluginsを参照してください。
Pluginのアンインストール
plugins.load.pathsエントリを削除します。
--keep-filesを渡さない限り、管理対象インストールディレクトリも削除されます。
アンインストールによってPluginソースが変更されると、実行中の管理対象Gatewayは
自動で再起動します。
Nixモード（OPENCLAW_NIX_MODE=1）では、Pluginのインストール、更新、
アンインストール、有効化、無効化はすべて無効です。代わりに、インストール用のNixソースで
これらの選択を管理してください。
ソースの選択
| ソース | 使用する場面 | 例 |
|---|---|---|
| ClawHub | OpenClawネイティブの検出、スキャン概要、バージョン、ヒントが必要な場合 | openclaw plugins install clawhub:<package> |
| git | リポジトリのブランチ、タグ、またはコミットが必要な場合 | openclaw plugins install git:github.com/<owner>/<repo>@<ref> |
| ローカルパス | 同じマシン上でPluginを開発またはテストしている場合 | openclaw plugins install --link ./my-plugin |
| マーケットプレイス | Claude互換のマーケットプレイスPluginをインストールする場合 | openclaw plugins install <plugin> --marketplace <source> |
| npm pack | ローカルパッケージアーティファクトをnpm installの意味論で検証する場合 | openclaw plugins install npm-pack:<path.tgz> |
| npmjs.com | すでにJavaScriptパッケージを配布している、またはnpm dist-tags/プライベートレジストリが必要な場合 | openclaw plugins install npm:@acme/openclaw-plugin |
plugins installでインストールする代わりに
plugins.load.pathsへ配置してください。
Pluginの公開
ClawHubはOpenClaw Plugin向けの主要な公開検出サーフェスです。ユーザーが インストール前にPluginメタデータ、バージョン履歴、レジストリスキャン結果、 インストールヒントを見つけられるようにしたい場合は、そこで公開してください。openclaw.plugin.json）と
package.jsonメタデータを同梱する必要があります。
package.json
- ClawHubでの公開では、所有者、スコープ、 リリース、レビュー、パッケージ検証、パッケージ移管について説明します。
- Pluginの構築では、完全なPlugin
パッケージ形状（
openclaw.plugin.jsonを含む）と初回公開 ワークフローを示します。 - Pluginマニフェストでは、ネイティブPluginマニフェスト フィールドを定義します。
clawhub:またはnpm:プレフィックスを使用して、片方のソースを強制してください。
関連
- Plugin - インストール、設定、再起動、トラブルシューティング
openclaw plugins- 完全なCLIリファレンス- コミュニティPlugin - 公開検出とClawHubでの公開
- ClawHub - レジストリCLI操作
- Pluginの構築 - Pluginパッケージの作成
- Pluginマニフェスト - マニフェストとパッケージメタデータ