Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

O OpenClaw padroniza timestamps para que o modelo veja um único horário de referência em vez de uma mistura de relógios locais de provedores. Há três superfícies onde fusos horários aparecem, cada uma com sua própria finalidade:

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

SuperfícieO que ela mostraPadrãoConfigurado via
Envelopes de mensagemEncapsula mensagens de canal recebidas: [Signal +1555 2026-01-18 00:19 PST] helloLocal do hostagents.defaults.envelopeTimezone
Payloads de ferramentasFerramentas de canal no estilo readMessages retornam o horário bruto do provedor + timestampMs / timestampUtc normalizadosCampos UTC sempre presentesNão configurável — preserva timestamps nativos do provedor
Prompt do sistemaUm pequeno bloco Current Date & Time com apenas o fuso horário (sem valor de relógio, para estabilidade do cache)Fuso horário do host se userTimezone não estiver definidoagents.defaults.userTimezone
O prompt do sistema omite deliberadamente o relógio em tempo real para manter o cache de prompts estável entre turnos. Quando o agente precisa do horário atual, ele chama session_status.

​
Definindo o fuso horário do usuário

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
Se userTimezone não estiver definido, o OpenClaw resolve o fuso horário do host em tempo de execução (sem gravar configuração). agents.defaults.timeFormat (auto | 12 | 24) controla a renderização em 12h/24h nos envelopes e em superfícies downstream, não na seção do prompt do sistema.

​
Quando substituir

  • Use envelopes em UTC (envelopeTimezone: "utc") quando quiser timestamps estáveis entre hosts em regiões diferentes, ou quando quiser que logs alinhados a UTC correspondam à saída de diagnóstico.
  • Use uma zona IANA fixa (por exemplo, "Europe/Vienna") quando o host do Gateway estiver em uma zona, mas o usuário estiver em outra, e você quiser que os envelopes sejam lidos na zona do usuário independentemente da migração do host.
  • Defina envelopeTimestamp: "off" para envelopes com poucos tokens quando o contexto de timestamp não for útil para a conversa.
Para a referência completa de comportamento, exemplos por provedor e formatação de tempo decorrido, consulte Data e Hora.

​
Relacionados

  • Data e Hora — comportamento e exemplos completos de envelope/ferramenta/prompt.
  • Heartbeat — horários ativos usam fuso horário para agendamento.
  • Trabalhos Cron — expressões cron usam fuso horário para agendamento.