OpenClaw devbox 🦞

Nodo de extensión para la aplicación principal de OpenClaw, que proporciona un entorno de ejecución remota con lenguajes de programación y herramientas de desarrollo preinstalados.

Lenguajes y herramientas preinstalados

• Python 3 (python3, pip, venv)
• Node.js (de la imagen base de OpenClaw)
• Go (golang)
• Rust (rustc, cargo)
• C/C++ (gcc, g++, make, cmake)
• Herramientas de desarrollo: git, curl, wget, jq, unzip, zip

Paquetes persistentes del usuario

Los paquetes instalados por el usuario se conservan tras reinicios del contenedor:

• pip install → ~/.local/
• npm install -g → ~/.npm-global/
• go install → ~/go/
• cargo install → ~/.cargo/

Autenticación Git (opcional)

Para clonar repositorios privados, agregue las siguientes variables de entorno al servicio devbox en el panel de Zeabur:

• GIT_TOKEN — GitHub personal access token. El script de inicio configurará automáticamente la autenticación HTTPS. Genere uno en GitHub > Settings > Developer settings > Personal access tokens con el alcance repo.
• SSH_PRIVATE_KEY — Clave SSH privada codificada en Base64. El script de inicio la escribirá automáticamente en ~/.ssh/id_rsa. Genere un par de claves y codifíquelo:

  ssh-keygen -t ed25519 -f ~/.ssh/openclaw_devbox -N ""
  base64 -i ~/.ssh/openclaw_devbox    # pegue este valor en SSH_PRIVATE_KEY
  

  Luego agregue ~/.ssh/openclaw_devbox.pub a su cuenta de GitHub en Settings > SSH and GPG keys.

Casos de uso

• Ejecución de código multilenguaje — Pida a la IA que escriba y ejecute código en Python, Go, Rust o C en la conversación
• Instalación y prueba de paquetes — Pida a la IA que instale paquetes de terceros y verifique su funcionalidad (las instalaciones persisten tras reinicios)
• Procesamiento y análisis de datos — Suba archivos de datos y pida a la IA que los procese, transforme o analice con Python o jq
• Operaciones Git y compilación de proyectos — Clone repositorios, compile proyectos y ejecute pruebas
• Scripts de automatización del sistema — Escriba y pruebe scripts de shell y herramientas de automatización

Requisitos previos

Necesita una instancia de OpenClaw en ejecución. Si aún no tiene una, despliegue primero la plantilla principal de OpenClaw.

Configuración

1. Antes de desplegar, copie el Gateway Token de la pestaña Instrucciones de su servicio OpenClaw para facilitar la entrada
2. Despliegue esta plantilla en el mismo proyecto Zeabur que su instancia de OpenClaw
3. Ingrese el Gateway Token y el Gateway Host (el nombre del servicio Zeabur de su instancia de OpenClaw, por ejemplo, si el servicio se llama openclaw, ingrese openclaw)
4. El nodo devbox se conectará a OpenClaw y enviará una solicitud de emparejamiento
5. Apruebe la solicitud de emparejamiento en la terminal de su servicio OpenClaw:

   openclaw devices list       # encontrar el ID de solicitud pendiente
   openclaw devices approve <requestId>
   

Recursos recomendados

• CPU: 2 vCPU
• Memoria: 2048 MB

Verificación

Después del despliegue, verifique que el nodo devbox aparezca en OpenClaw:

• Ejecute openclaw nodes list en la terminal de su servicio OpenClaw
• O consulte la página de Nodos en la interfaz web de OpenClaw
• O simplemente pregunte en la conversación: "Can you see the devbox node?"

Arquitectura

• Sin puertos expuestos — el devbox inicia una conexión WebSocket saliente al gateway de OpenClaw
• exec.security está configurado como full — no se necesita aprobación interactiva para la ejecución de comandos
• Los entornos de ejecución del sistema están integrados en la imagen; los paquetes del usuario residen en el volumen persistente

Solución de problemas

• Si ha ingresado el Gateway Host pero no ve una solicitud de emparejamiento pendiente en openclaw devices list, es posible que el nombre del servicio sea incorrecto. Vaya a la pestaña Red del servicio OpenClaw en el panel de Zeabur y verifique el hostname privado. Por ejemplo, si el hostname privado es openclaw.zeabur.internal, entonces el Gateway Host debe ser openclaw (la parte antes de .zeabur.internal).
• Si el servicio devbox no ha logrado emparejarse durante mucho tiempo, Zeabur puede suspenderlo automáticamente. Asegúrese de que el servicio devbox esté en ejecución antes de intentar el emparejamiento.