OpenClawプラグイン管理ガイド：インストールから更新まで

Gateway を使っていると、「もっとこんな機能があればいいのに」と思うことがよくありますよね。そんな時に役立つのがプラグインですが、数が増えてくると管理が煩雑になりがちです。

OpenClaw では、プラグインや拡張機能、さらには他のツール向けのバンドルまで、すべて一つの CLI コマンドでスマートに管理できます。今回は、その強力な openclaw plugins コマンドの使い方を詳しく見ていきましょう。

openclaw plugins

Gateway のプラグインや拡張機能、フックパック、そして互換性のあるバンドルを管理しましょう。

コマンド

openclaw plugins list
openclaw plugins install <path-or-spec>
openclaw plugins inspect <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins uninstall <id>
openclaw plugins doctor
openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins marketplace list <marketplace>

同梱されているプラグインは OpenClaw と一緒に提供されますが、最初は無効化されています。有効にするには plugins enable を使用してください。

ネイティブの OpenClaw プラグインは、インラインの JSON Schema（空であっても configSchema）を含む openclaw.plugin.json を同梱する必要があります。互換性のあるバンドルの場合は、代わりに独自のバンドルマニフェストを使用します。

plugins list を実行すると、Format: openclaw または Format: bundle と表示されます。詳細なリストや情報の出力では、バンドルのサブタイプ（codex, claude, または cursor）に加えて、検出されたバンドルの機能（capabilities）も確認できます。

インストール

openclaw plugins install <package>                      # ClawHub first, then npm
openclaw plugins install clawhub:<package>              # ClawHub only
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)

パッケージ名のみを指定した場合、まず ClawHub を確認し、次に npm を確認します。セキュリティ上の注意点として、プラグインのインストールは「コードを実行すること」と同等に扱ってください。可能な限り、バージョンを固定（pin）してインストールすることをおすすめします。

--dangerously-force-unsafe-install は、組み込みの危険なコードスキャナーで誤検知が発生した場合などのための緊急回避用オプションです。これを使用すると、スキャナーが critical（致命的）な結果を報告してもインストールを続行できます。ただし、before_install フックのポリシーによるブロックや、スキャン自体の失敗をバイパスすることはできません。

この CLI フラグは openclaw plugins install に適用されます。Gateway 経由

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

openclaw plugins install openclaw-codex-app-server

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

openclaw plugins install <plugin-name> --marketplace <marketplace-name>
openclaw plugins install <plugin-name> --marketplace <owner/repo>
openclaw plugins install <plugin-name> --marketplace ./my-marketplace

openclaw plugins install -l ./my-plugin

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

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@beta

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