Timezone

OpenClaw chuẩn hóa timestamp để model thấy một mốc thời gian tham chiếu duy nhất.

Message envelope (mặc định dùng local)

Các message đến sẽ được bọc trong một envelope như sau:

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

Timestamp trong envelope mặc định dùng múi giờ local của host, với độ chính xác đến phút.

Các bạn có thể thay đổi bằng cách config:

{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" sẽ dùng UTC.
  • envelopeTimezone: "user" sẽ dùng agents.defaults.userTimezone (nếu không có thì fallback về timezone của host).
  • Dùng IANA timezone cụ thể (ví dụ "Europe/Vienna") để fix múi giờ.
  • envelopeTimestamp: "off" sẽ bỏ timestamp tuyệt đối khỏi envelope header.
  • envelopeElapsed: "off" sẽ bỏ thời gian đã trôi qua (kiểu +2m).

Ví dụ

Local (mặc định):

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

Fixed timezone:

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

Elapsed time:

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

Tool payload (dữ liệu thô từ provider + các field chuẩn hóa)

Các tool call (channels.discord.readMessages, channels.slack.readMessages, v.v.) trả về timestamp thô từ provider. Mình cũng thêm các field chuẩn hóa để đảm bảo tính nhất quán:

  • timestampMs (UTC epoch milliseconds)
  • timestampUtc (ISO 8601 UTC string)

Các field thô từ provider vẫn được giữ nguyên.

Timezone của người dùng cho system prompt

Đặt agents.defaults.userTimezone để báo cho model biết múi giờ local của người dùng. Nếu không set, OpenClaw sẽ tự động lấy timezone của host khi chạy (không ghi vào config).

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

System prompt sẽ bao gồm:

  • Section Current Date & Time với thời gian local và timezone
  • Time format: 12-hour hoặc 24-hour

Các bạn có thể điều chỉnh định dạng prompt bằng agents.defaults.timeFormat (auto | 12 | 24).

Xem thêm tại Date & Time để hiểu đầy đủ cách hoạt động và các ví dụ.