Skip to main content

​
Fusos horários

O OpenClaw padroniza timestamps para que o modelo veja uma única referência de tempo.

​
Envelopes de mensagem (local por padrão)

Mensagens de entrada são encapsuladas em um envelope como:
O timestamp no envelope é local ao host por padrão, com precisão de minutos. Você pode substituir isso com:
  • envelopeTimezone: "utc" usa UTC.
  • envelopeTimezone: "user" usa agents.defaults.userTimezone (retorna ao fuso horário do host).
  • Use um fuso horário IANA explícito (por exemplo, "Europe/Vienna") para um deslocamento fixo.
  • envelopeTimestamp: "off" remove timestamps absolutos dos cabeçalhos do envelope.
  • envelopeElapsed: "off" remove sufixos de tempo decorrido (o estilo +2m).

​
Exemplos

Local (padrão):
Fuso horário fixo:
Tempo decorrido:

​
Payloads de ferramentas (dados brutos do provedor + campos normalizados)

Chamadas de ferramentas (channels.discord.readMessages, channels.slack.readMessages, etc.) retornam timestamps brutos do provedor. Também anexamos campos normalizados para consistência:
  • timestampMs (milissegundos de época UTC)
  • timestampUtc (string ISO 8601 UTC)
Os campos brutos do provedor são preservados.

​
Fuso horário do usuário para o prompt do sistema

Defina agents.defaults.userTimezone para informar ao modelo o fuso horário local do usuário. Se estiver não definido, o OpenClaw resolve o fuso horário do host em tempo de execução (sem gravar configuração).
O prompt do sistema inclui:
  • seção Current Date & Time com hora local e fuso horário
  • Time format: 12-hour ou 24-hour
Você pode controlar o formato do prompt com agents.defaults.timeFormat (auto | 12 | 24). Veja Date & Time para o comportamento completo e exemplos.