メインコンテンツへスキップ

openclaw plugins

Gateway(ゲートウェイ)プラグイン/拡張(インプロセスで読み込み)を管理します。 関連項目:

コマンド

openclaw plugins list
openclaw plugins info <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins doctor
openclaw plugins update <id>
openclaw plugins update --all
バンドルされたプラグインは OpenClaw とともに提供されますが、初期状態では無効です。plugins enable を使用して有効化します。 9. 有効化するには plugins enable を使用してください。 すべてのプラグインは、インラインの JSON Schema(configSchema、空であっても)を含む openclaw.plugin.json ファイルを同梱する必要があります。マニフェストまたはスキーマが欠落している、または無効な場合、プラグインは読み込まれず、設定の検証に失敗します。 10. マニフェストやスキーマが欠落している、または無効な場合、プラグインは読み込まれず、設定検証は失敗します。

インストール

openclaw plugins install <path-or-spec>
セキュリティに関する注意: プラグインのインストールはコードの実行と同様に扱ってください。固定(ピン留め)されたバージョンを推奨します。 ピン留めされたバージョンを好みます。 ピン留めされたバージョンを好みます。 Npm の指定は registry-only(パッケージ名 + 任意のバージョン/タグ)のみ対応しています。 Git/URL/file spec は拒否されます。 依存関係のインストールは、安全のため --ignore-scripts を付けて実行されます。 対応アーカイブ: .zip.tgz.tar.gz.tar ローカルディレクトリのコピーを避けるには --link を使用してください(plugins.load.paths に追加されます):
openclaw plugins install -l ./my-plugin

アンインストール

openclaw plugins uninstall <id>
openclaw plugins uninstall <id> --dry-run
openclaw plugins uninstall <id> --keep-files
uninstall は、plugins.entriesplugins.installs、プラグインの allowlist、および該当する場合は関連付けられた plugins.load.paths エントリからプラグインの記録を削除します。 アクティブなメモリプラグインの場合、メモリスロットは memory-core にリセットされます。 デフォルトでは、アンインストール時にアクティブな state ディレクトリの extensions ルート($OPENCLAW_STATE_DIR/extensions/<id>)配下にあるプラグインのインストールディレクトリも削除されます。 ディスク上のファイルを保持するには --keep-files を使用します。 --keep-config--keep-files の非推奨エイリアスとしてサポートされています。

更新

openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins update <id> --dry-run
更新は npm からインストールされたプラグインにのみ適用されます(plugins.installs で追跡されます)。