Sesiones y Memoria

Las sesiones son la unidad central de gestión de conversaciones en OpenClaw. Mantienen contexto, estado y aislamiento entre diferentes conversaciones. Entender las sesiones es clave para configurar enrutamiento multi-agente y gestionar flujos de trabajo complejos.

Sesión Principal

La sesión principal es la sesión predeterminada para mensajes directos (DMs). Por defecto:

• Todos los mensajes directos colapsan en una sesión principal compartida
• El contexto se comparte entre todas las conversaciones DM
• Las herramientas se ejecutan en el host con acceso completo (para uso de confianza)
• Perfecto para uso personal donde quieres contexto unificado

Sesiones Grupales

Cada chat grupal obtiene su propia sesión aislada:

• El contexto está aislado de otros grupos y DMs
• Puede configurarse para ejecutarse en sandboxes Docker
• Soporta activación basada en menciones
• Cada grupo mantiene su propio historial de conversación

Sesiones Aisladas

Puedes crear sesiones aisladas para:

• Necesidades específicas de enrutamiento
• Aislamiento de seguridad
• Pruebas y desarrollo
• Configuraciones multi-agente

Modos de Activación

Controla cuándo el agente responde en una sesión:

• always - El agente responde a todos los mensajes
• mention - El agente solo responde cuando se le menciona (predeterminado para grupos)
• manual - El agente solo responde cuando se activa explícitamente

Modos de Cola

Cómo la sesión maneja solicitudes concurrentes:

• sequential - Procesa mensajes uno a la vez
• parallel - Maneja múltiples solicitudes simultáneamente
• priority - Procesa basado en niveles de prioridad

Gestión de Contexto

Las sesiones automáticamente:

• Cargan contexto y recuerdos relevantes
• Mantienen historial de conversación
• Podan contexto antiguo cuando es necesario
• Actualizan recuerdos basados en conversaciones

OpenClaw soporta enrutamiento de mensajes a diferentes agentes basado en varios criterios:

Enrutamiento por Canal

Enruta diferentes canales a diferentes agentes:

{
  "agents": {
    "list": [
      { "id": "whatsapp-agent", "workspace": "~/.openclaw/workspace-whatsapp" },
      { "id": "telegram-agent", "workspace": "~/.openclaw/workspace-telegram" }
    ]
  },
  "bindings": [
    { "match": { "channel": "whatsapp" }, "agentId": "whatsapp-agent" },
    { "match": { "channel": "telegram" }, "agentId": "telegram-agent" }
  ]
}

Enrutamiento por Par

Enruta contactos específicos a agentes dedicados:

{
  "bindings": [
    { 
      "match": { 
        "channel": "whatsapp",
        "peer": { "kind": "dm", "id": "+1234567890" }
      }, 
      "agentId": "work-agent" 
    }
  ]
}

Enrutamiento por Grupo

Cada grupo puede tener su propio espacio de trabajo de agente:

• Contexto aislado por grupo
• Diferentes habilidades y herramientas por grupo
• Memoria y configuración separadas

Aislamiento de Sesión

El aislamiento de sesión proporciona seguridad y separación de contexto:

• Aislamiento de Espacio de Trabajo - Cada agente tiene su propio directorio de espacio de trabajo
• Aislamiento de Memoria - Archivos de memoria separados por agente
• Aislamiento de Herramientas - Diferentes políticas de herramientas por sesión
• Aislamiento Sandbox - Los grupos pueden ejecutarse en contenedores Docker

OpenClaw proporciona herramientas para gestión de sesiones:

• ''sessions_list'' - Listar todas las sesiones activas
• ''sessions_history'' - Ver historial de conversación de sesión
• ''sessions_send'' - Enviar mensajes a sesiones específicas
• ''sessions_spawn'' - Crear nuevas sesiones aisladas

Estas herramientas permiten a los agentes gestionar y comunicarse con otras sesiones.

SessionsPage.config.intro

{
  "session": {
    "scope": "per-sender",
    "reset": {
      "mode": "daily",
      "atHour": 4
    }
  },
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"
      }
    }
  }
}

Las sesiones compactan automáticamente el contexto para gestionar el uso de tokens:

• ✂️
  Poda AutomáticaContexto antiguo eliminado cuando se alcanzan límites.
• 📝
  Resumen de MemoriaInformación importante resumida.
• ⚖️
  Gestión de TokensPermanece dentro de límites de contexto del modelo.

Esto asegura que las sesiones permanezcan eficientes mientras mantienen contexto importante.