Arquitectura de OpenClaw: nodes y gateway

Arquitectura de OpenClaw: Componentes clave e interacciones

OpenClaw utiliza una arquitectura de hub-and-spoke con un Gateway central como plano de control. Esta configuración permite que el agente interactúe con dispositivos periféricos y canales de E/S. Comprender los roles de nodo, sesión, canal y operador facilita a desarrolladores intermedios y senior la configuración y uso del sistema.

Un Nodo actúa como dispositivo compañero, conectándose al Gateway vía WebSocket con role: "node". Expone una superficie de comandos a través de node.invoke, que incluye canvas., camera., device., notifications., system.* y system.run.

Roles e interacciones de los actores

El Gateway gestiona conexiones de nodos y operadores, coordina canales y sesiones, y maneja el emparejamiento de dispositivos. Los canales se integran con mensajeros como WhatsApp, Telegram, Discord, Slack y Signal, enrutando mensajes hacia la sesión → agente y viceversa.

| Actor | Responsabilidad | Interacciones |

|-------------|---------------------------------|---------------------------------------|

| Gateway | Plano de control | Conexiones nodo/operador, gestión de sesión/canal |

| Canales| Integración con mensajeros | Mensajes a Gateway → Sesión → Agente |

| Nodos | Periféricos | Conexión con role: node, node.invoke |

| Operadores| Gestión | Emparejamiento, aprobaciones, configuración |

| Sesiones| Contexto del agente | Almacenamiento de historial y estado |

| Agente | Entorno de ejecución de IA | Llamadas a herramientas/nodos en sesión |

| Usuario | Usuario final | Vía canales/operadores |

| Dispositivos | Dispositivos conectados | Emparejamiento vía Gateway |

Flujo: Usuario → Canal → Gateway → Sesión → Agente → Nodo/Canal. El operador aprueba emparejamientos y acciones.

Tipos de nodos:

• App en barra de menú de macOS
• iOS/Android para cámara, GPS, pantalla
• Sin interfaz (openclaw node run) para servidores
• Extensión de VS Code

Canvas y A2UI en el ecosistema

Canvas es un espacio de trabajo visual controlado por el agente. A2UI es un protocolo para generar interfaces dinámicamente. El agente llama a canvas.present o canvas.a2ui.push para crear descripciones JSON de UI, renderizadas en nodos (macOS, iOS, Android, web).

Casos de uso:

• Cuadros de mando dinámicos
• Formularios interactivos
• Visualización de datos
• Apps nativas de IA (CRM, monitoreo)
• Juegos, galerías

Las acciones del usuario fluyen de vuelta al agente vía WebSocket para actualizaciones en tiempo real.

Caso real: CRM personal

Problema: Datos dispersos en Gmail, WhatsApp, Calendario, Notion.

Flujo del usuario: Mensaje en Telegram: "Perfil de Ivan Ivanov." El agente abre Canvas con pestañas, campos e historial.

Resultado: CRM unificado impulsado por IA con actualizaciones en tiempo real.

Arquitectura: Canal → Gateway → Sesión → Agente (habilidad canvas + A2UI) → Nodo (UI). El operador gestiona aprobaciones; datos almacenados en sesión.

Caso real: Resumen matutino

Problema: Recopilación manual de datos de calendario, email, clima (10-15 min).

Flujo del usuario: "Resumen" → seguimientos como "Clima en Moscú."

Resultado: Resumen con gráficos en Canvas.

Arquitectura: Tarea programada en Gateway → Sesión → Agente (habilidades: calendario/email/clima) → Canal/Canvas. Nodo sin interfaz opcional.

Caso real: Lista de compras familiar

Problema: Caos en chats grupales.

Flujo del usuario: Mensajes en grupo de Telegram → "Mostrar carrito" → Canvas con lista y botones.

Resultado: Lista actualizada en nodo móvil.

Arquitectura: Canal (grupo) → Gateway → Sesión → Agente (análisis, canvas) → Nodo móvil. WebSocket para acciones.

Caso real: Orquestación multiagente

Problema: Un solo agente pierde enfoque.

Flujo del usuario: "Pase de lista" → delegación de tareas.

Resultado: Informe final del equipo de agentes.

Arquitectura: Gateway (múltiples sesiones) → Agente líder (delegación) → Nodos por agente → Canal.

Caso real: Granja de impresoras 3D

Problema: Monitoreo manual de impresoras Bambu Lab.

Flujo del usuario: "Estado de X1C," "Imprime Benchy," "Muestra cámara."

Resultado: Control remoto con feed de cámara.

Arquitectura: Canal → Gateway → Sesión → Agente → Nodo físico (integración Bambu) → Impresoras.

Lecciones clave

• El Gateway es el núcleo central: nada funciona sin él.
• Los Nodos extienden el agente a dispositivos: sin interfaz para servidores, móviles para sensores.
• Canvas/A2UI convierten chats en interfaces completas.
• Las Sesiones aíslan contextos y almacenan memoria.
• Los Operadores garantizan emparejamientos y aprobaciones seguras.

— Editorial Team