Mga Timezone¶

Ini-standardize ng OpenClaw ang mga timestamp upang makita ng model ang iisang reference time.

Mga message envelope (local bilang default)¶

Ang mga papasok na mensahe ay binalot sa isang envelope tulad ng:

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

Ang timestamp sa envelope ay host-local bilang default, na may minutong precision.

Maaari mo itong i-override gamit ang:

{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}

• Ang envelopeTimezone: "utc" ay gumagamit ng UTC.
• Ang envelopeTimezone: "user" ay gumagamit ng agents.defaults.userTimezone (bumabalik sa timezone ng host).
• Gumamit ng isang tahasang IANA timezone (hal., "Europe/Vienna") para sa fixed offset.
• Inaalis ng envelopeTimestamp: "off" ang mga absolute timestamp mula sa mga header ng envelope.
• Inaalis ng envelopeElapsed: "off" ang mga suffix ng elapsed time (ang istilong +2m).

Mga halimbawa¶

Lokal (default):

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

Nakatakdang time zone:

[Signal Alice +1555 2026-01-18 06:19 GMT+1] hello

Lumipas na oras:

[Signal Alice +1555 +2m 2026-01-18T05:19Z] follow-up

Mga tool payload (raw provider data + mga normalized na field)¶

Ang mga tool call (channels.discord.readMessages, channels.slack.readMessages, atbp.) ay nagbabalik ng raw na timestamp mula sa provider. We also attach normalized fields for consistency:

• timestampMs (UTC epoch na millisecond)
• timestampUtc (ISO 8601 UTC na string)

Pinananatili ang mga raw provider field.

Timezone ng user para sa system prompt¶

Itakda ang agents.defaults.userTimezone upang ipaalam sa model ang lokal na time zone ng user. Kung ito ay unset, OpenClaw resolves the host timezone at runtime (no config write).

{
  agents: { defaults: { userTimezone: "America/Chicago" } },
}

Kasama sa system prompt ang:

• seksyong Current Date & Time na may lokal na oras at timezone
• Time format: 12-hour o 24-hour

Maaari mong kontrolin ang format ng prompt gamit ang agents.defaults.timeFormat (auto | 12 | 24).

Tingnan ang Date & Time para sa kumpletong pag-uugali at mga halimbawa.