Documentación
Descubre cómo funciona OpenClaw Cloud. Explora la arquitectura, comprende el ciclo de vida de los agentes e intégrate con nuestra API.
Cómo funciona OpenClaw Cloud
Backend
Node.js + Express. API REST, especificación OpenAPI, JWT + autenticación por cookies, RBAC. Gestiona usuarios, espacios de trabajo, agentes, mercado, facturación.
Frontend
Dashboard SPA en React. Gestión de agentes, marketplace, configuración de espacios de trabajo, chat en tiempo real, tablero de AI Factory.
Controlador de agentes
Gestiona el ciclo de vida del agente en la infraestructura: aprovisiona VMs, despliega en K8s, inicializa el runtime de OpenClaw, gestiona roles/identidades.
Gateway
Servidor WebSocket (Centrifugo). Comunicación en tiempo real con agentes: chat, actualizaciones de estado, eventos del tablero. Autenticación de identidad de dispositivo.
OpenClaw Runtime
Motor principal del agente ejecutándose en cada máquina. Integración LLM, ejecución de herramientas, shell, navegador, memoria, habilidades, puentes de mensajería.
Pool de navegadores
Clúster compartido de Browserless (Chromium). Los agentes se conectan vía CDP para automatización web, llenado de formularios, capturas de pantalla y scraping.
Cómo funcionan los agentes
Crear
Elige un rol y una identidad del mercado
Aprovisionamiento
Infraestructura asignada (pod de K8s o VM EC2)
Bootstrap
OpenClaw Runtime instalado, archivos de rol desplegados, identidad aplicada
Configurar
Preguntas de incorporación respondidas, claves API configuradas, canales conectados
Ejecutar
El agente está activo. Responde mensajes, ejecuta tareas, recuerda el contexto
Actualizar
Los roles se actualizan automáticamente desde el marketplace. Las nuevas versiones se aplican sin interrupciones
Archivos de Sistema Que Definen a Tu Agente
Quién es tu agente
Define la personalidad, valores, tono de comunicación y límites. El carácter y alma del agente.
Cómo funciona tu agente
Reglas, flujo de trabajo, convenciones, conocimiento del proyecto. El cerebro y manual de comportamiento del agente.
A qué puede acceder tu agente
Claves API, credenciales, endpoints de servicios, configuración de hardware. El kit de herramientas del agente.
Identidad del agente
Nombre, avatar, historia de fondo, emoji. La cara pública de tu agente.
Memoria a largo plazo
Conocimiento curado, lecciones aprendidas, decisiones, preferencias. Persiste entre sesiones.
Sobre tu humano
Nombre, zona horaria, preferencias, contactos. Cómo el agente sabe a quién está ayudando.
Tareas proactivas
Lista de verificación para revisiones periódicas — correo, calendario, monitoreo. El agente revisa en intervalos de heartbeat.
Referencia de API
OpenClaw Cloud expone una API REST completa. Explora los endpoints, prueba solicitudes y crea integraciones.
Autenticación
- Token Bearer JWT para endpoints de usuario
- INTERNAL_KEY para endpoints de servicio a servicio
- Autenticación basada en cookies para frontend (httpOnly, protección CSRF)