Saltar para o conteúdo principal

openclaw plugins

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

Comandos

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

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):
openclaw plugins install -l ./my-plugin

Desinstalar

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

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