zona horaria
Manejo de zona horaria para agentes, sobres y prompts
OpenClaw normaliza timestamps para que el modelo vea una **única hora de referencia**.
Sobres de mensajes (local por defecto)
Los mensajes entrantes se envuelven en un sobre como:
[Provider ... 2026-01-05 16:26 PST] message text
El timestamp en el sobre es **local del host por defecto**, con precisión de minutos.
Puedes sobrescribir esto con:
{
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'' (retrocede a zona horaria del host).
- Usa una zona horaria IANA explícita (ej., `"Europe/Vienna"`) como offset fijo.
- ''envelopeTimestamp: "off"'' remueve timestamps absolutos de los headers del sobre.
- ''envelopeElapsed: "off"'' remueve sufijos de tiempo transcurrido (el estilo ''+2m'').
#
Payloads de herramientas (datos de proveedor crudos + campos normalizados)
Las llamadas de herramientas (''channels.discord.readMessages'', ''channels.slack.readMessages'', etc.) retornan **timestamps crudos del proveedor**.
[Signal Alice +1555 2026-01-18 00:19 PST] hello
También adjuntamos campos normalizados para consistencia:
[Signal Alice +1555 2026-01-18 06:19 GMT+1] hello
- ''timestampMs'' (epoch UTC en milisegundos)
[Signal Alice +1555 +2m 2026-01-18T05:19Z] follow-up
Zona horaria del usuario para el prompt del sistema
Establece ''agents.defaults.userTimezone'' para indicar al modelo la zona horaria local del usuario. Si no está
establecido, OpenClaw resuelve la **zona horaria del host en tiempo de ejecución** (sin escritura de config).
El prompt del sistema incluye:
- Sección ''Fecha y Hora Actual'' con hora local y zona horaria
- ''Formato de hora: 12 horas'' o ''24 horas''
Ejemplos
**Local (predeterminado):**
**Zona horaria fija:**
{
agents: { defaults: { userTimezone: "America/Chicago" } },
}**Tiempo transcurrido:**
- Sección ''Fecha y Hora Actual'' con hora local y zona horaria
- ''Formato de hora: 12 horas'' o ''24 horas''
Puedes controlar el formato del prompt con ''agents.defaults.timeFormat'' (''auto'' | ''12'' | ''24'').
Ver [Fecha y Hora](/date-time) para el comportamiento completo y ejemplos.