Crabbox: dale a tu agent una caja disponible al instante para ejecutar pruebas, compilaciones y comprobaciones de UI

Install

npx skills add openclaw/crabbox --skill crabbox

Crabbox es ideal para que, mientras un coding agent edita tu código localmente, las pruebas, las compilaciones o las comprobaciones de UI se ejecuten en una máquina remota disponible al instante; el requisito más importante antes de empezar es que puedas instalar la CLI en tu máquina y que, para la vía rápida de contenedores locales, tengas Docker o Podman instalados y en ejecución.

Para quién es

Para quienes quieran que un agent (o ellos mismos) ejecuten pruebas, compilaciones y comprobaciones de UI en una caja en la nube, una VM/contenedor local o una máquina que ya tengan, mientras siguen editando el código localmente.
Crabbox es una CLI que ofrece tres formas de caja: cajas en la nube, VM o contenedor local, y una máquina propia que ya tengas.
La vía rápida de contenedores locales exige tener Docker o Podman instalados y en ejecución en la máquina; el flujo de trabajo por SSH requiere tener localmente git, ssh, ssh-keygen, rsync y curl. Si no cumples estos requisitos, la evidencia oficial no indica otras formas disponibles.
Sobre si las cajas en la nube requieren una cuenta, cómo se cobran y qué plataformas de nube se admiten, la evidencia no lo indica; antes de usarlas, verifícalo por tu cuenta en la documentación oficial.

Primer intento en 3 minutos

La vía principal oficial recomendada es el arranque rápido con contenedores locales, que no requiere ninguna cuenta en la nube:

Requisitos: tener Docker o Podman instalados y en ejecución en tu máquina, e instalar la CLI por separado (según la documentación oficial, "Install the CLI separately"; para los comandos de instalación concretos, consulta el README oficial).
Instala la skill del agent ejecutando el comando oficial en un agent compatible:
```
npx skills add openclaw/crabbox --skill crabbox
```
Oficialmente también se publica una skill crabbox-quickstart que puede servir como alternativa.
Entra en un repositorio Git de tu confianza (la documentación oficial exige operar en un repositorio confiable).
Pide al agent (o ejecuta en la terminal) el comando oficial de autodiagnóstico:
```
crabbox doctor --provider local-container
```
Señal de éxito: doctor supera la comprobación del entorno de contenedores locales.
Ejecuta después una primera tarea de bajo riesgo y de solo lectura para verificar toda la cadena:
```
crabbox run --provider local-container -- uname -a
```
Señal de éxito: Crabbox alquilará una caja de contenedor efímera, transmitirá la salida del comando a tu terminal y liberará la caja a continuación. Este ejemplo solo ejecuta uname -a y no modifica tus archivos.
El flujo de trabajo central a partir de ahí es crabbox run -- <cmd>: alquila una caja, sincroniza tu árbol de trabajo (incluidos los cambios sin confirmar), ejecuta el comando y transmite la salida a la terminal, devuelve el código de salida y luego libera la caja efímera. Atención: se sincroniza el árbol de trabajo completo, incluidos los cambios sin confirmar; antes de ejecutar por primera vez un comando real de pruebas, asegúrate de entender qué se llevará a la caja para ejecutarse.

Casos de uso

Caso 1: ejecutar la suite de pruebas en una caja limpia antes de confirmar. Escenario: tú (o el agent) terminaste de modificar el código pero no quieres ensuciar el entorno local. Pide al agent que ejecute crabbox run -- pnpm test (sustituye pnpm test por el comando de pruebas de tu propio proyecto). Resultado esperable: se alquila una caja efímera, tu árbol de trabajo junto con los cambios sin confirmar se sincroniza, la salida de las pruebas se transmite en tiempo real a la terminal, al finalizar obtienes el código de salida real y la caja se libera.

Caso 2: verificar el entorno de la caja de contenedor. Escenario: primera configuración o sospecha de un problema en el entorno. Pide al agent que ejecute primero crabbox doctor --provider local-container como diagnóstico y luego crabbox run --provider local-container -- uname -a para confirmar que la caja puede ejecutar comandos. Resultado esperable: doctor informa de si el entorno de contenedores locales está listo; run devuelve la información del sistema de la caja, lo que demuestra que la cadena completa de alquilar—sincronizar—ejecutar—reciclar funciona. Ambas operaciones solo hacen comprobaciones y leen información del sistema, por lo que son acciones típicas de primer uso de bajo riesgo.

Límites de uso

Efectos secundarios y puntos de confirmación: cada crabbox run alquila una caja y sincroniza tu árbol de trabajo (incluidos los cambios sin confirmar) en ella, y luego ejecuta en ella el comando que indiques: el comando se ejecuta de verdad dentro de la caja, así que confirma su contenido antes de lanzarlo. La vía de contenedores locales además inicia contenedores en tu máquina; sobre los límites de los servicios externos implicados en las cajas en la nube, la evidencia no lo indica.
Requisitos del entorno de ejecución: la vía rápida de contenedores locales necesita Docker o Podman; el flujo de trabajo por SSH necesita git, ssh, ssh-keygen, rsync y curl en local.
Requisitos del cliente: las skills se instalan mediante npx skills add y funcionan con agents que admitan agent skills; qué clientes concretos son compatibles no se detalla uno por uno en la evidencia.
Información clave aún sin confirmar: los requisitos de alta y de cuenta de las cajas en la nube, si crabbox doctor o run acceden a la red o qué archivos locales leen o escriben, y qué otros subcomandos existen además de los mostrados en la documentación: la evidencia oficial no lo indica en ningún caso; antes de usarlo, consulta el README oficial.