> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# プラグイン

# `openclaw plugins`

Gateway（ゲートウェイ）プラグイン／拡張（インプロセスで読み込み）を管理します。

関連項目:

* プラグインシステム: [Plugins](/tools/plugin)
* プラグインマニフェスト + スキーマ: [Plugin manifest](/plugins/manifest)
* セキュリティ強化: [Security](/gateway/security)

## コマンド

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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. マニフェストやスキーマが欠落している、または無効な場合、プラグインは読み込まれず、設定検証は失敗します。

### インストール

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install <path-or-spec>
```

セキュリティに関する注意: プラグインのインストールはコードの実行と同様に扱ってください。固定（ピン留め）されたバージョンを推奨します。 ピン留めされたバージョンを好みます。 ピン留めされたバージョンを好みます。

Npm の指定は **registry-only**（パッケージ名 + 任意のバージョン／タグ）のみ対応しています。 Git/URL/file
spec は拒否されます。 依存関係のインストールは、安全のため `--ignore-scripts` を付けて実行されます。

対応アーカイブ: `.zip`、`.tgz`、`.tar.gz`、`.tar`。

ローカルディレクトリのコピーを避けるには `--link` を使用してください（`plugins.load.paths` に追加されます）:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install -l ./my-plugin
```

### アンインストール

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins uninstall <id>
openclaw plugins uninstall <id> --dry-run
openclaw plugins uninstall <id> --keep-files
```

`uninstall` は、`plugins.entries`、`plugins.installs`、プラグインの allowlist、および該当する場合は関連付けられた `plugins.load.paths` エントリからプラグインの記録を削除します。
アクティブなメモリプラグインの場合、メモリスロットは `memory-core` にリセットされます。

デフォルトでは、アンインストール時にアクティブな state ディレクトリの extensions ルート（`$OPENCLAW_STATE_DIR/extensions/<id>`）配下にあるプラグインのインストールディレクトリも削除されます。 ディスク上のファイルを保持するには
`--keep-files` を使用します。

`--keep-config` は `--keep-files` の非推奨エイリアスとしてサポートされています。

### 更新

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins update <id> --dry-run
```

更新は npm からインストールされたプラグインにのみ適用されます（`plugins.installs` で追跡されます）。