Contexto
Contexto: lo que ve el modelo, cómo se construye y cómo inspeccionarlo
Modelo mental para principiantes:
- **Prompt del sistema** (construido por OpenClaw): reglas, herramientas, lista de habilidades, tiempo/runtime, y archivos de espacio de trabajo inyectados.
- **Historial de conversación**: tus mensajes + los mensajes del asistente para esta sesión.
- **Llamadas/resultados de herramientas + adjuntos**: salida de comandos, lecturas de archivos, imágenes/audio, etc.
El contexto _no es lo mismo_ que "memoria": la memoria puede almacenarse en disco y recargarse después; el contexto es lo que está dentro de la ventana actual del modelo.
Inicio rápido (inspeccionar contexto)
- ''/status'' → vista rápida "¿qué tan llena está mi ventana?" + configuración de sesión.
- ''/context list'' → qué está inyectado + tamaños aproximados (por archivo + totales).
- ''/context detail'' → desglose más profundo: por archivo, por esquema de herramienta, por entrada de habilidad, y tamaño del prompt del sistema.
- ''/usage tokens'' → añadir pie de uso por respuesta a las respuestas normales.
- ''/compact'' → resumir historial antiguo en una entrada compacta para liberar espacio de ventana.
Ver también: [Comandos slash](/tools/slash-commands), [Uso de tokens y costos](/token-use), [Compactación](/concepts/compaction).
Qué cuenta hacia la ventana de contexto
Todo lo que recibe el modelo cuenta, incluyendo:
Cómo OpenClaw construye el prompt del sistema
🧠 Desglose de contexto Espacio de trabajo: '<workspaceDir>' Bootstrap max/archivo: 20,000 caracteres Sandbox: modo=non-main sandboxed=false Prompt del sistema (ejecución): 38,412 caracteres (~9,603 tok) (Contexto de Proyecto 23,901 caracteres (~5,976 tok)) Archivos de espacio de trabajo inyectados: - AGENTS.md: OK | raw 1,742 caracteres (~436 tok) | inyectado 1,742 caracteres (~436 tok) - SOUL.md: OK | raw 912 caracteres (~228 tok) | inyectado 912 caracteres (~228 tok) - TOOLS.md: TRUNCADO | raw 54,210 caracteres (~13,553 tok) | inyectado 20,962 caracteres (~5,241 tok) - IDENTITY.md: OK | raw 211 caracteres (~53 tok) | inyectado 211 caracteres (~53 tok) - USER.md: OK | raw 388 caracteres (~97 tok) | inyectado 388 caracteres (~97 tok) - HEARTBEAT.md: FALTANTE | raw 0 | inyectado 0 - BOOTSTRAP.md: OK | raw 0 caracteres (~0 tok) | inyectado 0 caracteres (~0 tok) Lista de habilidades (texto del prompt del sistema): 2,184 caracteres (~546 tok) (12 habilidades) Herramientas: read, edit, write, exec, process, browser, message, sessions_send, … Lista de herramientas (texto del prompt del sistema): 1,032 caracteres (~258 tok) Esquemas de herramientas (JSON): 31,988 caracteres (~7,997 tok) (cuenta hacia contexto; no mostrado como texto) Herramientas: (igual que arriba) Tokens de sesión (en caché): 14,250 total / ctx=32,000
Archivos de espacio de trabajo inyectados (Contexto de Proyecto)
🧠 Desglose de contexto (detallado) … Habilidades principales (tamaño de entrada del prompt): - frontend-design: 412 caracteres (~103 tok) - oracle: 401 caracteres (~101 tok) … (+10 más habilidades) Herramientas principales (tamaño de esquema): - browser: 9,812 caracteres (~2,453 tok) - exec: 6,240 caracteres (~1,560 tok) … (+N más herramientas)
Habilidades: qué se inyecta vs se carga bajo demanda
El prompt del sistema incluye una **lista de habilidades** compacta (nombre + descripción + ubicación). Esta lista tiene sobrecarga real.
Las instrucciones de habilidades _no_ se incluyen por defecto. Se espera que el modelo ''read'' el ''SKILL.md'' de la habilidad **solo cuando sea necesario**.
- Historial de conversación.
- Llamadas de herramientas + resultados de herramientas.
- Adjuntos / scripts (imágenes/audio/archivos).
- Resúmenes de compactación y artefactos de poda.'
'- "Wrappers" de proveedor o encabezados ocultos (invisibles, aún cuentan).
Herramientas: hay dos costos
Las herramientas afectan el contexto de dos maneras:
1. **Texto de lista de herramientas** en el prompt del sistema (lo que ves como "Herramientas").
2. **Esquemas de herramientas** (JSON). Estos se envían al modelo para que pueda llamar herramientas. Cuentan hacia el contexto aunque no los veas como texto plano.
''/context detail'' desglosa los esquemas de herramientas más grandes para que puedas ver qué domina.
- Hora (UTC + hora de usuario convertida si está configurada).
- Metadatos de runtime (host/OS/modelo/thinking).
- Archivos bootstrap del espacio de trabajo inyectados bajo ''Contexto de Proyecto''.'
''
'Desglose completo: ''prompt del sistema''.
Comandos, directivas y "atajos en línea"
Los comandos slash son manejados por el Gateway. Hay varios comportamientos diferentes:
- **Comandos independientes**: un mensaje que es solo ''/...'' se ejecuta como comando.
- **Directivas**: ''/think'', ''/verbose'', ''/reasoning'', ''/elevated'', ''/model'', ''/queue'' se eliminan antes de que el modelo vea el mensaje.
- Los mensajes solo de directivas persisten la configuración de sesión.
- Las directivas en línea en un mensaje normal actúan como sugerencias por mensaje.
- **Atajos en línea** (solo remitentes en lista permitida): ciertos tokens ''/...'' dentro de un mensaje normal pueden ejecutarse inmediatamente (ejemplo: "hey /status"), y se eliminan antes de que el modelo vea el texto restante.
Detalles: [Comandos slash](/tools/slash-commands).
- ''BOOTSTRAP.md'' (solo primera ejecución)'
''
'Los archivos grandes se truncan por archivo usando ''agents.defaults.bootstrapMaxChars'' (predeterminado ''20000'' caracteres). ''/context'' muestra tamaños ''raw vs. inyectado'' y si ocurrió truncamiento.
Sesiones, compactación y poda (qué persiste)
Lo que persiste entre mensajes depende del mecanismo:
- **Historial normal** persiste en la transcripción de la sesión hasta ser compactado/podado por política.
Qué reporta realmente /context
''/context'' prefiere el último reporte de prompt del sistema **construido en ejecución** cuando está disponible:
- ''System prompt (run)'' = capturado de la última ejecución embebida (con capacidad de herramientas) y persistido en el almacén de sesiones.
- ''System prompt (estimate)'' = calculado al vuelo cuando no existe reporte de ejecución (o cuando se ejecuta via un backend CLI que no genera el reporte).
Comandos, directivas y "atajos en línea"
Los comandos slash son manejados por el gateway. Hay varios comportamientos diferentes:
- ''Comandos independientes'': mensajes que son solo ''/...'' se ejecutan como comandos.
- ''Directivas'': ''/think'', ''/verbose'', ''/reasoning'', ''/elevated'', ''/model'', ''/queue'' se eliminan antes de que el modelo vea el mensaje.
- Los mensajes solo de directivas preservan la configuración de sesión.
- Las directivas en línea en mensajes normales actúan como sugerencias por mensaje.
- ''Atajos en línea'' (solo remitentes en lista blanca): ciertos tokens ''/...'' en mensajes normales pueden ejecutarse inmediatamente (ej., "hey /status") y se eliminan antes de que el modelo vea el resto del texto.'
''
'Detalles: ''comandos slash''.
Sesiones, compactación y poda (qué persiste)
Lo que persiste entre mensajes depende del mecanismo:
- Historial normal permanece en el registro de sesión hasta ser compactado/podado por política.
- Compactación mantiene un resumen en el registro y mantiene los mensajes recientes intactos.
- ''Poda'' elimina resultados de herramientas antiguos del prompt en memoria para una ejecución pero no reescribe el registro.'
''
'Docs: ''sesiones'', ''compactación'', ''poda de sesión''.
Qué reporta realmente `/context`
''/context'' prefiere el último reporte de prompt del sistema ''construido en ejecución'' (si está disponible):
- ''System prompt (run)'' = capturado de la última ejecución embebida (con soporte de herramientas) y persistido en almacenamiento de sesión.
- ''System prompt (estimate)'' = calculado dinámicamente cuando no existe reporte de ejecución (o cuando se ejecuta via backend CLI que no genera reportes).
De cualquier manera, reporta escala y principales contribuyentes; no vuelca el prompt del sistema completo o esquemas de herramientas.