--- read_when: - Quieres comprender la compactación automática y `/compact` - Estás depurando sesiones largas que alcanzan los límites de contexto summary: Cómo OpenClaw resume conversaciones largas para mantenerse dentro de los límites del modelo title: Compaction x-i18n: generated_at: "2026-07-12T14:24:36Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 15 provider: openai source_hash: f00fb0cf59184ef450f1fc4d39a21a40ee4e8327d872766bca7f3642c0145514 source_path: concepts/compaction.md workflow: 16 --- Cada modelo tiene una ventana de contexto: el número máximo de tokens que puede procesar. Cuando una conversación se acerca a ese límite, OpenClaw **compacta** los mensajes anteriores en un resumen para que el chat pueda continuar. ## Cómo funciona 1. Los turnos anteriores de la conversación se resumen en una entrada compacta. 2. El resumen se guarda en la transcripción de la sesión. 3. Los mensajes recientes se mantienen intactos. OpenClaw mantiene las llamadas a herramientas del asistente emparejadas con sus entradas `toolResult` correspondientes cuando elige un punto de división para la compactación. Si el punto queda dentro de un bloque de herramientas, OpenClaw desplaza el límite para que el par permanezca unido y se conserve la parte final actual sin resumir. El historial completo de la conversación permanece en el disco. La compactación solo cambia lo que ve el modelo en el siguiente turno. Las configuraciones nuevas establecen de forma predeterminada `agents.defaults.compaction.mode` en `"safeguard"` (medidas de protección más estrictas y auditorías de calidad del resumen). Establezca explícitamente `mode: "default"` para desactivarlo. ## Compactación automática La compactación automática está activada de forma predeterminada. Se ejecuta cuando la sesión se acerca al límite de contexto o cuando el modelo devuelve un error de desbordamiento del contexto (en cuyo caso OpenClaw compacta y vuelve a intentarlo). Verá: - `embedded run auto-compaction start` / `complete` en los registros normales del Gateway. - `🧹 Auto-compaction complete` en el modo detallado. - `/status` mostrando `🧹 Compactions: `. Antes de compactar, OpenClaw recuerda automáticamente al agente que guarde las notas importantes en archivos de [memoria](/es/concepts/memory). Esto evita la pérdida de contexto. OpenClaw detecta decenas de cadenas de error de desbordamiento específicas de proveedores (Anthropic, OpenAI, Bedrock, Gemini, Ollama, OpenRouter y más). Algunos ejemplos habituales: - `request_too_large` - `context length exceeded` - `input exceeds the maximum number of tokens` - `input token count exceeds the maximum number of input tokens` (Bedrock) - `input is too long for the model` - `ollama error: context length exceeded` ## Compactación manual Escriba `/compact` en cualquier chat para forzar una compactación. Añada instrucciones para orientar el resumen: ```text /compact Céntrate en las decisiones de diseño de la API ``` Cuando se establece `agents.defaults.compaction.keepRecentTokens` (valor predeterminado: 20,000), la compactación manual respeta ese punto de corte y mantiene la parte final reciente en el contexto reconstruido. Sin un presupuesto explícito de conservación, la compactación manual se comporta como un punto de control estricto y continúa únicamente desde el nuevo resumen. ## Configuración Configure la compactación en `agents.defaults.compaction` dentro de su archivo `openclaw.json`. Las opciones más comunes se enumeran a continuación; para consultar la referencia completa, consulte [Análisis detallado de la gestión de sesiones](/es/reference/session-management-compaction). ### Uso de un modelo diferente De forma predeterminada, la compactación utiliza el modelo principal del agente. Establezca `agents.defaults.compaction.model` para delegar el resumen a un modelo más capaz o especializado. La sustitución acepta una cadena `provider/model-id` o un alias simple configurado en `agents.defaults.models`: ```json { "agents": { "defaults": { "compaction": { "model": "openrouter/anthropic/claude-sonnet-4-6" } } } } ``` Los alias simples configurados se resuelven a su proveedor y modelo canónicos antes de que comience la compactación. Si un valor simple coincide tanto con un alias como con un identificador literal de modelo configurado, prevalece el identificador literal del modelo. Un valor simple sin coincidencias permanece como identificador de modelo en el proveedor activo. Esto también funciona con modelos locales; por ejemplo, un segundo modelo de Ollama dedicado al resumen: ```json { "agents": { "defaults": { "compaction": { "model": "ollama/llama3.1:8b" } } } } ``` Cuando no está establecido, la compactación comienza con el modelo activo de la sesión. Si el resumen falla debido a un error del proveedor que permite usar un modelo alternativo, OpenClaw vuelve a intentar esa compactación mediante la cadena de modelos alternativos existente de la sesión. La opción alternativa es temporal y no se vuelve a escribir en el estado de la sesión. Una sustitución explícita de `agents.defaults.compaction.model` se mantiene exacta y no hereda la cadena de modelos alternativos de la sesión. ### Conservación de identificadores El resumen de compactación conserva los identificadores opacos de forma predeterminada (`identifierPolicy: "strict"`). Sustitúyalo por `identifierPolicy: "off"` para desactivarlo, o por `identifierPolicy: "custom"` junto con `identifierInstructions` para proporcionar instrucciones personalizadas. ### Protección por bytes de la transcripción activa Cuando se establece `agents.defaults.compaction.maxActiveTranscriptBytes`, OpenClaw activa la compactación local normal antes de una ejecución si el historial de la transcripción alcanza ese tamaño. Esto resulta útil en sesiones de larga duración en las que la gestión del contexto por parte del proveedor puede mantener en buen estado el contexto del modelo mientras el historial persistente de la transcripción sigue creciendo. No divide los bytes sin procesar; solicita a la canalización normal de compactación que cree un resumen semántico. La protección por bytes se aplica al historial de la transcripción activa de SQLite. Los artefactos de puntos de control JSONL heredados no son el objetivo activo de la compactación. ### Transcripciones sucesoras Cuando `agents.defaults.compaction.truncateAfterCompaction` está habilitado, OpenClaw no reescribe la transcripción existente en el mismo lugar. Crea una nueva transcripción sucesora activa a partir del resumen de compactación, el estado conservado y la parte final sin resumir, y después registra metadatos del punto de control que dirigen los flujos de ramificación y restauración hacia esa sucesora compactada. Las transcripciones sucesoras también descartan los turnos largos del usuario que sean duplicados exactos y lleguen dentro de una breve ventana de reintento, para que las tormentas de reintentos del canal no se transfieran a la siguiente transcripción activa después de la compactación. OpenClaw ya no escribe copias independientes `.checkpoint.*.jsonl` para las compactaciones nuevas. Los archivos de puntos de control heredados existentes aún pueden utilizarse mientras estén referenciados y se eliminan mediante la limpieza normal de sesiones. ### Avisos de compactación De forma predeterminada, la compactación se ejecuta silenciosamente. Establezca `notifyUser` para mostrar breves mensajes de estado cuando la compactación comience y termine, y para mostrar un aviso de degradación cuando se agote un volcado de memoria previo a la compactación, pero la respuesta continúe: ```json5 { agents: { defaults: { compaction: { notifyUser: true, }, }, }, } ``` ### Volcado de memoria Antes de la compactación, OpenClaw puede ejecutar un turno de **volcado silencioso de memoria** para almacenar notas persistentes en el disco. Establezca `agents.defaults.compaction.memoryFlush.model` cuando este turno de mantenimiento deba utilizar un modelo local en lugar del modelo activo de la conversación: ```json { "agents": { "defaults": { "compaction": { "memoryFlush": { "model": "ollama/qwen3:8b" } } } } } ``` La sustitución del modelo para el volcado de memoria es exacta y no hereda la cadena de modelos alternativos de la sesión activa. Consulte [Memoria](/es/concepts/memory) para obtener información detallada sobre el proceso y la configuración. ## Proveedores de compactación conectables Los Plugins pueden registrar un proveedor de compactación personalizado mediante `registerCompactionProvider()` en la API del Plugin. Cuando un proveedor está registrado y configurado, OpenClaw le delega el resumen en lugar de utilizar la canalización de LLM integrada. Para utilizar un proveedor registrado, establezca su identificador en la configuración: ```json { "agents": { "defaults": { "compaction": { "provider": "my-provider" } } } } ``` Establecer un `provider` fuerza automáticamente `mode: "safeguard"`. Los proveedores reciben las mismas instrucciones de compactación y la misma política de conservación de identificadores que la ruta integrada, y OpenClaw sigue conservando el contexto del sufijo de los turnos recientes y divididos después de la salida del proveedor. Si el proveedor falla o devuelve un resultado vacío, OpenClaw recurre al resumen mediante el LLM integrado. ## Compactación frente a poda | | Compactación | Poda | | ---------------- | --------------------------------------------- | --------------------------------------------- | | **Qué hace** | Resume la conversación anterior | Recorta los resultados antiguos de herramientas | | **¿Se guarda?** | Sí (en la transcripción de la sesión) | No (solo en memoria, por solicitud) | | **Ámbito** | Toda la conversación | Solo los resultados de herramientas | La [poda de sesiones](/es/concepts/session-pruning) es un complemento más ligero que recorta la salida de las herramientas sin resumirla. ## Solución de problemas **¿La compactación se ejecuta con demasiada frecuencia?** Es posible que la ventana de contexto del modelo sea pequeña o que las salidas de las herramientas sean grandes. Pruebe a habilitar la [poda de sesiones](/es/concepts/session-pruning). **¿El contexto parece desactualizado después de la compactación?** Utilice `/compact Focus on ` para orientar el resumen o habilite el [volcado de memoria](/es/concepts/memory) para conservar las notas. **¿Necesita empezar desde cero?** `/new` inicia una sesión nueva sin compactar. Para obtener información sobre la configuración avanzada (tokens reservados, conservación de identificadores, motores de contexto personalizados y compactación del lado del servidor de OpenAI), consulte el [análisis detallado de la gestión de sesiones](/es/reference/session-management-compaction). ## Contenido relacionado - [Sesión](/es/concepts/session): gestión y ciclo de vida de las sesiones. - [Poda de sesiones](/es/concepts/session-pruning): recorte de los resultados de las herramientas. - [Contexto](/es/concepts/context): cómo se crea el contexto para los turnos del agente. - [Hooks](/es/automation/hooks): Hooks del ciclo de vida de la compactación (`before_compaction`, `after_compaction`).