Pular para o conteúdo principal

​
Indicadores de digitação

Indicadores de digitação são enviados ao canal de chat enquanto uma execução está ativa. Use agents.defaults.typingMode para controlar quando a digitação começa e typingIntervalSeconds para controlar com que frequência ela é atualizada.

​
Padrões

Quando agents.defaults.typingMode está não definido, o OpenClaw mantém o comportamento legado:
  • Chats diretos: a digitação começa imediatamente assim que o loop do modelo é iniciado.
  • Chats em grupo com uma menção: a digitação começa imediatamente.
  • Chats em grupo sem uma menção: a digitação começa somente quando o texto da mensagem começa a ser transmitido.
  • Execuções de heartbeat: a digitação é desativada.

​
Modos

Defina agents.defaults.typingMode como um dos seguintes:
  • never — nenhum indicador de digitação, nunca.
  • instant — começa a digitar assim que o loop do modelo é iniciado, mesmo que a execução depois retorne apenas o token de resposta silenciosa.
  • thinking — começa a digitar no primeiro delta de reasoning (exige reasoningLevel: "stream" para a execução).
  • message — começa a digitar no primeiro delta de texto não silencioso (ignora o token silencioso NO_REPLY).
Ordem de “quão cedo ele dispara”: never → message → thinking → instant

​
Configuração

{
  agent: {
    typingMode: "thinking",
    typingIntervalSeconds: 6,
  },
}
Você pode substituir o modo ou a cadência por sessão: 
{
  session: {
    typingMode: "message",
    typingIntervalSeconds: 4,
  },
}

​
Observações

  • O modo message não mostrará digitação para respostas apenas silenciosas quando todo o payload for exatamente o token silencioso (por exemplo NO_REPLY / no_reply, com correspondência sem diferenciar maiúsculas de minúsculas).
  • thinking só dispara se a execução transmitir reasoning (reasoningLevel: "stream"). Se o modelo não emitir deltas de reasoning, a digitação não começará.
  • Heartbeats nunca mostram digitação, independentemente do modo.
  • typingIntervalSeconds controla a cadência de atualização, não o momento de início. O padrão é 6 segundos.