Concept internals
เขตเวลา
OpenClaw ทำให้รูปแบบ timestamp เป็นมาตรฐาน เพื่อให้โมเดลเห็น เวลาอ้างอิงเดียว แทนที่จะเป็นเวลาจากนาฬิกาท้องถิ่นของผู้ให้บริการหลายแหล่ง มีพื้นผิวสามจุดที่ timezone ปรากฏ โดยแต่ละจุดมีวัตถุประสงค์ของตัวเอง:
พื้นผิว timezone สามจุด
| พื้นผิว | สิ่งที่แสดง | ค่าเริ่มต้น | กำหนดค่าผ่าน |
|---|---|---|---|
| ซองข้อความ | ครอบข้อความช่องทางขาเข้า: [Signal +1555 Sun 2026-01-18 00:19:42 PST] hello |
ตามเครื่องโฮสต์ | agents.defaults.envelopeTimezone |
| payload ของเครื่องมือ | เครื่องมือสไตล์ readMessages ของช่องทางส่งคืนเวลาต้นทางของผู้ให้บริการ + timestampMs / timestampUtc ที่ปรับมาตรฐานแล้ว |
มีฟิลด์ UTC เสมอ | กำหนดค่าไม่ได้ — รักษา timestamp แบบต้นทางของผู้ให้บริการไว้ |
| system prompt | บล็อก Current Date & Time ขนาดเล็กที่มี เฉพาะ timezone (ไม่มีค่านาฬิกา เพื่อให้ cache เสถียร) |
timezone ของโฮสต์ถ้าไม่ได้ตั้ง userTimezone |
agents.defaults.userTimezone |
system prompt ตั้งใจละเว้นเวลานาฬิกาสด เพื่อให้ prompt caching เสถียรข้าม turn เมื่อ agent ต้องการเวลาปัจจุบัน จะเรียก session_status
การตั้งค่า timezone ของผู้ใช้
{ agents: { defaults: { userTimezone: "America/Chicago", }, },}ถ้าไม่ได้ตั้ง userTimezone OpenClaw จะ resolve timezone ของโฮสต์ขณะรันไทม์ (ไม่เขียน config) agents.defaults.timeFormat (auto | 12 | 24) ควบคุมการแสดงผลแบบ 12 ชั่วโมง/24 ชั่วโมงในซองข้อความและพื้นผิวปลายทาง ไม่ใช่ในส่วน system prompt
เมื่อใดควร override
- ใช้ซองข้อความแบบ UTC (
envelopeTimezone: "utc") เมื่อต้องการ timestamp ที่เสถียรข้ามโฮสต์ในภูมิภาคต่าง ๆ หรือเมื่อต้องการให้ log ที่จัดตาม UTC ตรงกับผลลัพธ์ diagnostics - ใช้โซน IANA แบบคงที่ (เช่น
"Europe/Vienna") เมื่อโฮสต์ Gateway อยู่ในโซนหนึ่งแต่ผู้ใช้อยู่ในอีกโซนหนึ่ง และต้องการให้ซองข้อความอ่านตามโซนของผู้ใช้ไม่ว่าโฮสต์จะย้ายไปที่ใด - ตั้ง
envelopeTimestamp: "off"เมื่อบริบท timestamp ไม่มีประโยชน์ต่อการสนทนา การตั้งค่านี้จะนำ timestamp แบบสัมบูรณ์ออกจากซองข้อความ, prefix ของ prompt สำหรับ agent โดยตรง และ prefix ที่ฝังใน input ของโมเดล
สำหรับอ้างอิงพฤติกรรมฉบับเต็ม ตัวอย่างแยกตามผู้ให้บริการ และการจัดรูปแบบเวลาที่ผ่านไป โปรดดู วันที่และเวลา
ที่เกี่ยวข้อง
- วันที่และเวลา — พฤติกรรมและตัวอย่างของซองข้อความ/เครื่องมือ/prompt ฉบับเต็ม
- Heartbeat — active hours ใช้ timezone สำหรับการจัดตารางเวลา
- งาน Cron — นิพจน์ cron ใช้ timezone สำหรับการจัดตารางเวลา
Was this useful?
