openclaw plugins

Manage Gateway plugins, hook packs, and compatible bundles.

Install, uninstall, enable, disable, and reload use their existing Gateway routes when a Gateway is running. Local fallbacks require exclusive offline state ownership. Stop the Gateway through its service owner before running plugins update, plugins registry --refresh, marketplace feed refreshes, or hook-pack install fallbacks. plugins marketplace entries --offline reads the saved feed without refreshing it. Refused commands report how to retry.

plugins enable and plugins disable accept case-insensitive plugin IDs, including when the Gateway is stopped. Reported IDs retain their manifest spelling; plugin policy keys in config use the required lowercase form. The same policy applies to live activation and the next Gateway start. Runtime IDs and Gateway method names retain the plugin's declared spelling.

Commands

openclaw plugins list [--enabled] [--verbose] [--json]openclaw plugins search <query> [--limit <n>] [--json]openclaw plugins install <path-or-spec> [--link] [--force] [--pin] [--no-enable] [--accept-capabilities] [--acknowledge-install-policy-warning] [--marketplace <source>]openclaw plugins inspect <id> [--runtime] [--json]openclaw plugins inspect --all [--runtime] [--json]openclaw plugins info <id>                    # alias for inspectopenclaw plugins enable <ids...> [--accept-capabilities]openclaw plugins disable <ids...>openclaw plugins reload <ids...> [--wait] [--accept-capabilities] [--json]openclaw plugins uninstall <ids...> [--dry-run] [--keep-files] [--force]openclaw plugins update <ids-or-npm-specs...> | --all [--dry-run]openclaw plugins registry [--refresh] [--json]openclaw plugins doctor [--json]openclaw plugins init <id> [--name <name>] [--type tool|provider|feature] [--directory <path>]openclaw plugins build [--root <path>] [--entry <path>] [--check]openclaw plugins validate [--root <path>] [--entry <path>] [--json]openclaw plugins pack [--root <path>] [--out <file.tgz>] [--json]openclaw plugins marketplace entries [--offline] [--feed-profile <name>] [--json]openclaw plugins marketplace list <source> [--json]openclaw plugins marketplace refresh [--feed-profile <name>] [--expected-sha256 <sha256>] [--json]

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.

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.

• Author
• Feature scaffold and artifacts
• Provider scaffold
• Install
• Config includes and invalid-config repair
• --force confirmation and reinstall vs update
• --pin scope
• --acknowledge-install-policy-warning
• ClawHub Security Audit
• Hook packs and npm specs
• Git repositories
• Archives
• Marketplace shorthand
• Marketplace sources
• Remote marketplace rules
• List
• --enabled
• --verbose
• --json
• Plugin index
• Reload
• Uninstall
• Update
• Resolving plugin id vs npm spec
• Beta channel updates
• Existing plugin source choices
• Version checks and integrity drift
• --acknowledge-install-policy-warning on update
• ClawHub Security Audit on update
• Inspect
• Doctor
• Registry
• Marketplace

Related

• Building plugins
• CLI reference
• ClawHub
• ClawHub CLI - standalone registry commands
• ClawHub publishing - owners, scopes, and release review