| --- |
| summary: "CLI reference for `openclaw plugins` (list, install, enable/disable, doctor)" |
| read_when: |
| - You want to install or manage in-process Gateway plugins |
| - You want to debug plugin load failures |
| --- |
| |
| # `openclaw plugins` |
|
|
| Manage Gateway plugins/extensions (loaded in-process). |
|
|
| Related: |
|
|
| - Plugin system: [Plugins](/plugin) |
| - Plugin manifest + schema: [Plugin manifest](/plugins/manifest) |
| - Security hardening: [Security](/gateway/security) |
|
|
| ## Commands |
|
|
| ```bash |
| 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 |
| ``` |
|
|
| Bundled plugins ship with OpenClaw but start disabled. Use `plugins enable` to |
| activate them. |
|
|
| All plugins must ship a `openclaw.plugin.json` file with an inline JSON Schema |
| (`configSchema`, even if empty). Missing/invalid manifests or schemas prevent |
| the plugin from loading and fail config validation. |
|
|
| ### Install |
|
|
| ```bash |
| openclaw plugins install <path-or-spec> |
| ``` |
|
|
| Security note: treat plugin installs like running code. Prefer pinned versions. |
|
|
| Supported archives: `.zip`, `.tgz`, `.tar.gz`, `.tar`. |
|
|
| Use `--link` to avoid copying a local directory (adds to `plugins.load.paths`): |
|
|
| ```bash |
| openclaw plugins install -l ./my-plugin |
| ``` |
|
|
| ### Update |
|
|
| ```bash |
| openclaw plugins update <id> |
| openclaw plugins update --all |
| openclaw plugins update <id> --dry-run |
| ``` |
|
|
| Updates only apply to plugins installed from npm (tracked in `plugins.installs`). |
|
|
