Plugin を管理する

ほとんどの Plugin ワークフローは、検索、インストール、Gateway の再起動、検証、そして Plugin が不要になったときのアンインストールという数個のコマンドで構成されます。

# Plugin を一覧表示する

openclaw plugins list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw plugins list --json

スクリプトには --json を使用してください。Plugin パッケージが dependencies または optionalDependencies を宣言している場合、レジストリ診断と各 Plugin の静的な dependencyStatus が含まれます。

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

plugins list はコールドインベントリチェックです。OpenClaw が設定、マニフェスト、Plugin レジストリから検出できるものを表示します。すでに実行中の Gateway プロセスが Plugin ランタイムをインポートしたことを証明するものではありません。

# Plugin をインストールする

# Search ClawHub for plugin packages.
openclaw plugins search "calendar"

# Bare package specs try ClawHub first, then npm fallback.
openclaw plugins install <package>

# Force one source.
openclaw plugins install clawhub:<package>
openclaw plugins install npm:<package>

# Install a specific version or dist-tag.
openclaw plugins install clawhub:<package>@1.2.3
openclaw plugins install clawhub:<package>@beta
openclaw plugins install npm:@scope/[email protected]
openclaw plugins install npm:@openclaw/codex

# Install from git or a local development checkout.
openclaw plugins install git:github.com/acme/[email protected]
openclaw plugins install ./my-plugin
openclaw plugins install --link ./my-plugin

Plugin コードをインストールした後、チャネルを提供している Gateway を再起動します。

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

ツール、フック、サービス、Gateway メソッド、Plugin が所有する CLI コマンドなどのランタイムサーフェスを Plugin が登録したことを証明する必要がある場合は、inspect --runtime を使用してください。

# Plugin を更新する

openclaw plugins update <plugin-id>
openclaw plugins update <npm-package-or-spec>
openclaw plugins update --all

Plugin が @beta などの npm dist-tag からインストールされていた場合、以後の update <plugin-id> 呼び出しでは記録済みのそのタグが再利用されます。明示的な npm spec を渡すと、以後の更新で追跡されるインストール先がその spec に切り替わります。

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

2 番目のコマンドは、以前に正確なバージョンまたはタグに固定されていた Plugin を、レジストリの既定リリースラインに戻します。

openclaw update がベータチャネルで実行されると、既定ラインの npm と ClawHub の Plugin レコードは、一致する Plugin の @beta リリースをまず試します。そのベータリリースが存在しない場合、OpenClaw は記録済みの既定/latest spec にフォールバックします。npm Plugin では、ベータパッケージが存在してもインストール検証に失敗した場合も OpenClaw はフォールバックします。正確なバージョンと、@rc や @beta などの明示的なタグは保持されます。

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

openclaw plugins uninstall <plugin-id> --dry-run
openclaw plugins uninstall <plugin-id>
openclaw plugins uninstall <plugin-id> --keep-files
openclaw gateway restart

アンインストールでは、Plugin の設定エントリ、Plugin インデックスレコード、許可/拒否リストエントリ、および該当する場合はリンク済みロードパスが削除されます。--keep-files を渡さない限り、管理対象のインストールディレクトリは削除されます。

Nix モード (OPENCLAW_NIX_MODE=1) では、Plugin のインストール、更新、アンインストール、有効化、無効化コマンドは無効になります。代わりに、そのインストール用の Nix ソースでこれらの選択を管理してください。nix-openclaw では、エージェント優先の クイックスタート を使用してください。

# Plugin を公開する

外部 Plugin は ClawHub、npmjs.com、またはその両方に公開できます。

# ClawHub に公開する

ClawHub は OpenClaw Plugin の主要な公開ディスカバリーサーフェスです。インストール前に、ユーザーへ検索可能なメタデータ、バージョン履歴、レジストリスキャン結果を提供します。

npm i -g clawhub
clawhub login
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/[email protected]

ユーザーは ClawHub から次のようにインストールします。

openclaw plugins install clawhub:<package>
openclaw plugins install <package>

裸の形式でも、ClawHub が先に確認されます。

# npmjs.com に公開する

ネイティブ npm Plugin には、Plugin マニフェストと package.json の OpenClaw エントリポイントメタデータを含める必要があります。

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

npm publish --access public

ユーザーは npm 専用として次のようにインストールします。

openclaw plugins install npm:@acme/openclaw-plugin
openclaw plugins install npm:@acme/openclaw-plugin@beta
openclaw plugins install npm:@acme/[email protected]

同じパッケージが ClawHub でも利用可能な場合、npm: は ClawHub ルックアップをスキップし、npm 解決を強制します。

# ソースの選択

• ClawHub: OpenClaw ネイティブのディスカバリー、スキャン概要、バージョン、インストールヒントが必要な場合に使用します。
• npmjs.com: すでに JavaScript パッケージを配布している場合、または npm dist-tag/プライベートレジストリのワークフローが必要な場合に使用します。
• Git: ブランチ、タグ、コミットから直接インストールしたい場合に使用します。
• ローカルパス: 同じマシン上で Plugin を開発またはテストしている場合に使用します。

# 関連

• Plugin - 概要とトラブルシューティング
• openclaw plugins - 完全な CLI リファレンス
• ClawHub - 公開とレジストリ操作
• Plugin の構築 - Plugin パッケージを作成する
• Plugin マニフェスト - マニフェストとパッケージメタデータ