> ## 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.

# plugins

# `openclaw plugins`

Gerencie plugins/extensões do Gateway (carregados em processo).

Relacionado:

* Sistema de plugins: [Plugins](/tools/plugin)
* Manifesto + esquema de plugin: [Plugin manifest](/plugins/manifest)
* Endurecimento de segurança: [Security](/gateway/security)

## Comandos

```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
```

Plugins incluídos vêm com o OpenClaw, mas começam desativados. Use `plugins enable` para
ativá-los.

Todos os plugins devem incluir um arquivo `openclaw.plugin.json` com um JSON Schema embutido
(`configSchema`, mesmo que vazio). Manifestos ou esquemas ausentes/inválidos impedem
o carregamento do plugin e fazem a validação de configuração falhar.

### Instalar

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

Nota de segurança: trate instalações de plugins como execução de código. Prefira versões fixadas.

As especificações npm são **apenas do registry** (nome do pacote + versão/tag opcional). Especificações Git/URL/file
são rejeitadas. As instalações de dependências são executadas com `--ignore-scripts` por segurança.

Arquivos suportados: `.zip`, `.tgz`, `.tar.gz`, `.tar`.

Use `--link` para evitar copiar um diretório local (adiciona a `plugins.load.paths`):

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

### Desinstalar

```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` remove os registros do plugin de `plugins.entries`, `plugins.installs`,
da lista de permissões do plugin e das entradas vinculadas em `plugins.load.paths`, quando aplicável.
Para plugins de memória ativos, o slot de memória é redefinido para `memory-core`.

Por padrão, a desinstalação também remove o diretório de instalação do plugin sob a raiz de extensões do diretório de estado ativo (`$OPENCLAW_STATE_DIR/extensions/<id>`). Use
`--keep-files` para manter os arquivos no disco.

`--keep-config` é suportado como um alias obsoleto para `--keep-files`.

### Atualizar

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

As atualizações se aplicam apenas a plugins instalados via npm (rastreados em `plugins.installs`).