> ## 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. # Pruebas * Kit completo de pruebas (suites, en vivo, Docker): [Pruebas](/es/help/testing) * Validación de actualizaciones y paquetes de plugins: [Pruebas de actualizaciones y plugins](/es/help/testing-updates-plugins) ## Valor predeterminado del agente Las sesiones de agente ejecutan pruebas y validación computacionalmente intensiva de forma remota a través de Crabbox. El código de mantenedores de confianza usa Blacksmith Testbox de forma predeterminada. El flujo de trabajo configurado de Testbox hidrata credenciales, por lo que el código de contribuidores o forks no confiables debe usar CI de fork sin secretos o Crabbox directo en AWS sanitizado en su lugar. Cuando una tarea de código confiable probablemente necesite pruebas o pruebas pesadas, precalienta de inmediato en una sesión de comando en segundo plano, sigue trabajando mientras se hidrata, reutiliza el id `tbx_...` devuelto, sincroniza el checkout actual en cada ejecución y detenlo antes del traspaso: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} node scripts/crabbox-wrapper.mjs warmup --provider blacksmith-testbox --keep --timing-json ``` Los comandos de prueba locales siguientes son para flujos de trabajo humanos o una reserva explícita de agente solicitada por el usuario. La indisponibilidad del proveedor remoto debe informarse; no es permiso para ejecutar silenciosamente una puerta local amplia. Para código no confiable, precalienta con `--provider aws`. Cada ejecución debe establecer `CRABBOX_ENV_ALLOW=CI`, pasar `--provider aws --no-hydrate` y usar un `HOME` remoto temporal nuevo antes de instalar dependencias o ejecutar pruebas. Usa un lease recién calentado dedicado a esa fuente no confiable; nunca reutilices un lease confiable o previamente hidratado. Lanza un binario Crabbox confiable instalado desde un checkout `main` limpio y confiable y obtiene solo el PR remoto con `--fresh-pr`; nunca ejecutes localmente el wrapper o la configuración del checkout no confiable. Desestablece `CRABBOX_AWS_INSTANCE_PROFILE` y falla cerrado a menos que el `aws.instanceProfile` resuelto esté vacío. Antes de cualquier instalación/prueba, usa herramientas de ruta absoluta confiables para exigir un token IMDSv2, demostrar que el endpoint de credenciales IAM devuelve 404 y verificar que `git rev-parse HEAD` remoto sea igual al SHA completo de la cabeza del PR revisada. Vincula el lease a ese SHA y detén/recalienta cuando la cabeza cambie. Sube `scripts/crabbox-untrusted-bootstrap.sh` confiable desde `main` limpio junto con `--fresh-pr`; instala Node/pnpm fijados, verifica el SHA y la fijación del gestor de paquetes, aísla `HOME`, instala dependencias y luego ejecuta la prueba solicitada. Si el broker no puede demostrar que no hay rol o que no existe PR remoto, usa CI de fork sin secretos. No uses `hydrate-github`, `--no-sync` ni un flujo de trabajo Testbox hidratado con credenciales. Desestablece todas las sobrescrituras `CRABBOX_TAILSCALE*`, fuerza `--network public --tailscale=false`, limpia las marcas de nodo de salida/LAN y exige que `crabbox inspect` informe red pública sin estado Tailscale antes de subir cualquier script. ## Orden local rutinario 1. `pnpm test:changed` para prueba Vitest con alcance de cambios. 2. `pnpm test ` para un archivo, directorio u objetivo explícito. 3. `pnpm test` solo cuando necesites intencionalmente la suite Vitest local completa. En un worktree de Codex o un checkout enlazado/disperso, los agentes evitan `pnpm test*` / `pnpm check*` / `pnpm crabbox:run` locales directos: * Reserva local explícitamente solicitada por el usuario para un archivo pequeño: `node scripts/run-vitest.mjs `. * Puertas de cambios o prueba amplia: `node scripts/crabbox-wrapper.mjs run --provider blacksmith-testbox ... -- env OPENCLAW_CHECK_CHANGED_REMOTE_CHILD=1 OPENCLAW_CHANGED_LANES_RAW_SYNC=1 corepack pnpm check:changed` para que pnpm se ejecute dentro de Testbox. * El `exitCode` final del wrapper y el JSON de tiempos son el resultado del comando. Una ejecución delegada de Blacksmith GitHub Actions puede mostrar `cancelled` después de un comando SSH exitoso porque el Testbox se detiene desde fuera de la acción keepalive; revisa el resumen del wrapper y la salida del comando antes de tratarlo como un fallo. * `OPENCLAW_HEAVY_CHECK_LOCK_SCOPE=worktree `: mantiene la serialización de comprobaciones pesadas dentro del worktree actual en lugar del directorio común de Git para comandos como `pnpm check:changed` y `pnpm test ...` dirigidos. Úsalo solo en hosts locales de alta capacidad cuando ejecutes intencionalmente comprobaciones independientes en worktrees enlazados. ## Comandos principales Las ejecuciones del wrapper de pruebas terminan con un breve resumen `[test] passed|failed|skipped ... in ...`; la línea de duración propia de Vitest queda como detalle por shard. | Comando | Qué hace | | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `pnpm test` | Los objetivos explícitos de archivo/directorio se enrutan por lanes Vitest con alcance. Las ejecuciones sin objetivo son prueba de suite completa: los grupos de shards fijos se expanden a configuraciones hoja para ejecución paralela local, con el fanout de shards esperado impreso antes de empezar. El grupo de extensiones siempre se expande a configuraciones de shard por extensión en lugar de un proceso gigante de proyecto raíz. | | `pnpm test:changed` | Ejecución inteligente barata de pruebas cambiadas: objetivos precisos a partir de ediciones directas de pruebas, archivos hermanos `*.test.ts`, mapeos de fuente explícitos y el grafo local de importaciones. Los cambios amplios/de configuración/paquete se omiten a menos que se asignen a pruebas precisas. | | `OPENCLAW_TEST_CHANGED_BROAD=1 pnpm test:changed` | Ejecución amplia explícita de pruebas cambiadas; úsala cuando una edición de arnés/configuración/paquete de pruebas deba recurrir al comportamiento más amplio de pruebas cambiadas de Vitest. | | `pnpm test:force` | Libera el puerto configurado del Gateway de OpenClaw (predeterminado `18789`) y luego ejecuta la suite completa con un puerto de Gateway aislado para que las pruebas de servidor no colisionen con una instancia en ejecución. | | `pnpm test:coverage` | Suite unitaria con cobertura V8 (`vitest.unit.config.ts`). Puerta de lane unitaria predeterminada, no cobertura de todo el repositorio: `coverage.all` es `false` y los umbrales son líneas/funciones/sentencias 70%, ramas 55%, con alcance a pruebas unitarias no rápidas con archivos fuente hermanos. | | `pnpm test:coverage:changed` | Cobertura unitaria solo para archivos cambiados desde `origin/main`. | | `pnpm changed:lanes` | Muestra las lanes arquitectónicas activadas por el diff contra `origin/main`. | | `pnpm check:changed` | Delega en Crabbox/Testbox de forma predeterminada fuera de CI y luego ejecuta la puerta inteligente de comprobación de cambios dentro del hijo remoto: typecheck, lint y comandos de guardia para lanes afectadas. No ejecuta Vitest; usa `pnpm test:changed` o `pnpm test ` para prueba de tests. | ## Estado de prueba compartido y helpers de proceso * `src/test-utils/openclaw-test-state.ts`: úsalo desde Vitest cuando una prueba necesite un `HOME`, `OPENCLAW_STATE_DIR`, `OPENCLAW_CONFIG_PATH`, fixture de configuración, workspace, directorio de agente o almacén de perfiles de auth aislados. * `pnpm test:env-mutations:report`: informe no bloqueante de pruebas/arneses que mutan directamente `HOME`, `OPENCLAW_STATE_DIR`, `OPENCLAW_CONFIG_PATH`, `OPENCLAW_WORKSPACE_DIR` o claves de env relacionadas. Úsalo para encontrar candidatos de migración al helper de estado de prueba compartido. * `test/helpers/openclaw-test-instance.ts`: pruebas E2E a nivel de proceso que necesitan un Gateway en ejecución, env de CLI, captura de logs y limpieza en un solo lugar. * Las lanes Docker/Bash E2E que hacen source de `scripts/lib/docker-e2e-image.sh` pueden pasar `docker_e2e_test_state_shell_b64