Anulaciones de instalación de plugins

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.

Entorno

Las sustituciones están deshabilitadas a menos que se establezcan ambas variables:

export OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1export OPENCLAW_PLUGIN_INSTALL_OVERRIDES='{  "codex": "npm-pack:/tmp/openclaw-codex-2026.5.8.tgz",  "openclaw-web-search": "npm:@openclaw/web-search@2026.5.8"}'

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:

npm pack extensions/codex --pack-destination /tmp OPENCLAW_STATE_DIR="$(mktemp -d)" \OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1 \OPENCLAW_PLUGIN_INSTALL_OVERRIDES='{"codex":"npm-pack:/tmp/openclaw-codex-2026.5.8.tgz"}' \pnpm openclaw onboard --mode local

Verifique el paquete instalado en el directorio de estado:

find "$OPENCLAW_STATE_DIR/npm/projects" -path '*/node_modules/@openclaw/codex/package.json' -printgrep -R '"@openclaw/codex"' "$OPENCLAW_STATE_DIR/npm/projects"/*/package-lock.json

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.