Saltar para o conteúdo principal

​
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: 
[Provider ... 2026-01-05 16:26 PST] message text
O timestamp no envelope é local ao host por padrão, com precisão de minutos. Você pode substituir isso com: 
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • 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): 
[Signal Alice +1555 2026-01-18 00:19 PST] hello
Fuso horário fixo: 
[Signal Alice +1555 2026-01-18 06:19 GMT+1] hello
Tempo decorrido: 
[Signal Alice +1555 +2m 2026-01-18T05:19Z] follow-up

​
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). 
{
  agents: { defaults: { userTimezone: "America/Chicago" } },
}
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.