> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Fusos horários

OpenClaw padroniza carimbos de data e hora para que o modelo veja um **único horário de referência** em vez de uma mistura de relógios locais de provedores. Há três superfícies onde os fusos horários aparecem, cada uma com sua própria finalidade:

## Três superfícies de fuso horário

| Superfície             | O que mostra                                                                                                                | Padrão                                                      | Configurado via                                                         |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ----------------------------------------------------------------------- |
| Envelopes de mensagens | Envolve mensagens de canais recebidas: `[Signal +1555 Sun 2026-01-18 00:19:42 PST] hello`                                   | Local do host                                               | `agents.defaults.envelopeTimezone`                                      |
| Cargas de ferramentas  | Ferramentas no estilo `readMessages` do canal retornam hora bruta do provedor + `timestampMs` / `timestampUtc` normalizados | Campos UTC sempre presentes                                 | Não configurável — preserva carimbos de data e hora nativos do provedor |
| Prompt do sistema      | Um pequeno bloco `Current Date & Time` com **apenas o fuso horário** (sem valor de relógio, para estabilidade do cache)     | Fuso horário do host se `userTimezone` não estiver definido | `agents.defaults.userTimezone`                                          |

O prompt do sistema omite deliberadamente o relógio ao vivo para manter o cache de prompt estável entre turnos. Quando o agente precisa do horário atual, ele chama `session_status`.

## Definindo o fuso horário do usuário

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
```

Se `userTimezone` não estiver definido, o OpenClaw resolve o fuso horário do host em tempo de execução (sem gravação de configuração). `agents.defaults.timeFormat` (`auto` | `12` | `24`) controla a renderização em 12h/24h em envelopes e superfícies downstream, não na seção do prompt do sistema.

## Quando substituir

* **Use envelopes em UTC** (`envelopeTimezone: "utc"`) quando quiser carimbos de data e hora estáveis entre hosts em regiões diferentes, ou quando quiser logs alinhados a UTC para corresponder à saída de diagnósticos.
* **Use uma zona IANA fixa** (por exemplo, `"Europe/Vienna"`) quando o host do gateway estiver em uma zona, mas o usuário estiver em outra, e você quiser que os envelopes sejam lidos na zona do usuário independentemente da migração do host.
* **Defina `envelopeTimestamp: "off"`** quando o contexto de carimbo de data e hora não for útil para a conversa. Isso remove carimbos de data e hora absolutos de envelopes, prefixos diretos de prompt do agente e prefixos incorporados de entrada do modelo.

Para a referência completa de comportamento, exemplos por provedor e formatação de tempo decorrido, consulte [Data e Hora](/pt-BR/date-time).

## Relacionado

* [Data e Hora](/pt-BR/date-time) — comportamento completo de envelopes/ferramentas/prompts e exemplos.
* [Heartbeat](/pt-BR/gateway/heartbeat) — horários ativos usam fuso horário para agendamento.
* [Tarefas Cron](/pt-BR/automation/cron-jobs) — expressões cron usam fuso horário para agendamento.