Gestiona tus sesiones en OpenClaw: Guía de herramientas

Si alguna vez has intentado coordinar varios agentes a la vez, sabrás que mantener el contexto sincronizado es un reto constante. A veces solo necesitas que un agente le pregunte algo a otro o que delegue una tarea pesada en segundo plano sin detener su flujo principal.

OpenClaw soluciona esto dándole a tus agentes herramientas para trabajar entre sesiones: pueden listar conversaciones, leer historiales, enviar mensajes a otras sesiones y crear sub-agentes de forma nativa.

Session Tools

OpenClaw da a los agentes herramientas para trabajar a través de sesiones: listar conversaciones, leer el historial, enviar mensajes a otras sesiones y crear sub-agentes.

Herramientas disponibles

Herramienta	Qué hace
sessions_list	Lista sesiones con filtros opcionales (tipo, antigüedad)
sessions_history	Lee la transcripción de una sesión específica
sessions_send	Envía un mensaje a otra sesión y, opcionalmente, espera
sessions_spawn	Crea una sesión de sub-agente aislada para trabajo en segundo plano

Listar y leer sesiones

sessions_list devuelve sesiones con su key, tipo, channel, model, conteo de tokens y marcas de tiempo. Puedes filtrar por tipo (main, group, cron, hook, node) o por actividad reciente (activeMinutes).

sessions_history obtiene la transcripción de la conversación de una sesión específica. Por defecto, los resultados de las herramientas se excluyen; pasa includeTools: true si necesitas verlos.

Ambas herramientas aceptan una session key (como "main") o un session ID obtenido de una llamada de lista previa.

Enviar mensajes entre sesiones

sessions_send entrega un mensaje a otra sesión y te permite elegir si quieres esperar la respuesta:

• Fire-and-forget: establece timeoutSeconds: 0 para encolar el mensaje y retornar inmediatamente.
• Esperar respuesta: define un tiempo de espera para recibir la respuesta en la misma ejecución.

Cuando el objetivo responde, OpenClaw puede ejecutar un bucle de respuesta donde los agentes alternan mensajes (hasta 5 turnos). El agente de destino puede responder REPLY_SKIP para detener el proceso antes de tiempo.

Crear sub-agentes

sessions_spawn crea una sesión aislada para una tarea en segundo plano. Esta acción nunca bloquea el flujo; devuelve inmediatamente un runId y una childSessionKey.

Opciones clave:

• runtime: "subagent" (por defecto) o "acp" para agentes con arnés externo.
• Sobrescritura de model y thinking para la sesión hija.
• thread: true para vincular la creación a un hilo de chat (Discord, Slack, etc.).
• sandbox: "require" para obligar al uso de sandboxing en el hijo.

Los sub-agentes reciben el conjunto completo de herramientas excepto las de sesión (no se permite la creación recursiva). Al terminar, un paso de anuncio publica el resultado en el canal del solicitante.

Si necesitas detalles sobre el comportamiento específico de ACP, revisa ACP Agents.

Visibilidad

Las herramientas de sesión están limitadas para controlar qué puede ver el agente:

Nivel	Alcance
self	Solo la sesión actual
tree	Sesión actual + sub-agentes creados
agent	Todas las sesiones de este agente
all	Todas las sesiones (incluso entre agentes si se configura)

El valor predeterminado es tree. Las sesiones en sandbox están restringidas a tree sin importar la configuración del Gateway.

Lecturas adicionales

• Session Management — enrutamiento, ciclo de vida y mantenimiento.
• ACP Agents — creación de agentes con arnés externo.
• Multi-agent — arquitectura de múltiples agentes.
• Gateway Configuration — ajustes de configuración para herramientas de sesión.

AI Setup Assistant