Chuyển đến nội dung chính
OpenClaw mặc định dùng giờ cục bộ của máy chủ cho dấu thời gian transport và múi giờ người dùng chỉ trong lời nhắc hệ thống. Dấu thời gian của nhà cung cấp được giữ nguyên để các công cụ giữ đúng ngữ nghĩa gốc (thời gian hiện tại có sẵn qua session_status).

​
Phong bì tin nhắn (mặc định là cục bộ)

Tin nhắn đến được bọc bằng một dấu thời gian (độ chính xác đến giây): 
[Provider ... Mon 2026-01-05 16:26:34 PST] message text
Dấu thời gian phong bì này mặc định là giờ cục bộ của máy chủ, bất kể múi giờ của nhà cung cấp. Bạn có thể ghi đè hành vi này: 
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" dùng UTC.
  • envelopeTimezone: "local" dùng múi giờ của máy chủ.
  • envelopeTimezone: "user" dùng agents.defaults.userTimezone (quay về múi giờ của máy chủ nếu không có).
  • Dùng múi giờ IANA rõ ràng (ví dụ: "America/Chicago") cho một vùng cố định.
  • envelopeTimestamp: "off" xóa dấu thời gian tuyệt đối khỏi tiêu đề phong bì, tiền tố lời nhắc tác tử trực tiếp, và tiền tố đầu vào mô hình được nhúng.
  • envelopeElapsed: "off" xóa hậu tố thời gian đã trôi qua (kiểu +2m).

​
Ví dụ

Cục bộ (mặc định): 
[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] hello
Múi giờ người dùng: 
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] hello
Đã bật thời gian đã trôi qua: 
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] follow-up

​
Lời nhắc hệ thống: ngày và giờ hiện tại

Nếu biết múi giờ của người dùng, lời nhắc hệ thống sẽ bao gồm một mục Ngày & Giờ hiện tại riêng với chỉ múi giờ (không có đồng hồ/định dạng thời gian) để giữ bộ nhớ đệm lời nhắc ổn định: 
Time zone: America/Chicago
Khi tác tử cần thời gian hiện tại, hãy dùng công cụ session_status; thẻ trạng thái bao gồm một dòng dấu thời gian.

​
Dòng sự kiện hệ thống (mặc định là cục bộ)

Các sự kiện hệ thống đã xếp hàng được chèn vào ngữ cảnh tác tử sẽ có tiền tố dấu thời gian bằng cùng lựa chọn múi giờ như phong bì tin nhắn (mặc định: giờ cục bộ của máy chủ). 
System: [2026-01-12 12:19:17 PST] Model switched.

​
Cấu hình múi giờ người dùng + định dạng

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone đặt múi giờ cục bộ của người dùng cho ngữ cảnh lời nhắc.
  • timeFormat kiểm soát hiển thị 12h/24h trong lời nhắc. auto tuân theo tùy chọn của hệ điều hành.

​
Phát hiện định dạng thời gian (tự động)

Khi timeFormat: "auto", OpenClaw kiểm tra tùy chọn của hệ điều hành (macOS/Windows) và quay về định dạng theo locale. Giá trị phát hiện được lưu vào bộ nhớ đệm theo từng tiến trình để tránh gọi hệ thống lặp lại.

​
Tải dữ liệu công cụ + trình kết nối (thời gian thô của nhà cung cấp + trường đã chuẩn hóa)

Công cụ kênh trả về dấu thời gian gốc của nhà cung cấp và thêm các trường đã chuẩn hóa để nhất quán:
  • timestampMs: mili giây epoch (UTC)
  • timestampUtc: chuỗi UTC ISO 8601
Các trường thô của nhà cung cấp được giữ nguyên để không mất gì.
  • Slack: chuỗi dạng epoch từ API
  • Discord: dấu thời gian ISO UTC
  • Telegram/WhatsApp: dấu thời gian số/ISO đặc thù theo nhà cung cấp
Nếu bạn cần giờ cục bộ, hãy chuyển đổi ở tầng sau bằng múi giờ đã biết.

​
Tài liệu liên quan