Saltar al contenido principal
Las anulaciones de instalación de Plugin permiten a los mantenedores dirigir las instalaciones de Plugin durante la configuración a un paquete npm específico o a un tarball npm-pack local en lugar del catálogo, la fuente incluida o la fuente npm predeterminada. Existen solo para validación E2E y de paquetes; los usuarios normales instalan plugins con openclaw plugins install.
Las anulaciones ejecutan código de Plugin desde el origen que proporciones. Úsalas solo en un directorio de estado aislado o en una máquina de prueba desechable.

​
Entorno

Las anulaciones están deshabilitadas a menos que ambas variables estén configuradas: 
export OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1
export 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 anulaciones es JSON indexado por id de Plugin. Los valores admiten:
PrefijoOrigen
npm:<registry-spec>Paquetes de registro, versiones exactas o etiquetas
npm-pack:<path.tgz>Tarballs locales producidos por npm pack; las rutas relativas se resuelven desde el directorio de trabajo actual

​
Comportamiento

Cuando un flujo en tiempo de configuración instala un Plugin cuyo id aparece en el mapa, OpenClaw usa el origen de anulación en lugar del catálogo, la fuente incluida o la fuente npm predeterminada. Esto se aplica al onboarding y a cualquier otro flujo que use el instalador de Plugin compartido en tiempo de configuración.
  • Las anulaciones siguen aplicando el id de Plugin esperado: un tarball asignado a codex debe instalar un Plugin cuyo id de manifiesto sea codex.
  • Las anulaciones no heredan el estado oficial de origen confiable. Incluso cuando la entrada del catálogo normalmente representa un paquete propiedad de OpenClaw, una anulación se trata como entrada de prueba proporcionada por el operador.
  • Los archivos .env del workspace no pueden habilitar anulaciones de instalación; ambas variables de entorno están en la lista bloqueada de dotenv del workspace. Configúralas en el shell confiable, el trabajo de CI o el comando de prueba remoto que inicia OpenClaw.

​
E2E de paquetes

Usa un directorio de estado aislado para que las instalaciones de paquetes y los registros de instalación no toquen tu 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
Verifica el paquete instalado bajo el directorio de estado: 
find "$OPENCLAW_STATE_DIR/npm/projects" -path '*/node_modules/@openclaw/codex/package.json' -print
grep -R '"@openclaw/codex"' "$OPENCLAW_STATE_DIR/npm/projects"/*/package-lock.json
Para E2E con proveedor en vivo, carga la clave de API real desde un shell confiable o un secreto de CI antes de iniciar el comando de prueba. No imprimas claves; informa solo el origen y si la clave estaba presente.