Technical reference
Ngày và giờ
OpenClaw sử dụng giờ cục bộ của máy chủ cho dấu thời gian truyền tải và chỉ đưa múi giờ vào 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ụ duy trì ngữ nghĩa gốc. Khi tác tử cần biết thời gian
hiện tại, tác tử sẽ chạy công cụ session_status.
Phong bì tin nhắn (mặc định theo giờ cục bộ)
Tin nhắn đến được bao bọc bằng dấu thời gian gồm thứ trong tuần và độ chính xác đến giây:
[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] nội dung tin nhắnDấu thời gian của phong bì mặc định theo giờ cục bộ của máy chủ, bất kể múi giờ của nhà cung cấp.
Ghi đè trong agents.defaults:
{ agents: { defaults: { envelopeTimezone: "local", // "utc" | "local" | "user" | múi giờ IANA envelopeTimestamp: "on", // "on" | "off" envelopeElapsed: "on", // "on" | "off" }, },}| Khóa | Giá trị | Hành vi |
|---|---|---|
envelopeTimezone |
local (mặc định), utc, user, tên IANA cụ thể |
user sử dụng agents.defaults.userTimezone (múi giờ của máy chủ nếu chưa đặt). Tên IANA cụ thể (ví dụ: "America/Chicago") cố định một múi giờ; tên không nhận dạng được sẽ chuyển về UTC. |
envelopeTimestamp |
on (mặc định), off |
off loại bỏ dấu thời gian tuyệt đối khỏi tiêu đề phong bì, tiền tố lời nhắc trực tiếp của tác tử và tiền tố đầu vào mô hình được nhúng. |
envelopeElapsed |
on (mặc định), off |
off loại bỏ hậu tố thời gian đã trôi qua (dạng +30s / +2m) được hiển thị kể từ tin nhắn trước đó trong phiên. |
Ví dụ
Cục bộ (mặc định):
[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] xin chàoMúi giờ của người dùng:
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] xin chàoThời gian đã trôi qua với envelopeTimezone: "utc":
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] tin nhắn tiếp theoLời nhắc hệ thống: ngày và giờ hiện tại
Lời nhắc hệ thống bao gồm phần Ngày & Giờ Hiện Tại chỉ chứa múi giờ (không có đồng hồ hoặc định dạng thời gian) để bộ nhớ đệm lời nhắc luôn ổn định:
Múi giờ: America/ChicagoMúi giờ là agents.defaults.userTimezone khi được cấu hình, nếu không sẽ là múi giờ của máy chủ.
Lời nhắc cũng hướng dẫn tác tử chạy công cụ session_status bất cứ khi nào cần biết
ngày, giờ hoặc thứ trong tuần hiện tại.
Dòng sự kiện hệ thống (mặc định theo giờ cục bộ)
Các sự kiện hệ thống trong hàng đợi được chèn vào ngữ cảnh của tác tử có tiền tố là dấu thời gian sử dụng
cùng lựa chọn envelopeTimezone 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] Đã chuyển mô hình.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 (và choenvelopeTimezone: "user").timeFormatkiểm soát cách hiển thị 12 giờ/24 giờ cho thời gian trong lời nhắc.autotuâ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 và Windows)
và chuyển về định dạng theo ngôn ngữ địa phương nếu không xác định được. Giá trị được phát hiện sẽ được lưu vào bộ nhớ đệm theo từng tiến trình
để tránh lặp lại các lệnh gọi hệ thống.
Tải dữ liệu công cụ + trình kết nối (giờ gốc của nhà cung cấp + các trường đã chuẩn hóa)
Các 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 để bảo đảm tính nhất quán:
timestampMs: số mili giây tính từ epoch (UTC)timestampUtc: chuỗi UTC theo ISO 8601
Các trường gốc của nhà cung cấp được giữ nguyên để không mất dữ liệu.
- Discord: dấu thời gian ISO theo UTC
- Slack: chuỗi dạng epoch từ API
- Telegram/WhatsApp: dấu thời gian dạng số/ISO dành riêng cho nhà cung cấp
Nếu cần giờ cục bộ, hãy chuyển đổi ở bước xử lý tiếp theo bằng múi giờ đã biết.
