> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Herramientas de sesión

OpenClaw ofrece a los agentes herramientas para trabajar entre sesiones, inspeccionar el estado y orquestar subagentes.

## Herramientas disponibles

| Herramienta        | Qué hace                                                                                            |
| ------------------ | --------------------------------------------------------------------------------------------------- |
| `sessions_list`    | Lista sesiones con filtros opcionales (tipo, etiqueta, agente, archivo, vista previa)               |
| `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`   | Genera una sesión aislada de subagente para trabajo en segundo plano                                |
| `sessions_yield`   | Finaliza el turno actual y espera resultados de seguimiento de subagentes                           |
| `subagents`        | Lista el estado de subagentes generados para esta sesión                                            |
| `session_status`   | Muestra una tarjeta de estilo `/status` y, opcionalmente, define una anulación de modelo por sesión |

Estas herramientas siguen sujetas al perfil de herramientas activo y a la política de permitir/denegar. `tools.profile: "coding"` incluye el conjunto completo de orquestación de sesiones, incluidos `sessions_spawn`, `sessions_yield` y `subagents`. `tools.profile: "messaging"` incluye herramientas de mensajería entre sesiones (`sessions_list`, `sessions_history`, `sessions_send`, `session_status`), pero no incluye la generación de subagentes. Para mantener un perfil de mensajería y aun así permitir delegación nativa, agrega:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    profile: "messaging",
    alsoAllow: ["sessions_spawn", "sessions_yield", "subagents"],
  },
}
```

Las políticas de grupo, proveedor, sandbox y por agente aún pueden quitar esas herramientas después de la etapa de perfil. Usa `/tools` desde la sesión afectada para inspeccionar la lista efectiva de herramientas.

## Listar y leer sesiones

`sessions_list` devuelve sesiones con su clave, agentId, tipo, canal, modelo, recuentos de tokens y marcas de tiempo. Filtra por `kinds` (arreglo; valores aceptados: `main`, `group`, `cron`, `hook`, `node`, `other`), `label` exacta, `agentId` exacto, texto `search` o recencia (`activeMinutes`). Las sesiones activas se devuelven de forma predeterminada; pasa `archived: true` para inspeccionar sesiones archivadas en su lugar. Las filas incluyen el estado `pinned` y `archived`. Define `includeDerivedTitles`, `includeLastMessage` o `messageLimit` (limitado a 20) cuando necesites triaje de estilo buzón: un título derivado con alcance de visibilidad, un fragmento de vista previa del último mensaje o mensajes recientes acotados en cada fila. Los títulos derivados y las vistas previas se producen solo para sesiones que el llamador ya puede ver según la política configurada de visibilidad de herramientas de sesión, por lo que las sesiones no relacionadas permanecen ocultas. Cuando la visibilidad está restringida, `sessions_list` devuelve metadatos opcionales `visibility` que muestran el modo efectivo y una advertencia de que los resultados pueden estar limitados por alcance.

`sessions_history` obtiene la transcripción de conversación de una sesión específica. De forma predeterminada, los resultados de herramientas se excluyen; pasa `includeTools: true` para verlos. Usa `limit` para la cola acotada más reciente. Pasa `offset: 0` cuando necesites metadatos de paginación y luego pasa los valores `nextOffset` devueltos para retroceder por ventanas de transcripción antiguas de OpenClaw sin leer archivos de transcripción sin procesar. Las páginas con offset explícito no fusionan importaciones externas de respaldo de la CLI; usa la vista predeterminada de cola más reciente (sin `offset`) cuando necesites ese historial de visualización fusionado.

La vista devuelta está intencionalmente acotada y filtrada por seguridad:

* el texto del asistente se normaliza antes de recordarlo:
  * se eliminan las etiquetas de razonamiento
  * se eliminan los bloques de andamiaje `<relevant-memories>` / `<relevant_memories>`
  * se eliminan los bloques de payload XML de llamadas a herramientas en texto plano, como `<tool_call>...</tool_call>`, `<function_call>...</function_call>`, `<tool_calls>...</tool_calls>` y `<function_calls>...</function_calls>`, incluidos payloads truncados que nunca se cierran correctamente
  * se elimina el andamiaje degradado de llamadas/resultados de herramientas, como `[Tool Call: ...]`, `[Tool Result ...]` y `[Historical context ...]`
  * se eliminan tokens filtrados de control del modelo, como `<|assistant|>`, otros tokens ASCII `<|...|>` y variantes de ancho completo `<｜...｜>`
  * se elimina XML malformado de llamadas a herramientas de MiniMax, como `<invoke ...>` / `</minimax:tool_call>`
* el texto similar a credenciales/tokens se redacta antes de devolverse
* los bloques de texto largos se truncan
* los historiales muy grandes pueden descartar filas antiguas o reemplazar una fila sobredimensionada por `[sessions_history omitted: message too large]`
* la herramienta informa indicadores de resumen como `truncated`, `droppedMessages`, `contentTruncated`, `contentRedacted`, `bytes` y metadatos de paginación

Ambas herramientas aceptan una **clave de sesión** (como `"main"`) o un **ID de sesión** de una llamada de lista anterior.

Si necesitas la transcripción exacta byte por byte, inspecciona el archivo de transcripción en disco en lugar de tratar `sessions_history` como un volcado sin procesar.

## Enviar mensajes entre sesiones

`sessions_send` entrega un mensaje a otra sesión y, opcionalmente, espera la respuesta:

* **Enviar y olvidar:** define `timeoutSeconds: 0` para ponerlo en cola y devolver inmediatamente.
* **Esperar respuesta:** define un tiempo de espera y recibe la respuesta en línea.

Las sesiones de chat con alcance de hilo, como las claves que terminan en `:thread:<id>`, no son destinos válidos de `sessions_send`. Usa la clave de sesión del canal padre para la coordinación entre agentes, de modo que los mensajes enrutados por herramientas no aparezcan dentro de un hilo activo orientado a personas.

Los mensajes y las respuestas de seguimiento A2A se marcan como datos entre sesiones en el prompt receptor (`[Inter-session message ... isUser=false]`) y en la procedencia de la transcripción. El agente receptor debe tratarlos como datos enrutados por herramientas, no como una instrucción creada directamente por un usuario final.

Después de que el destino responda, OpenClaw puede ejecutar un **bucle de respuesta** en el que los agentes alternan mensajes (hasta `session.agentToAgent.maxPingPongTurns`, rango 0-20, predeterminado 5). El agente destino puede responder `REPLY_SKIP` para detenerse antes.

## Ayudantes de estado y orquestación

`session_status` es la herramienta ligera equivalente a `/status` para la sesión actual u otra sesión visible. Informa uso, hora, estado de modelo/runtime y contexto de tarea en segundo plano vinculada cuando está presente. Al igual que `/status`, puede rellenar contadores dispersos de tokens/caché desde la última entrada de uso de la transcripción, y `model=default` borra una anulación por sesión. Usa `sessionKey="current"` para la sesión actual del llamador; las etiquetas visibles de cliente como `openclaw-tui` no son claves de sesión.

Cuando hay metadatos de ruta disponibles, `session_status` también incluye un bloque JSON visible `Route context` y campos estructurados `details` correspondientes. Estos campos desambiguan la clave de sesión de la ruta que está gestionando actualmente la ejecución en vivo:

* `origin` es donde se creó la sesión, o el proveedor inferido a partir de un prefijo de clave de sesión entregable cuando un estado antiguo no tiene metadatos de origen almacenados.
* `active` es la ruta actual de ejecución en vivo. Solo se informa para la sesión en vivo o actual que se está gestionando ahora.
* `deliveryContext` es la ruta de entrega persistida almacenada en la sesión, que OpenClaw puede reutilizar para entregas posteriores incluso cuando la superficie activa difiere.

`sessions_yield` finaliza intencionalmente el turno actual para que el siguiente mensaje pueda ser el evento de seguimiento que estás esperando. Úsalo después de generar subagentes cuando quieras que los resultados de finalización lleguen como el siguiente mensaje en lugar de crear bucles de sondeo.

`subagents` es el ayudante de visibilidad para subagentes de OpenClaw ya generados. Admite `action: "list"` para inspeccionar ejecuciones activas/recientes.

## Generar subagentes

`sessions_spawn` crea de forma predeterminada una sesión aislada para una tarea en segundo plano. Siempre es no bloqueante; devuelve inmediatamente un `runId` y `childSessionKey`. Las ejecuciones nativas de subagentes reciben la tarea delegada en el primer mensaje visible `[Subagent Task]` de la sesión hija, mientras que el prompt del sistema solo lleva reglas de runtime de subagente y contexto de enrutamiento.

Opciones clave:

* `runtime: "subagent"` (predeterminado) o `"acp"` para agentes de arnés externos.
* Anulaciones de `model` y `thinking` para la sesión hija.
* `thread: true` para vincular la generación a un hilo de chat (Discord, Slack, etc.).
* `sandbox: "require"` para imponer sandboxing en la hija.
* `context: "fork"` para subagentes nativos cuando la hija necesita la transcripción actual del solicitante; omítelo o usa `context: "isolated"` para una hija limpia. `context: "fork"` solo es válido con `runtime: "subagent"`. Los subagentes nativos vinculados a hilos usan de forma predeterminada `context: "fork"` salvo que `threadBindings.defaultSpawnContext` indique otra cosa.

Los subagentes hoja predeterminados no reciben herramientas de sesión. Cuando `maxSpawnDepth >= 2`, los subagentes orquestadores de profundidad 1 reciben además `sessions_spawn`, `subagents`, `sessions_list` y `sessions_history` para poder gestionar sus propios hijos. Las ejecuciones hoja siguen sin recibir herramientas de orquestación recursiva.

Después de completarse, un paso de anuncio publica el resultado en el canal del solicitante. La entrega de finalización conserva el enrutamiento de hilo/tema vinculado cuando está disponible, y si el origen de finalización solo identifica un canal, OpenClaw aún puede reutilizar la ruta almacenada de la sesión del solicitante (`lastChannel` / `lastTo`) para entrega directa.

Para comportamiento específico de ACP, consulta [Agentes ACP](/es/tools/acp-agents).

## Visibilidad

Las herramientas de sesión tienen alcance para limitar lo que el agente puede ver:

| Nivel   | Alcance                                                |
| ------- | ------------------------------------------------------ |
| `self`  | Solo la sesión actual                                  |
| `tree`  | Sesión actual + subagentes generados                   |
| `agent` | Todas las sesiones de este agente                      |
| `all`   | Todas las sesiones (entre agentes si está configurado) |

El valor predeterminado es `tree`. Las sesiones en sandbox se limitan a `tree` independientemente de la configuración.

## Lecturas adicionales

* [Gestión de sesiones](/es/concepts/session): enrutamiento, ciclo de vida, mantenimiento
* [Agentes ACP](/es/tools/acp-agents): generación de arneses externos
* [Multiagente](/es/concepts/multi-agent): arquitectura multiagente
* [Configuración de Gateway](/es/gateway/configuration): controles de configuración de herramientas de sesión

## Relacionado

* [Gestión de sesiones](/es/concepts/session)
* [Depuración de sesiones](/es/concepts/session-pruning)