Data e hora

OpenClaw usa a hora local do host nos carimbos de data e hora do transporte e inclui somente o fuso horário no prompt do sistema. Os carimbos de data e hora do provedor são preservados para que as ferramentas mantenham sua semântica nativa. Quando o agente precisa saber a hora atual, ele executa a ferramenta session_status.

Envelopes de mensagens (locais por padrão)

As mensagens recebidas são envolvidas com o dia da semana e um carimbo de data e hora com precisão de segundos:

[WhatsApp +1555 seg. 2026-01-05 16:26:34 PST] texto da mensagem

Por padrão, o carimbo de data e hora do envelope usa a hora local do host, independentemente do fuso horário do provedor. Substitua essa configuração em agents.defaults:

{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | fuso horário IANA
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}

Chave	Valores	Comportamento
`envelopeTimezone`	`local` (padrão), `utc`, `user`, nome IANA explícito	`user` usa `agents.defaults.userTimezone` (o fuso horário do host quando não definido). Um nome IANA explícito (por exemplo, `"America/Chicago"`) fixa um fuso; nomes não reconhecidos usam UTC como alternativa.
`envelopeTimestamp`	`on` (padrão), `off`	`off` remove os carimbos de data e hora absolutos dos cabeçalhos de envelope, dos prefixos diretos do prompt do agente e dos prefixos incorporados à entrada do modelo.
`envelopeElapsed`	`on` (padrão), `off`	`off` remove o sufixo de tempo decorrido (no formato `+30s` / `+2m`) exibido desde a mensagem anterior na sessão.

Exemplos

Local (padrão):

[WhatsApp +1555 dom. 2026-01-18 00:19:42 PST] olá

Fuso horário do usuário:

[WhatsApp +1555 dom. 2026-01-18 00:19:42 CST] olá

Tempo decorrido com envelopeTimezone: "utc":

[WhatsApp +1555 +30s dom. 2026-01-18T05:19:00Z] acompanhamento

Prompt do sistema: data e hora atuais

O prompt do sistema inclui uma seção Data e hora atuais somente com o fuso horário (sem relógio nem formato de hora), para que o cache do prompt permaneça estável:

Fuso horário: America/Chicago

O fuso é definido por agents.defaults.userTimezone quando configurado; caso contrário, é usado o fuso horário do host. O prompt também instrui o agente a executar a ferramenta session_status sempre que precisar da data atual, da hora atual ou do dia da semana.

Linhas de eventos do sistema (locais por padrão)

Eventos do sistema enfileirados e inseridos no contexto do agente recebem como prefixo um carimbo de data e hora que usa a mesma seleção de envelopeTimezone dos envelopes de mensagens (padrão: hora local do host).

Sistema: [2026-01-12 12:19:17 PST] Modelo alterado.

Configurar fuso horário do usuário e 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 (e para envelopeTimezone: "user").
timeFormat controla a exibição em 12 ou 24 horas nos horários apresentados no prompt. auto segue as preferências do sistema operacional.

Detecção do formato de hora (automática)

Quando timeFormat: "auto", o OpenClaw verifica a preferência do sistema operacional (macOS e Windows) e, se necessário, usa a formatação da localidade como alternativa. O valor detectado é armazenado em cache por processo para evitar chamadas repetidas ao sistema.

Cargas úteis de ferramentas e conectores (hora bruta do provedor e campos normalizados)

As ferramentas de canal retornam carimbos de data e hora nativos do provedor e adicionam campos normalizados para manter a consistência:

timestampMs: milissegundos desde a época (UTC)
timestampUtc: string UTC no formato ISO 8601

Os campos brutos do provedor são preservados para que nada seja perdido.

Discord: carimbos de data e hora ISO em UTC
Slack: strings semelhantes a valores de época fornecidas pela API
Telegram/WhatsApp: carimbos de data e hora numéricos ou ISO específicos do provedor

Se precisar da hora local, converta-a posteriormente usando o fuso horário conhecido.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Envelopes de mensagens (locais por padrão)

Exemplos

Prompt do sistema: data e hora atuais

Linhas de eventos do sistema (locais por padrão)

Configurar fuso horário do usuário e formato

Detecção do formato de hora (automática)

Cargas úteis de ferramentas e conectores (hora bruta do provedor e campos normalizados)

Documentação relacionada

​Envelopes de mensagens (locais por padrão)

​Exemplos

​Prompt do sistema: data e hora atuais

​Linhas de eventos do sistema (locais por padrão)

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

​Detecção do formato de hora (automática)

​Cargas úteis de ferramentas e conectores (hora bruta do provedor e campos normalizados)

​Documentação relacionada

Envelopes de mensagens (locais por padrão)

Exemplos

Prompt do sistema: data e hora atuais

Linhas de eventos do sistema (locais por padrão)

Configurar fuso horário do usuário e formato

Detecção do formato de hora (automática)

Cargas úteis de ferramentas e conectores (hora bruta do provedor e campos normalizados)

Documentação relacionada