> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sobrescrituras de instalación de Plugin

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`](/es/cli/plugins).

<Warning>
  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.
</Warning>

## Entorno

Las anulaciones están deshabilitadas a menos que ambas variables estén configuradas:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

| Prefijo               | Origen                                                                                                             |
| --------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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.