Configuración de indicadores de escritura en OpenClaw

Seguro te ha pasado: envías un mensaje a un bot y te quedas mirando una pantalla estática sin saber si está procesando tu solicitud o si la conexión se cayó. Esa incertidumbre es frustrante y hace que la herramienta se sienta lenta o rota.

Para que la comunicación sea fluida, es vital que el usuario reciba feedback visual inmediato. Configurar correctamente los indicadores de escritura permite que tus agentes se sientan más humanos y que el usuario sepa exactamente qué está pasando detrás de escena.

Requisitos previos

• Acceso a la configuración de agents en tu proyecto.
• Configuración de reasoningLevel: "stream" si planeas usar el modo de razonamiento.

Inicio rápido

Para activar los indicadores de escritura, debes usar agents.defaults.typingMode. Este parámetro define el disparador inicial, mientras que typingIntervalSeconds controla la frecuencia de actualización.

Si no configuras nada, OpenClaw mantiene el comportamiento legacy: en chats directos o menciones en grupos empieza de inmediato, pero en grupos sin mención solo inicia cuando el texto comienza a transmitirse.

Aquí tienes la configuración recomendada para un balance óptimo:

{
  agent: {
    typingMode: "thinking",
    typingIntervalSeconds: 6,
  },
}

También puedes ajustar estos valores por sesión si necesitas un comportamiento distinto en casos específicos:

{
  session: {
    typingMode: "message",
    typingIntervalSeconds: 4,
  },
}

Modos disponibles

Puedes elegir entre cuatro estados según la rapidez con la que quieras que aparezca el indicador:

1. never: Desactiva el indicador por completo.
2. message: Empieza con el primer fragmento de texto real (ignora tokens silenciosos como NO_REPLY).
3. thinking: Empieza con el primer delta de razonamiento (útil para modelos que explican su proceso).
4. instant: Se activa en cuanto inicia el loop del modelo.

Solución de problemas

• El indicador no aparece en modo thinking: Verifica que el run tenga activado reasoningLevel: "stream". Si el modelo no emite deltas de razonamiento, el indicador nunca se disparará.
• No hay indicadores en Heartbeat runs: Los heartbeats tienen los indicadores desactivados por diseño, sin importar el modo que elijas.
• El modo message no muestra nada: Si la respuesta es puramente silenciosa (por ejemplo, usa el token NO_REPLY), este modo no activará el indicador.
• El indicador desaparece muy rápido: Recuerda que typingIntervalSeconds solo controla la cadencia de refresco (por defecto 6 segundos), no el momento en que inicia.

Si necesitas ayuda para integrar esto en tu flujo de trabajo, pregunta al AI Setup Assistant.

Próximos pasos

• Configuración de sesiones
• Control de flujos de streaming