Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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