Introduccion

OpenClaws es una plataforma gestionada para desplegar y orquestar agentes de IA impulsados por OpenClaw, construida sobre el stack de HashiCorp.

Que es OpenClaws?

OpenClaws proporciona infraestructura de nivel empresarial para ejecutar agentes de IA. En lugar de gestionar clusters de Nomad, secretos de Vault y mallas de servicio de Consul por tu cuenta, despliegas agentes a traves de un panel de control simple o API y OpenClaws se encarga del resto.

La plataforma utiliza una jerarquia Usuario > Agentes. Cada usuario obtiene un entorno aislado (namespace de Nomad, arbol de secretos de Vault, identidad de Consul) y puede desplegar multiples agentes de IA dentro de ese entorno.

Modelo de Dominio

user_model.txt

User ("alice")                                  ← owns the account, has a plan
  |-- Agent "manager"                           ← default orchestrator agent
  |-- Agent "researcher"                        ← specialist agent
  |-- Agent "writer"                            ← specialist agent
  +-- [quota: 1024 MHz CPU, 2048 MB total]      ← Nomad resource quota (plan-3)

El patron recomendado es un manager (orquestador predeterminado que delega trabajo) acompanado de agentes especialistas (researcher, writer, etc.). Todos los agentes de un usuario se ejecutan en un unico contenedor gateway de OpenClaw. La comunicacion entre agentes funciona en proceso via sessions_spawn — no se necesita red entre contenedores.

Conceptos Clave

Aislamiento de Namespace

Cada usuario obtiene un namespace dedicado de Nomad (oc-{user}) con cuotas de recursos estrictas. Tus agentes nunca pueden acceder a los recursos de otro usuario.

BYOK (Trae Tu Propia Clave)

Tu proporcionas tu propia clave de API de Anthropic. Se cifra en reposo usando Vault Transit (AES-256-GCM) y solo se descifra en memoria cuando tu contenedor se inicia.

Un Contenedor Por Usuario

Todos los agentes se ejecutan en un unico contenedor gateway de OpenClaw. Esto simplifica la red, reduce la sobrecarga de recursos y habilita la comunicacion rapida entre agentes en proceso.

Almacenamiento Persistente

Cada usuario obtiene un disco persistente GCE de 10 GB. Las conversaciones, archivos y datos del espacio de trabajo sobreviven a reinicios, redespliegues y migraciones de nodos.

Mapeo de Recursos

Recurso	Patron	Ejemplo
Namespace de Nomad	oc-{user}	oc-alice
Cuota de Nomad	quota-{user}	quota-alice
Job de Nomad	oc-{user}	oc-alice
Servicio de Consul	oc-{user}	oc-alice
Secretos de Vault	secret/openclaw/oc-{user}/{agent}	secret/openclaw/oc-alice/manager
Volumen CSI	oc-{user}-data	oc-alice-data

Siguientes Pasos

→ Guia de Inicio Rapido — Despliega tu primer agente en minutos
→ Arquitectura — Profundiza en el flujo de aprovisionamiento
→ Configuracion de Agentes — Configura la orquestacion multi-agente