Las sustituciones de instalación de plugins permiten a los mantenedores dirigir las instalaciones de plugins durante la configuración a
un paquete npm específico o un tarball local de npm pack, en lugar de la fuente
del catálogo, incluida o predeterminada de npm. Existen únicamente para E2E y la validación
de paquetes; los usuarios normales instalan plugins con
openclaw plugins install.
Las sustituciones ejecutan código del plugin desde la fuente proporcionada. Úselas únicamente en un
directorio de estado aislado o una máquina de pruebas desechable.
Entorno
Las sustituciones están deshabilitadas a menos que se establezcan ambas variables:
El mapa de sustituciones es un JSON cuyas claves son identificadores de plugins. Los valores admiten:
Comportamiento
Cuando un flujo de configuración instala un plugin cuyo identificador aparece en el mapa, OpenClaw
utiliza la fuente de sustitución en lugar de la fuente del catálogo, incluida o predeterminada
de npm. Esto se aplica a la incorporación y a cualquier otro flujo que utilice el instalador
compartido de plugins durante la configuración.
- Las sustituciones siguen aplicando el identificador de plugin esperado: un tarball asignado a
codex
debe instalar un plugin cuyo identificador de manifiesto sea codex.
- Las sustituciones no heredan el estado oficial de fuente de confianza. Incluso cuando la
entrada del catálogo normalmente representa un paquete propiedad de OpenClaw, una sustitución se
trata como entrada de prueba proporcionada por el operador.
- Los archivos
.env del espacio de trabajo no pueden habilitar las sustituciones de instalación; ambas variables de entorno están en
la lista de dotenv bloqueados del espacio de trabajo. Establézcalas en el shell de confianza, el trabajo de CI o
el comando de prueba remoto que inicia OpenClaw.
E2E de paquetes
Utilice un directorio de estado aislado para que las instalaciones de paquetes y los registros de instalación no
afecten al estado normal de OpenClaw:
Verifique el paquete instalado en el directorio de estado:
Para E2E con un proveedor activo, obtenga la clave de API real desde un shell de confianza o un secreto
de CI antes de iniciar el comando de prueba. No muestre las claves; indique únicamente la
fuente y si la clave estaba presente. 