Contexto

“Contexto” es todo lo que OpenClaw envía al modelo para una ejecución. Está limitado por la ventana de contexto del modelo (límite de tokens).

Modelo mental para principiantes:

Prompt del sistema (construido por OpenClaw): reglas, herramientas, lista de habilidades, hora/tiempo de ejecución y archivos del espacio de trabajo inyectados.
Historial de conversación: tus mensajes + los mensajes del asistente para esta sesión.
Llamadas/Resultados de herramientas + archivos adjuntos: salida de comandos, lecturas de archivos, imágenes/audio, etc.

El contexto no es lo mismo que “memoria”: la memoria se puede almacenar en el disco y volver a cargarse más tarde; el contexto es lo que hay dentro de la ventana actual del modelo.

Inicio rápido (inspeccionar contexto)

/status → vista rápida de “qué tan llena está mi ventana?” + configuración de sesión.
/context list → qué se inyecta + tamaños aproximados (por archivo + totales).
/context detail → desglose más profundo: por archivo, tamaños de esquema por herramienta, tamaños de entrada por habilidad y tamaño del prompt del sistema.
/context map → imagen de treemap estilo WinDirStat de los contribuyentes del contexto rastreados en la sesión actual.
/usage tokens → añade un pie de página de uso por respuesta a las respuestas normales.
/compact → resume el historial anterior en una entrada compacta para liberar espacio en la ventana.

Ver también: Slash commands, Token use & costs, Compaction.

Ejemplo de salida

Los valores varían según el modelo, el proveedor, la política de herramientas y lo que haya en su espacio de trabajo.

`/context list`

🧠 Context breakdown
Workspace: <workspaceDir>
Bootstrap max/file: 12,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

`/context detail`

🧠 Context breakdown (detailed)
…
Top skills (prompt entry size):
- frontend-design: 412 chars (~103 tok)
- oracle: 401 chars (~101 tok)
… (+10 more skills)

Top tools (schema size):
- browser: 9,812 chars (~2,453 tok)
- exec: 6,240 chars (~1,560 tok)
… (+N more tools)

`/context map`

Envía una imagen generada a partir del informe de ejecución en caché más reciente. Antes de que un mensaje normal haya producido un informe de ejecución en la sesión, /context map devuelve un mensaje no disponible en lugar de renderizar una estimación. El área del rectángulo es proporcional a los caracteres del prompt rastreados:

archivos del espacio de trabajo inyectados
texto del prompt del sistema base
entradas de prompt de habilidades
esquemas JSON de herramientas

/context list, /context detail y /context json aún pueden inspeccionar una estimación bajo demanda cuando no hay ningún informe de ejecución en caché.

Qué cuenta hacia la ventana de contexto

Todo lo que recibe el modelo cuenta, incluyendo:

Prompt del sistema (todas las secciones).
Historial de conversación.
Llamadas a herramientas + resultados de herramientas.
Archivos adjuntos/transcripciones (imágenes/audio/archivos).
Resúmenes de compactación y artefactos de poda.
“Wrappers” del proveedor o encabezados ocultos (no visibles, pero contados).

Cómo OpenClaw construye el prompt del sistema

El prompt del sistema es propiedad de OpenClaw y se reconstruye en cada ejecución. Incluye:

Lista de herramientas + descripciones breves.
Lista de habilidades (solo metadatos; ver abajo).
Ubicación del espacio de trabajo.
Hora (UTC + hora de usuario convertida si está configurado).
Metadatos de tiempo de ejecución (host/SO/modelo/pensamiento).
Archivos de arranque del espacio de trabajo inyectados en Project Context.

Desglose completo: System Prompt.

Archivos del espacio de trabajo inyectados (Project Context)

De manera predeterminada, OpenClaw inyecta un conjunto fijo de archivos del espacio de trabajo (si están presentes):

AGENTS.md
SOUL.md
TOOLS.md
IDENTITY.md
USER.md
HEARTBEAT.md
BOOTSTRAP.md (solo en la primera ejecución)

