Configuracion de Agentes

Como configurar agentes individuales y patrones de orquestacion multi-agente.

Conceptos Basicos de Agentes

Cada agente se ejecuta dentro del unico contenedor gateway de OpenClaw del usuario. Los nombres de agentes deben coincidir con el patron: ^[a-z][a-z0-9-]{0,29}[a-z0-9]$ (minusculas, letras/numeros/guiones, maximo 31 caracteres).

Cuando se crea un agente, OpenClaws genera:

Clave API — 32 bytes de crypto/rand, codificada en hexadecimal (64 caracteres)
Token de Gateway — Utilizado para autenticarse con el gateway de OpenClaw
Secreto en Vault — Almacenado en secret/openclaw/oc-{user}/{agent}

Patron Recomendado

La configuracion multi-agente recomendada utiliza un agente manager como orquestador predeterminado, con agentes especialistas manejando tareas especificas:

agent_pattern.txt

manager      ← default orchestrator, delegates work
researcher   ← specialist: handles research tasks
writer       ← specialist: handles content generation

El agente manager puede iniciar sesiones con cualquier especialista usando sessions_spawn.

Configuracion Multi-Agente

Se requieren tres elementos de configuracion para la comunicacion entre agentes:

1. tools.agentToAgent

En openclaw.json, habilita la mensajeria entre agentes y lista los destinos permitidos:

openclaw.json (excerpt)

{
  "tools": {
    "agentToAgent": {
      "enabled": true,
      "allow": ["manager", "researcher", "writer"]
    }
  }
}

2. subagents.allowAgents

Cada agente en el array agents.list especifica que agentes puede iniciar:

openclaw.json agents.list

{
  "agents": {
    "list": [
      {
        "id": "manager",
        "default": true,
        "subagents": { "allowAgents": ["*"] }
      },
      {
        "id": "researcher",
        "subagents": { "allowAgents": ["manager"] }
      },
      {
        "id": "writer",
        "subagents": { "allowAgents": ["manager"] }
      }
    ]
  }
}

Usa ["*"] para permitir iniciar cualquier agente, o lista IDs de agentes especificos.

3. auth-profiles.json

Cada agente necesita un perfil de autenticacion en ~/.openclaw/agents/{id}/agent/auth-profiles.json:

auth-profiles.json

{
  "anthropic:default": {
    "provider": "anthropic",
    "mode": "api_key"
  }
}

Este archivo declara el metodo de autenticacion. La clave API real proviene de la variable de entorno ANTHROPIC_API_KEY inyectada desde Vault. El script de inicio escribe este archivo automaticamente para cada agente.

Importante

auth-profiles.json NO es lo mismo que auth.json. El primero declara las credenciales del proveedor; el segundo son metadatos del agente. La herramienta agents_list solo muestra el agente que la llama, pero sessions_spawn funciona entre agentes si los tres elementos de configuracion estan presentes.

Espacios de Trabajo de Agentes

Cada agente obtiene su propio directorio de espacio de trabajo en el volumen persistente:

Agente predeterminado: ~/.openclaw/workspace
Otros agentes: ~/.openclaw/workspace-{id}

Acceso al Gateway

El gateway de OpenClaw se ejecuta en el puerto 18789 dentro del contenedor. Para conectarse:

Chat del Panel: Integrado — haz clic en "Chat" en cualquier agente en ejecucion
API: Usa el endpoint GET /api/v1/users/{user}/agents/{agent}/connect para obtener la URL del gateway y el token
Proxy de Chat: Usa POST /api/v1/users/{user}/agents/{agent}/chat para enviar mensajes a traves del API de gestion