Skip to main content

openclaw plugins

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

Comandos

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

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

Desinstalar

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

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