Skip to main content
O OpenClaw padroniza os carimbos de data/hora para que o modelo veja um único horário de referência, em vez de uma combinação de relógios locais dos provedores. Três superfícies exibem fusos horários, cada uma com sua própria finalidade:

​
Três superfícies de fuso horário

O prompt do sistema omite deliberadamente o relógio em tempo real para manter o cache de prompts estável entre os turnos. Quando o agente precisa do horário atual, ele chama session_status.

​
Configuração do fuso horário do usuário

Se userTimezone não estiver definido, o OpenClaw resolve o fuso horário do host em tempo de execução por meio de Intl.DateTimeFormat().resolvedOptions().timeZone (sem gravar na configuração). agents.defaults.timeFormat (auto | 12 | 24) controla a renderização em formato de 12/24 horas nos envelopes e nas superfícies subsequentes, mas não na seção do prompt do sistema.

​
Valores de fuso horário do envelope

agents.defaults.envelopeTimezone aceita:
  • "local" (padrão) ou "host" — fuso horário da máquina host.
  • "utc" ou "gmt" — UTC.
  • "user" — o agents.defaults.userTimezone resolvido (usa o fuso horário do host como alternativa se não estiver definido).
  • Qualquer identificador explícito de fuso horário da IANA, por exemplo, "Europe/Vienna".

​
Quando substituir

  • Use "utc" para obter carimbos de data/hora consistentes entre hosts em regiões diferentes ou para corresponder à saída de diagnósticos e logs alinhada ao UTC.
  • Use "user" para manter os envelopes alinhados ao fuso horário configurado para o usuário, independentemente do fuso em que o host do Gateway esteja sendo executado.
  • Use um fuso horário fixo da IANA quando o host do Gateway estiver em um fuso, mas o envelope sempre precisar exibir outro, independentemente da migração do host.
  • Defina envelopeTimestamp: "off" quando o contexto de data e hora não for útil para a conversa. Isso remove os carimbos absolutos dos envelopes, dos prefixos de prompt enviados diretamente ao agente e dos prefixos incorporados à entrada do modelo.
Para consultar a referência completa de comportamento, exemplos por provedor e a formatação do tempo decorrido, consulte Data e hora.

​
Relacionados

  • Data e hora — comportamento completo e exemplos de envelopes, ferramentas e prompts.
  • Heartbeat — os horários de atividade usam o fuso horário para o agendamento.
  • Tarefas Cron — as expressões cron usam o fuso horário para o agendamento.