Skip to main content

​
openclaw plugins

Manage Gateway plugins, hook packs, and compatible bundles.

Plugin system

End-user guide for installing, enabling, and troubleshooting plugins.

Manage plugins

Quick examples for install, list, update, uninstall, and publishing.

Plugin bundles

Bundle compatibility model.

Plugin manifest

Manifest fields and config schema.

Security

Security hardening for plugin installs.

​
Commands

For slow install, inspect, uninstall, or registry-refresh investigation, run the command with OPENCLAW_PLUGIN_LIFECYCLE_TRACE=1. The trace writes phase timings to stderr and keeps JSON output parseable. See Debugging.
In Nix mode (OPENCLAW_NIX_MODE=1), openclaw.json is immutable. install, update, uninstall, enable, and disable all refuse to run. Manage those choices in the Nix source for this install (programs.openclaw.config or instances.<name>.config for nix-openclaw), then rebuild. Reload remains available when no new capability consent needs to be recorded; it preserves config and installation state. See the agent-first Quick Start.
Bundled plugins ship with OpenClaw. Some are enabled by default (for example bundled model providers, bundled speech providers, and the bundled browser plugin); others require plugins enable.Native OpenClaw plugins ship openclaw.plugin.json with an inline JSON Schema (configSchema, even if empty). Compatible bundles use their own bundle manifests instead.plugins list shows Format: openclaw or Format: bundle. Verbose list/info output also shows the bundle subtype (agent (Agent Plugins), codex, claude, or cursor) plus detected bundle capabilities.

​
Plugins pages

This page is an index. openclaw plugins is documented on six pages, one per reader job. Open the page that matches your task.

​
Where each section moved

Every section anchor from the previous single-page version keeps its id here, so an existing link such as /cli/plugins#registry still resolves. Each entry points at the page that now holds the content.