Nesta página
Nesta página
Technical reference
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:
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:
| 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):
Fuso horário do usuário:
Tempo decorrido com envelopeTimezone: "utc":
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:
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).
Configurar fuso horário do usuário e formato
userTimezonedefine o fuso horário local do usuário para o contexto do prompt (e paraenvelopeTimezone: "user").timeFormatcontrola a exibição em 12 ou 24 horas nos horários apresentados no prompt.autosegue 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.
