Pular para o conteúdo principal
O OpenClaw usa por padrão horário local do host para timestamps de transporte e fuso horário do usuário somente no prompt do sistema. Os timestamps do provedor são preservados para que as ferramentas mantenham sua semântica nativa (a hora atual está disponível via session_status).

​
Envelopes de mensagem (local por padrão)

Mensagens recebidas são encapsuladas com um timestamp (precisão de segundos): 
[Provider ... Mon 2026-01-05 16:26:34 PST] message text
Esse timestamp do envelope é local do host por padrão, independentemente do fuso horário do provedor. Você pode substituir esse comportamento: 
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" usa UTC.
  • envelopeTimezone: "local" usa o fuso horário do host.
  • envelopeTimezone: "user" usa agents.defaults.userTimezone (recorre ao fuso horário do host).
  • Use um fuso horário IANA explícito (por exemplo, "America/Chicago") para uma zona fixa.
  • envelopeTimestamp: "off" remove timestamps absolutos dos cabeçalhos de envelope, dos prefixos diretos de prompt do agente e dos prefixos incorporados de entrada do modelo.
  • envelopeElapsed: "off" remove sufixos de tempo decorrido (o estilo +2m).

​
Exemplos

Local (padrão): 
[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] hello
Fuso horário do usuário: 
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] hello
Tempo decorrido ativado: 
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] follow-up

​
Prompt do sistema: data e hora atuais

Se o fuso horário do usuário for conhecido, o prompt do sistema incluirá uma seção dedicada Data e hora atuais com somente o fuso horário (sem formato de relógio/hora) para manter o cache de prompt estável: 
Time zone: America/Chicago
Quando o agente precisar da hora atual, use a ferramenta session_status; o cartão de status inclui uma linha de timestamp.

​
Linhas de evento do sistema (local por padrão)

Eventos do sistema enfileirados inseridos no contexto do agente recebem um prefixo com timestamp usando a mesma seleção de fuso horário dos envelopes de mensagem (padrão: local do host). 
System: [2026-01-12 12:19:17 PST] Model switched.

​
Configurar fuso horário do usuário + formato

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone define o fuso horário local do usuário para o contexto do prompt.
  • timeFormat controla a exibição em 12h/24h no prompt. auto segue as preferências do SO.

​
Detecção de formato de hora (auto)

Quando timeFormat: "auto", o OpenClaw inspeciona a preferência do SO (macOS/Windows) e recorre à formatação de localidade. O valor detectado fica em cache por processo para evitar chamadas repetidas ao sistema.

​
Payloads de ferramentas + conectores (hora bruta do provedor + campos normalizados)

Ferramentas de canal retornam timestamps nativos do provedor e adicionam campos normalizados para consistência:
  • timestampMs: milissegundos desde a época Unix (UTC)
  • timestampUtc: string UTC ISO 8601
Campos brutos do provedor são preservados para que nada seja perdido.
  • Slack: strings semelhantes a época Unix da API
  • Discord: timestamps ISO UTC
  • Telegram/WhatsApp: timestamps numéricos/ISO específicos do provedor
Se precisar do horário local, converta-o downstream usando o fuso horário conhecido.

​
Documentação relacionada