Chuyển đến nội dung chính
OpenClaw chuẩn hóa dấu thời gian để mô hình thấy một thời gian tham chiếu duy nhất thay vì hỗn hợp các đồng hồ cục bộ theo nhà cung cấp. Có ba bề mặt nơi múi giờ xuất hiện, mỗi bề mặt có mục đích riêng:

​
Ba bề mặt múi giờ

Bề mặtNội dung hiển thịMặc địnhĐược cấu hình qua
Phong bì tin nhắnBao bọc các tin nhắn kênh đến: [Signal +1555 Sun 2026-01-18 00:19:42 PST] helloCục bộ theo máy chủagents.defaults.envelopeTimezone
Tải trọng công cụCác công cụ kiểu readMessages của kênh trả về thời gian thô từ nhà cung cấp + timestampMs / timestampUtc đã chuẩn hóaCác trường UTC luôn hiện diệnKhông cấu hình được — giữ nguyên dấu thời gian gốc theo nhà cung cấp
Prompt hệ thốngMột khối nhỏ Ngày & giờ hiện tại chỉ có múi giờ (không có giá trị đồng hồ, để ổn định bộ nhớ đệm)Múi giờ của máy chủ nếu chưa đặt userTimezoneagents.defaults.userTimezone
Prompt hệ thống cố ý bỏ qua đồng hồ trực tiếp để giữ bộ nhớ đệm prompt ổn định qua các lượt. Khi agent cần thời gian hiện tại, nó gọi session_status.

​
Đặt múi giờ người dùng

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
Nếu chưa đặt userTimezone, OpenClaw phân giải múi giờ máy chủ khi chạy (không ghi cấu hình). agents.defaults.timeFormat (auto | 12 | 24) kiểm soát cách hiển thị 12h/24h trong phong bì và các bề mặt hạ nguồn, không áp dụng trong phần prompt hệ thống.

​
Khi nào nên ghi đè

  • Dùng phong bì UTC (envelopeTimezone: "utc") khi bạn muốn dấu thời gian ổn định trên các máy chủ ở những khu vực khác nhau, hoặc khi bạn muốn nhật ký căn theo UTC khớp với đầu ra chẩn đoán.
  • Dùng một vùng IANA cố định (ví dụ: "Europe/Vienna") khi máy chủ gateway ở một vùng nhưng người dùng ở vùng khác và bạn muốn phong bì được đọc theo vùng của người dùng bất kể máy chủ được di chuyển.
  • Đặt envelopeTimestamp: "off" khi ngữ cảnh dấu thời gian không hữu ích cho cuộc trò chuyện. Thiết lập này loại bỏ dấu thời gian tuyệt đối khỏi phong bì, tiền tố prompt agent trực tiếp, và tiền tố đầu vào mô hình được nhúng.
Để xem tham chiếu hành vi đầy đủ, ví dụ theo từng nhà cung cấp, và định dạng thời gian đã trôi qua, hãy xem Ngày & giờ.

​
Liên quan

  • Ngày & giờ — hành vi và ví dụ đầy đủ cho phong bì/công cụ/prompt.
  • Heartbeat — giờ hoạt động dùng múi giờ để lập lịch.
  • Tác vụ Cron — biểu thức cron dùng múi giờ để lập lịch.