Entendiendo el Context en OpenClaw

¿Alguna vez has sentido que tu IA empieza a olvidar lo que discutieron hace diez minutos o que se confunde con los archivos de tu proyecto? Es frustrante cuando el modelo pierde el hilo porque su ventana de memoria inmediata se llena de información irrelevante.

Gestionar qué información recibe el modelo es clave para que las respuestas sigan siendo precisas. En OpenClaw, esto se llama Context. No es lo mismo que la memoria guardada en disco; el Context es específicamente todo lo que OpenClaw envía al modelo en una ejecución, limitado por su ventana de tokens.

Requisitos previos

• Una sesión activa en OpenClaw.
• Archivos en tu workspace (como AGENTS.md o USER.md).
• Acceso al Gateway para ejecutar comandos.

Inicio rápido

Puedes inspeccionar y gestionar tu Context en menos de 5 minutos usando estos comandos:

1. Usa /status para ver qué tan llena está tu ventana y revisar la configuración de la sesión.
2. Ejecuta /context list para ver qué archivos se han inyectado y su tamaño aproximado.
3. Prueba /context detail si necesitas un desglose profundo de los esquemas de herramientas y habilidades.
4. Activa /usage tokens para ver cuántos tokens consumes en cada respuesta.

Si te quedas sin espacio en la ventana, usa /compact para resumir el historial antiguo y liberar espacio.

¿Cómo se construye el Context?

OpenClaw reconstruye el System prompt en cada ejecución. Este incluye:

• Lista de herramientas y descripciones cortas.
• Metadata de habilidades (Skills).
• Ubicación del workspace y tiempo actual (UTC).
• Metadata del runtime (OS, modelo, host).
• Archivos del workspace inyectados.

Además del System prompt, el Context incluye el historial de la conversación, las llamadas a herramientas (Tool calls) con sus resultados y cualquier archivo o imagen adjunta.

Ejemplo de /context list

Así es como se ve el desglose de lo que el modelo está procesando:

🧠 Context breakdown
Workspace: <workspaceDir>
Bootstrap max/file: 20,000 chars
Sandbox: mode=non-main sandboxed=false
System prompt (run): 38,412 chars (~9,603 tok) (Project Context 23,901 chars (~5,976 tok))

Injected workspace files:
- AGENTS.md: OK | raw 1,742 chars (~436 tok) | injected 1,742 chars (~436 tok)
- SOUL.md: OK | raw 912 chars (~228 tok) | injected 912 chars (~228 tok)
- TOOLS.md: TRUNCATED | raw 54,210 chars (~13,553 tok) | injected 20,962 chars (~5,241 tok)
- IDENTITY.md: OK | raw 211 chars (~53 tok) | injected 211 chars (~53 tok)
- USER.md: OK | raw 388 chars (~97 tok) | injected 388 chars (~97 tok)
- HEARTBEAT.md: MISSING | raw 0 | injected 0
- BOOTSTRAP.md: OK | raw 0 chars (~0 tok) | injected 0 chars (~0 tok)

Skills list (system prompt text): 2,184 chars (~546 tok) (12 skills)
Tools: read, edit, write, exec, process, browser, message, sessions_send, …
Tool list (system prompt text): 1,032 chars (~258 tok)
Tool schemas (JSON): 31,988 chars (~7,997 tok) (counts toward context; not shown as text)
Tools: (same as above)

Session tokens (cached): 14,250 total / ctx=32,000

Archivos del Workspace (Project Context)

Por defecto, OpenClaw inyecta automáticamente estos archivos si existen en tu carpeta:

• AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md y BOOTSTRAP.md.

Ten en cuenta que los archivos grandes se cortan según el límite agents.defaults.bootstrapMaxChars (20,000 caracteres por defecto). Si ves el estado TRUNCATED en el reporte, significa que el archivo era demasiado grande para entrar completo.

Costos de Tools y Skills

Las herramientas (Tools) afectan el Context de dos formas. Primero, como texto descriptivo en el System prompt. Segundo, como Tool schemas (JSON), que son necesarios para que el modelo sepa cómo llamarlas. Aunque no los veas como texto plano, consumen tokens.

En cuanto a las Skills, el System prompt solo incluye una lista compacta con nombre y descripción. Las instrucciones detalladas de la habilidad no se envían por defecto; el modelo debe usar la herramienta read para cargar el archivo SKILL.md solo cuando sea necesario.

Solución de problemas

• El archivo aparece como MISSING: Verifica que el nombre del archivo en tu workspace coincida exactamente con los nombres permitidos (ej. USER.md).
• El Context está casi lleno: Usa el comando /compact para reducir el historial o revisa /context detail para identificar qué herramienta tiene el esquema JSON más pesado.

¿Necesitas ayuda para configurar tu entorno? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Slash commands
• Token use & costs
• Compaction
• System Prompt