Pular para o conteúdo principal
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 não está definido, o OpenClaw mantém o comportamento legado:
  • Chats diretos: a digitação começa imediatamente assim que o loop do modelo começa.
  • 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 quando a execução admitida tem atividade visível para o usuário, como atividade de execução do ambiente ou texto de mensagem.
  • Execuções de Heartbeat: a digitação começa quando a execução de Heartbeat começa se o destino de Heartbeat resolvido for um chat compatível com digitação e a digitação não estiver desativada.

Modos

Defina agents.defaults.typingMode como um destes:
  • never - nenhum indicador de digitação, nunca.
  • instant - começa a digitar assim que o loop do modelo começa, mesmo que a execução depois retorne apenas o token de resposta silenciosa.
  • thinking - começa a digitar no primeiro delta de raciocínio ou na execução ativa do ambiente depois que o turno é aceito.
  • message - começa a digitar na primeira atividade de resposta visível para o usuário, como execução ativa do ambiente ou um delta de texto não silencioso. Tokens de resposta silenciosa como NO_REPLY não contam como atividade de texto.
Ordem de “quão cedo é acionado”: nevermessage/thinkinginstant

Configuração

Defina o padrão no nível do agente:
{
  agents: {
    defaults: {
      typingMode: "thinking",
      typingIntervalSeconds: 6,
    },
  },
}
Substitua o modo ou a cadência por sessão:
{
  session: {
    typingMode: "message",
    typingIntervalSeconds: 4,
  },
}

Observações

  • O modo message não começa a partir de tokens de resposta silenciosa, mas a execução ativa ainda pode mostrar digitação antes que qualquer texto do assistente esteja disponível.
  • thinking ainda reage ao raciocínio transmitido em streaming (reasoningLevel: "stream"), e também pode começar a partir da execução ativa antes que os deltas de raciocínio cheguem.
  • A digitação de Heartbeat é um sinal de vivacidade para o destino de entrega resolvido. Ela começa no início da execução de Heartbeat em vez de seguir o tempo do fluxo de message ou thinking. Defina typingMode: "never" para desativá-la.
  • Heartbeats não mostram digitação quando target: "none", quando o destino não pode ser resolvido, quando a entrega de chat está desativada para o Heartbeat ou quando o canal não oferece suporte a digitação.
  • typingIntervalSeconds controla a cadência de atualização, não o horário de início. O padrão é 6 segundos.

Relacionados

Presença

Como o Gateway rastreia clientes conectados e os expõe na aba Instâncias do macOS.

Streaming e fragmentação

Comportamento de streaming de saída, limites de fragmentos e entrega específica por canal.