Los archivos grandes se truncan por archivo usando agents.defaults.bootstrapMaxChars (por defecto 12000 caracteres). OpenClaw también impone un límite máximo de inyección de arranque total entre archivos con agents.defaults.bootstrapTotalMaxChars (por defecto 60000 caracteres). /context muestra los tamaños brutos frente a los inyectados y si se produjo un truncamiento.

Cuando se produce una truncación, el tiempo de ejecución puede inyectar un bloque de advertencia en el prompt bajo el Contexto del Proyecto. Configure esto con agents.defaults.bootstrapPromptTruncationWarning (off, once, always; por defecto always).

Habilidades: inyectadas vs cargadas bajo demanda

El mensaje del sistema incluye una lista de habilidades compacta (nombre + descripción + ubicación). Esta lista tiene una sobrecarga real.

Las instrucciones de habilidad no se incluyen de forma predeterminada. Se espera que el modelo read el SKILL.md de la habilidad solo cuando sea necesario.

Herramientas: hay dos costos

Las herramientas afectan el contexto de dos maneras:

Texto de la lista de herramientas en el mensaje del sistema (lo que ves como “Herramientas”).
Esquemas de herramientas (JSON). Estos se envían al modelo para que pueda llamar a las 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.

Comandos, directivas y “atajos en línea”

Los comandos de barra diagonal son manejados por la Puerta de enlace (Gateway). Hay algunos comportamientos diferentes:

Comandos independientes: un mensaje que es solo /... se ejecuta como un comando.
Directivas: /think, /verbose, /trace, /reasoning, /elevated, /model, /queue se eliminan antes de que el modelo vea el mensaje.
- Los mensajes que solo son directivas mantienen la configuración de la sesión.
- Las directivas en línea en un mensaje normal actúan como sugerencias por mensaje.
Accesos directos en línea (solo remitentes permitidos): 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: Slash commands.

Sesiones, compactación y poda (lo que persiste)

Lo que persiste entre mensajes depende del mecanismo:

Historial normal persiste en la transcripción de la sesión hasta que se compacta/poda por política.
Compactación persiste un resumen en la transcripción y mantiene los mensajes recientes intactos.
Poda elimina los resultados de herramientas antiguos del mensaje en memoria para liberar espacio en la ventana de contexto, pero no reescribe la transcripción de la sesión; el historial completo aún se puede inspeccionar en disco.

Documentos: Session, Compaction, Session pruning.

De manera predeterminada, OpenClaw utiliza el motor de contexto legacy integrado para el ensamblaje y la compactación. Si instala un complemento que proporciona kind: "context-engine" y lo selecciona con plugins.slots.contextEngine, OpenClaw delega el ensamblaje del contexto, /compact y los ganchos del ciclo de vida del contexto de subagentes relacionados a ese motor en su lugar. ownsCompaction: false no vuelve automáticamente al motor heredado; el motor activo aún debe implementar compact() correctamente. Consulte Context Engine para obtener la interfaz conectable completa, los ganchos del ciclo de vida y la configuración.

Lo que `/context` realmente informa

/context prefiere el informe más reciente del mensaje del sistema construido en la ejecución cuando está disponible:

System prompt (run) = capturado de la última ejecución integrada (con capacidad de herramientas) y persistido en el almacén de sesiones.
System prompt (estimate) = calculado al vuelo cuando no existe un informe de ejecución (o al ejecutarse a través de un backend de CLI que no genera el informe).

De cualquier manera, informa los tamaños y los principales contribuyentes; no vuelca el mensaje del sistema completo ni los esquemas de herramientas.

Relacionado

Motor de contexto

Inyección de contexto personalizado mediante complementos.

Compactación

Resumiendo conversaciones largas para mantenerlas dentro de la ventana del modelo.

Prompt del sistema

Cómo se construye el prompt del sistema y qué inyecta en cada turno.

Bucle del agente

El ciclo completo de ejecución del agente desde el mensaje entrante hasta la respuesta final.