Indicadores de escritura

Los indicadores de escritura se envían al canal de chat mientras una ejecución está activa. Usa agents.defaults.typingMode para controlar cuándo comienza la escritura y typingIntervalSeconds para controlar con qué frecuencia se refresca.

Valores por defecto

Cuando agents.defaults.typingMode no está configurado, OpenClaw mantiene el comportamiento legacy:

  • Chats directos: la escritura comienza inmediatamente cuando inicia el bucle del modelo.
  • Chats grupales con mención: la escritura comienza inmediatamente.
  • Chats grupales sin mención: la escritura comienza solo cuando el texto del mensaje empieza a llegar por streaming.
  • Ejecuciones de heartbeat: la escritura está deshabilitada.

Modos

Configura agents.defaults.typingMode a uno de:

  • never — sin indicador de escritura, nunca.
  • instant — comenzar a escribir tan pronto como inicia el bucle del modelo, incluso si la ejecución luego devuelve solo el token de respuesta silenciosa.
  • thinking — comenzar a escribir en el primer delta de razonamiento (requiere reasoningLevel: "stream" para la ejecución).
  • message — comenzar a escribir en el primer delta de texto no silencioso (ignora el token silencioso NO_REPLY).

Orden de “qué tan temprano se dispara”: nevermessagethinkinginstant

Configuración

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

Puedes sobreescribir el modo o la cadencia por sesión:

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

Notas

  • El modo message no mostrará escritura para respuestas solo silenciosas (por ejemplo, el token NO_REPLY usado para suprimir la salida).
  • thinking solo se dispara si la ejecución transmite razonamiento (reasoningLevel: "stream"). Si el modelo no emite deltas de razonamiento, la escritura no comenzará.
  • Los heartbeats nunca muestran escritura, sin importar el modo.
  • typingIntervalSeconds controla la cadencia de refresco, no el momento de inicio. El valor por defecto es 6 segundos.