วันที่และเวลา

OpenClaw ใช้ค่าเริ่มต้นเป็น เวลาท้องถิ่นของโฮสต์สำหรับการประทับเวลาของการขนส่ง และใช้ เขตเวลาของผู้ใช้เฉพาะในพรอมป์ระบบ. การประทับเวลาของผู้ให้บริการจะถูกเก็บไว้ เพื่อให้เครื่องมือยังคงความหมายดั้งเดิมของตน (เวลาปัจจุบันพร้อมใช้งานผ่าน session_status).

ซองข้อความ (ค่าเริ่มต้นเป็นเวลาท้องถิ่น)

ข้อความขาเข้าจะถูกห่อด้วยการประทับเวลา (ความละเอียดระดับวินาที):

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

การประทับเวลาในซองนี้เป็น เวลาท้องถิ่นของโฮสต์โดยค่าเริ่มต้น ไม่ว่าเขตเวลาของผู้ให้บริการจะเป็นอะไร

คุณสามารถแทนที่พฤติกรรมนี้ได้:

{  agents: {    defaults: {      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone      envelopeTimestamp: "on", // "on" | "off"      envelopeElapsed: "on", // "on" | "off"    },  },}

• envelopeTimezone: "utc" ใช้ UTC.
• envelopeTimezone: "local" ใช้เขตเวลาของโฮสต์.
• envelopeTimezone: "user" ใช้ agents.defaults.userTimezone (ถอยกลับไปใช้เขตเวลาของโฮสต์).
• ใช้เขตเวลา IANA แบบชัดเจน (เช่น "America/Chicago") สำหรับโซนคงที่.
• envelopeTimestamp: "off" ลบการประทับเวลาแบบสัมบูรณ์ออกจากส่วนหัวซอง คำนำหน้าพรอมป์ของเอเจนต์โดยตรง และคำนำหน้าอินพุตโมเดลแบบฝัง.
• envelopeElapsed: "off" ลบส่วนต่อท้ายเวลาที่ผ่านไป (รูปแบบ +2m).

ตัวอย่าง

เวลาท้องถิ่น (ค่าเริ่มต้น):

[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] hello

เขตเวลาของผู้ใช้:

[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] hello

เปิดใช้เวลาที่ผ่านไป:

[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] follow-up

พรอมป์ระบบ: วันที่และเวลาปัจจุบัน

หากทราบเขตเวลาของผู้ใช้ พรอมป์ระบบจะรวมส่วน วันที่และเวลาปัจจุบัน โดยเฉพาะพร้อม เฉพาะเขตเวลา (ไม่มีรูปแบบนาฬิกา/เวลา) เพื่อให้การแคชพรอมป์มีเสถียรภาพ:

Time zone: America/Chicago

เมื่อเอเจนต์ต้องการเวลาปัจจุบัน ให้ใช้เครื่องมือ session_status; การ์ดสถานะ มีบรรทัดการประทับเวลา

บรรทัดเหตุการณ์ระบบ (ค่าเริ่มต้นเป็นเวลาท้องถิ่น)

เหตุการณ์ระบบที่อยู่ในคิวซึ่งแทรกลงในบริบทของเอเจนต์จะมีคำนำหน้าด้วยการประทับเวลาโดยใช้ การเลือกเขตเวลาเดียวกับซองข้อความ (ค่าเริ่มต้น: เวลาท้องถิ่นของโฮสต์).

System: [2026-01-12 12:19:17 PST] Model switched.

กำหนดค่าเขตเวลาของผู้ใช้ + รูปแบบ

{  agents: {    defaults: {      userTimezone: "America/Chicago",      timeFormat: "auto", // auto | 12 | 24    },  },}

• userTimezone ตั้งค่า เขตเวลาท้องถิ่นของผู้ใช้ สำหรับบริบทพรอมป์.
• timeFormat ควบคุม การแสดงผลแบบ 12h/24h ในพรอมป์. auto ทำตามค่ากำหนดของระบบปฏิบัติการ.

การตรวจหารูปแบบเวลา (อัตโนมัติ)

เมื่อ timeFormat: "auto" OpenClaw จะตรวจสอบค่ากำหนดของระบบปฏิบัติการ (macOS/Windows) และถอยกลับไปใช้การจัดรูปแบบตามโลแคล ค่าที่ตรวจพบจะถูก แคชต่อโปรเซส เพื่อหลีกเลี่ยงการเรียกระบบซ้ำ

เพย์โหลดเครื่องมือ + ตัวเชื่อมต่อ (เวลาผู้ให้บริการดิบ + ฟิลด์ที่ทำให้เป็นมาตรฐาน)

เครื่องมือของช่องทางส่งคืน การประทับเวลาแบบดั้งเดิมของผู้ให้บริการ และเพิ่มฟิลด์ที่ทำให้เป็นมาตรฐานเพื่อความสอดคล้อง:

• timestampMs: มิลลิวินาที epoch (UTC)
• timestampUtc: สตริง UTC ISO 8601

ฟิลด์ดิบของผู้ให้บริการจะถูกเก็บไว้เพื่อไม่ให้ข้อมูลใดสูญหาย

• Slack: สตริงลักษณะ epoch จาก API
• Discord: การประทับเวลา ISO แบบ UTC
• Telegram/WhatsApp: การประทับเวลาแบบตัวเลข/ISO เฉพาะผู้ให้บริการ

หากคุณต้องการเวลาท้องถิ่น ให้แปลงในขั้นปลายทางโดยใช้เขตเวลาที่ทราบ

เอกสารที่เกี่ยวข้อง

• พรอมป์ระบบ
• เขตเวลา
• ข้อความ