Manual de Deploy — VEGA

NUNCA cambia · Tiempo: ~3 min · Siempre cacheada después del primer build

FROM node:24-slim

RUN apt-get update && apt-get install -y \
    git ca-certificates \
    chromium fonts-liberation libatk-bridge2.0-0 ... \
    && rm -rf /var/lib/apt/lists/*

ENV CHROME_BIN=/usr/bin/chromium
ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true

¿Qué instala y para qué?

PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true le dice a Puppeteer que no descargue su propio Chromium porque ya instalamos el del sistema. Sin esto, el build fallaría o descargaría un Chromium duplicado.

Cambia con versiones de OpenClaw · Tiempo: ~4 min · Cacheada hasta el próximo update

RUN npm install --no-audit --no-fund openclaw@2026.4.11 && \
    ln -s /app/node_modules/.bin/openclaw /usr/local/bin/openclaw

¿Qué es OpenClaw?

OpenClaw es el runtime de agentes. Es el framework que maneja todo lo que Jarvis necesita para existir: conectarse a Telegram, recibir mensajes, llamar al modelo de IA, ejecutar plugins, manejar sesiones y turnos de conversación. Sin OpenClaw, habría que programar todo eso desde cero.

El ln -s crea un symlink para que el comando openclaw esté disponible en cualquier directorio del sistema (en lugar de tener que escribir /app/node_modules/.bin/openclaw cada vez).

--no-audit --no-fund: desactiva chequeos de seguridad en red y mensajes de donaciones de npm para acelerar el install.

Rara vez cambia · Tiempo: ~2 min · Cacheada casi siempre

RUN npm install --no-audit --no-fund \
    grammy \
    @grammyjs/runner \
    @grammyjs/transformer-throttler \
    @grammyjs/conversations \
    @grammyjs/menu \
    @grammyjs/hydrate \
    @grammyjs/parse-mode \
    @grammyjs/ratelimiter

¿Qué es grammY y por qué está separado?

grammY es la librería de Node.js para bots de Telegram. OpenClaw la usa internamente para conectarse a la API de Telegram. Está separada en su propia capa porque es un conjunto estable de paquetes que casi nunca necesita actualizarse.

Cambia al agregar integraciones · Tiempo: ~1 min

RUN npm install --no-audit --no-fund \
    redis \
    @supabase/supabase-js

¿Para qué sirve cada una?

Estas librerías están en la imagen base (en /app/node_modules/) y también se instalan localmente en cada extensión durante el Stage 6b del entrypoint. La razón: Node resuelve módulos locales primero — si la extensión tiene su propio node_modules/ incompleto, ignoraría los de la imagen base.

Cambia frecuentemente · Tiempo: <1 segundo · Solo copia 1 archivo

COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh

EXPOSE 18789
ENTRYPOINT ["/entrypoint.sh"]

Esta capa solo copia el script de arranque. Es la más liviana — no descarga nada. Gracias a las capas separadas anteriores, cambiar el entrypoint no invalida ninguna otra capa y el rebuild tarda segundos.

EXPOSE 18789 documenta que el gateway de OpenClaw escucha en ese puerto (aunque en producción el acceso es solo interno, mapeado a 127.0.0.1:18789).

ENTRYPOINT ["/entrypoint.sh"]: cuando el contenedor arranca, lo primero que ejecuta es este script. No hay un CMD separado — el entrypoint es el proceso principal (PID 1 via exec openclaw gateway).

{
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "${GATEWAY_TOKEN}"
    }
  }
}

El gateway es la API HTTP interna que recibe mensajes de los canales (Telegram, futuros) y los distribuye a los agentes. mode: "local" significa que corre en el mismo proceso que los agentes. auth.mode: "token" requiere que todo cliente que llame a la API presente el token correcto en el header.

{
  "agents": {
    "defaults": {
      "workspace": "/root/.openclaw/workspace",
      "model": { "primary": "openai-codex/gpt-5.4" }
    },
    "list": [
      { "id": "jarvis",      "default": true, "agentDir": "..." },
      { "id": "financiero",                   "agentDir": "..." },
      { "id": "inversiones",                  "agentDir": "..." },
      { "id": "bienestar",                    "agentDir": "..." }
    ]
  }
}

{
  "bindings": [
    { "agentId": "jarvis",     "match": { "channel": "telegram", "peer": { "kind": "group", "id": "-1003976110854:topic:1" } } },
    { "agentId": "financiero", "match": { "channel": "telegram", "peer": { "kind": "group", "id": "-1003976110854:topic:2" } } },
    ...
  ]
}

Los bindings son las reglas de routing: qué agente responde a qué mensaje. Cuando llega un mensaje de Telegram, OpenClaw busca el binding que coincida con el canal y el peer (grupo + topic) y le asigna el agente correspondiente.

El ID -1003976110854:topic:2 es el ID interno de Telegram del grupo (-1003976110854) combinado con el número de topic (2).

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "dmPolicy": "allowlist",
      "allowFrom": ["601102393"],
      "groups": {
        "-1003976110854": {
          "requireMention": false,
          "allowFrom": ["601102393"]
        }
      }
    }
  }
}

{
  "plugins": {
    "enabled": true,
    "allow": ["vega-context"],
    "slots": { "contextEngine": "vega-context" },
    "entries": {
      "groq":       { "enabled": true },
      "elevenlabs": { "enabled": true },
      "firecrawl":  { "enabled": true },
      "vega-context": { "enabled": true }
    }
  }
}

slots.contextEngine: "vega-context" le dice a OpenClaw que este plugin es el motor de contexto — se llama automáticamente en cada turno.

{
  "tools": {
    "web": {
      "search": { "enabled": true, "openaiCodex": { "enabled": true, "mode": "live" } },
      "fetch":  { "enabled": true, "provider": "firecrawl" }
    },
    "media": {
      "audio": { "enabled": true, "language": "es", "models": [{ "provider": "groq", "model": "whisper-large-v3" }] },
      "image": { "enabled": true }
    }
  }
}

{
  "messages": {
    "tts": {
      "auto": "inbound",
      "provider": "elevenlabs",
      "maxTextLength": 280,
      "providers": {
        "elevenlabs": {
          "voiceId": "3cBYXsbKACmcb0rHwMjm",
          "modelId": "eleven_multilingual_v2",
          "voiceSettings": {
            "stability": 0.64,
            "similarityBoost": 0.80,
            "style": 0.12,
            "useSpeakerBoost": true,
            "speed": 1.18
          }
        }
      }
    }
  }
}