Higiene de transcripciones (correcciones del proveedor)
Este documento describe correcciones específicas del proveedor aplicadas a las transcripciones antes de una ejecución (construcción del contexto del modelo). Estos son ajustes en memoria usados para satisfacer requisitos estrictos del proveedor. Estos pasos de higiene no reescriben la transcripción JSONL almacenada en disco; sin embargo, un paso separado de reparación del archivo de sesión puede reescribir archivos JSONL malformados eliminando líneas inválidas antes de que se cargue la sesión.
El alcance incluye:
- Sanitización de IDs de llamadas de herramientas
- Validación de entrada de llamadas de herramientas
- Reparación de emparejamiento de resultados de herramientas
- Validación / ordenamiento de turnos
- Limpieza de firmas de pensamiento
- Sanitización de payloads de imágenes
- Etiquetado de procedencia de entrada del usuario (para prompts enrutados entre sesiones)
Regla global: sanitización de imágenes
Los payloads de imágenes siempre se sanitizan para prevenir rechazos del proveedor por límites de tamaño.
Regla global: llamadas de herramientas malformadas
Los bloques de llamadas de herramientas del asistente que carecen tanto de input como de arguments se eliminan antes de construir el contexto del modelo.
Regla global: procedencia de entrada entre sesiones
Cuando un agente envía un prompt a otra sesión vía sessions_send, OpenClaw persiste el turno de usuario creado con message.provenance.kind = "inter_session".
Matriz de proveedores (comportamiento actual)
OpenAI / OpenAI Codex: Solo sanitización de imágenes.
Google (Generative AI / Gemini CLI / Antigravity): Sanitización de IDs de llamadas de herramientas, reparación de emparejamiento de resultados, validación de turnos, corrección de ordenamiento de turnos Google.
Anthropic / Minimax (compatible con Anthropic): Reparación de emparejamiento de resultados y resultados sintéticos, validación de turnos.
Mistral: Sanitización de IDs de llamadas de herramientas: strict9 (alfanumérico longitud 9).
OpenRouter Gemini: Limpieza de firmas de pensamiento: eliminar valores thought_signature que no son base64.
Todo lo demás: Solo sanitización de imágenes.