OpenClawSkills
GitHub
Despliegue • 6 min de lectura

Despliegue con Docker

Guía de despliegue profesional para contenerizar OpenClaw en servidores y máquinas locales.

Imagen Oficial

La imagen oficial está disponible en <code>ghcr.io/openclaw/openclaw:latest</code>. Incluye todas las dependencias necesarias para automatización de navegador y servicios de gateway.
Tutorial.step

Inicio Rápido

Para una sesión efímera rápida, ejecuta el contenedor directamente con flags mínimos:

Terminal
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  ghcr.io/openclaw/openclaw:latest \
  openclaw gateway
Tutorial.step

Docker Compose (Recomendado)

Para producción y uso a largo plazo, Docker Compose es la forma estándar de gestionar tu instancia de OpenClaw.

docker-compose.yml
version: '3.8'
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789" # Gateway
      - "18793:18793" # Canvas Host (Opcional)
    volumes:
      - ~/.openclaw:/root/.openclaw # Configuración & Workspace
    environment:
      - NODE_ENV=production
    command: openclaw gateway
Tutorial.step

Persistencia de Volúmenes

Crítico: Prevención de Pérdida de Datos

Si no montas estos volúmenes, tu agente perderá su personalidad, configuración y memorias cada vez que el contenedor se reinicie.
~/.openclaw

Almacena openclaw.json, claves de encriptación y credenciales de canales.

~/.openclaw/workspace

El Workspace. Contiene tus memorias Markdown, SOUL y skills personalizados.

Tutorial.step

Variables de Entorno Avanzadas

  • PORT: Sobrescribir puerto interno del gateway.
  • OPENCLAW_CONFIG_PATH: Ruta al config dentro del contenedor.
  • OPENCLAW_GATEWAY_TOKEN: Forzar un token de auth estático para el gateway.
Tutorial.step

Configuración Unraid & NAS

Al desplegar en Unraid o Synology, asegúrate de mapear rutas a tu share appdata:

  • Ruta de Config: /mnt/user/appdata/openclaw/config mapea a /root/.openclaw
  • Ruta de Datos: /mnt/user/appdata/openclaw/workspace mapea a /root/.openclaw/workspace
Tutorial.step

Solución de Problemas

Logs & Salud

Terminal
docker logs -f openclaw

Si ves Error: listen EADDRINUSE, otro proceso está usando el puerto 18789. Cambia el mapeo de puerto host en tu archivo compose a "18790:18789".

Profundidad de Arquitectura

Aprende cómo Docker interactúa con el loop del agente.

Siguiente: Arquitectura