As substituições de instalação de Plugins permitem que os mantenedores direcionem instalações de Plugins durante a configuração para
um pacote npm específico ou um tarball local gerado por npm pack, em vez da origem do catálogo,
integrada ou padrão do npm. Elas existem somente para E2E e validação de pacotes;
usuários comuns instalam Plugins com
openclaw plugins install.
As substituições executam código de Plugin da origem fornecida. Use-as somente em um
diretório de estado isolado ou em uma máquina de teste descartável.
Ambiente
As substituições ficam desativadas, a menos que ambas as variáveis estejam definidas:
O mapa de substituições é um JSON indexado pelo id do Plugin. Os valores aceitam:
Comportamento
Quando um fluxo de configuração instala um Plugin cujo id aparece no mapa, o OpenClaw
usa a origem de substituição em vez da origem do catálogo, integrada ou padrão do npm.
Isso se aplica à integração inicial e a qualquer outro fluxo que use o instalador
compartilhado de Plugins durante a configuração.
- As substituições ainda impõem o id de Plugin esperado: um tarball mapeado para
codex
deve instalar um Plugin cujo id no manifesto seja codex.
- As substituições não herdam o status oficial de origem confiável. Mesmo quando a
entrada do catálogo normalmente representa um pacote pertencente ao OpenClaw, uma substituição é
tratada como entrada de teste fornecida pelo operador.
- Arquivos
.env do espaço de trabalho não podem habilitar substituições de instalação; ambas as variáveis de ambiente estão na
lista bloqueada de dotenv do espaço de trabalho. Defina-as no shell confiável, no trabalho de CI ou no
comando de teste remoto que inicia o OpenClaw.
E2E de pacote
Use um diretório de estado isolado para que as instalações de pacotes e os registros de instalação não
afetem seu estado normal do OpenClaw:
Verifique o pacote instalado no diretório de estado:
Para E2E de provedor ao vivo, carregue a chave de API real de um shell confiável ou de um
segredo de CI antes de iniciar o comando de teste. Não imprima chaves; informe somente a
origem e se a chave estava presente. 