Data e hora

OpenClaw usa por padrão horário local do host para carimbos de data/hora de transporte e fuso horário do usuário apenas no prompt do sistema. Os carimbos de data/hora do provedor são preservados para que as ferramentas mantenham sua semântica nativa (o horário atual está disponível via session_status).

# Envelopes de mensagens (local por padrão)

Mensagens recebidas são envolvidas com um carimbo de data/hora (precisão de minuto):

[Provider ... 2026-01-05 16:26 PST] message text

Esse carimbo de data/hora 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 carimbos de data/hora absolutos dos cabeçalhos de envelope.
• envelopeElapsed: "off" remove sufixos de tempo decorrido (o estilo +2m).

# Exemplos

Local (padrão):

[WhatsApp +1555 2026-01-18 00:19 PST] hello

Fuso horário do usuário:

[WhatsApp +1555 2026-01-18 00:19 CST] hello

Tempo decorrido habilitado:

[WhatsApp +1555 +30s 2026-01-18T05:19Z] 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 do horário atual, use a ferramenta session_status; o cartão de status inclui uma linha de carimbo de data/hora.

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

Eventos do sistema enfileirados inseridos no contexto do agente recebem um prefixo com um carimbo de data/hora usando a mesma seleção de fuso horário dos envelopes de mensagens (padrão: local do host).

System: [2026-01-12 12:19:17 PST] Model switched.

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

{
  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 (automática)

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

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

Ferramentas de canal retornam carimbos de data/hora 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 à época Unix da API
• Discord: carimbos de data/hora ISO em UTC
• Telegram/WhatsApp: carimbos de data/hora numéricos/ISO específicos do provedor

Se precisar do horário local, converta-o downstream usando o fuso horário conhecido.

# Documentos relacionados

• Prompt do sistema
• Fusos horários
• Mensagens