# plugins

# `openclaw plugins`

Manage gateway extensions that load in-process.

## Overview

The OpenClaw plugins system manages gateway extensions that load in-process. Bundled plugins ship with OpenClaw but start disabled. Use `plugins enable` to activate them.

## Key Commands

```bash
openclaw plugins list
openclaw plugins info <name>
openclaw plugins enable <name>
openclaw plugins disable <name>
openclaw plugins install <path-or-spec>
openclaw plugins install <path> --link
openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins doctor
```

## Installation Requirements

Plugins must include a manifest file (`openclaw.plugin.json`) containing inline JSON Schema specifications. Missing/invalid manifests or schemas prevent the plugin from loading and fail config validation.

## Installation Methods

Users can install plugins via:

1. **Direct path or specification**: `openclaw plugins install <path-or-spec>`
2. **Linked local directory**: Using the `--link` flag to reference a local folder without copying
3. **Supported archive formats**: ZIP, TGZ, TAR.GZ, and TAR files

## Security Considerations

Treat plugin installs like running code. Prefer pinned versions.

## Update Capabilities

Updates apply only to plugins installed from npm and tracked in the configuration. A dry-run option allows users to preview changes before applying them.
