---
read_when:
    - คุณต้องการกรอบคิดแบบรวดเร็วสำหรับการจัดการเขตเวลา
    - คุณกำลังตัดสินใจว่าจะตั้งค่าหรือกำหนดเขตเวลาทับที่ใด
summary: ตำแหน่งที่เขตเวลาปรากฏใน OpenClaw — เอนเวโลป, เพย์โหลดของเครื่องมือ, พรอมป์ระบบ
title: เขตเวลา
x-i18n:
    generated_at: "2026-05-06T09:11:09Z"
    model: gpt-5.5
    provider: openai
    source_hash: 041b207a0fa2758a20e8f3c4eca852d3dd416560d045459cb4d86709b45449e3
    source_path: concepts/timezone.md
    workflow: 16
---

OpenClaw ทำให้ timestamp เป็นมาตรฐาน เพื่อให้โมเดลเห็น **เวลาอ้างอิงเดียว** แทนการปะปนของนาฬิกาท้องถิ่นจากผู้ให้บริการแต่ละราย มีสามส่วนที่เขตเวลาปรากฏขึ้น โดยแต่ละส่วนมีวัตถุประสงค์ของตัวเอง:

## สามส่วนของเขตเวลา

| ส่วน              | สิ่งที่แสดง                                                                                              | ค่าเริ่มต้น                            | กำหนดค่าผ่าน                                            |
| ----------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------- | ------------------------------------------------------- |
| ซองข้อความ       | ห่อหุ้มข้อความขาเข้าจากช่องทาง: `[Signal +1555 2026-01-18 00:19 PST] hello`                             | ตามโฮสต์เครื่อง                        | `agents.defaults.envelopeTimezone`                      |
| เพย์โหลดของเครื่องมือ | เครื่องมือของช่องทางแบบ `readMessages` คืนเวลาดิบจากผู้ให้บริการ + `timestampMs` / `timestampUtc` ที่ปรับให้อยู่ในรูปแบบมาตรฐาน | มีฟิลด์ UTC อยู่เสมอ                    | กำหนดค่าไม่ได้ — รักษา timestamp ดั้งเดิมจากผู้ให้บริการ |
| พรอมป์ระบบ       | บล็อก `Current Date & Time` ขนาดเล็กที่มี **เฉพาะเขตเวลา** (ไม่มีค่านาฬิกา เพื่อความเสถียรของแคช)       | เขตเวลาของโฮสต์หากไม่ได้ตั้ง `userTimezone` | `agents.defaults.userTimezone`                          |

พรอมป์ระบบจงใจละค่านาฬิกาสดไว้เพื่อให้การแคชพรอมป์เสถียรข้ามเทิร์น เมื่อเอเจนต์ต้องการเวลาปัจจุบัน จะเรียก `session_status`

## การตั้งค่าเขตเวลาของผู้ใช้

```json5
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
```

หากไม่ได้ตั้ง `userTimezone` OpenClaw จะระบุเขตเวลาของโฮสต์ตอนรันไทม์ (ไม่เขียนค่า config) `agents.defaults.timeFormat` (`auto` | `12` | `24`) ควบคุมการแสดงผลแบบ 12 ชั่วโมง/24 ชั่วโมงในซองข้อความและส่วนปลายทางถัดไป ไม่ใช่ในส่วนพรอมป์ระบบ

## เมื่อใดควรแทนที่ค่า

- **ใช้ซองข้อความแบบ UTC** (`envelopeTimezone: "utc"`) เมื่อคุณต้องการ timestamp ที่เสถียรข้ามโฮสต์ในภูมิภาคต่างกัน หรือเมื่อต้องการให้ log ที่อิง UTC ตรงกับเอาต์พุต diagnostics
- **ใช้โซน IANA แบบคงที่** (เช่น `"Europe/Vienna"`) เมื่อโฮสต์ Gateway อยู่ในโซนหนึ่ง แต่ผู้ใช้อยู่ในอีกโซนหนึ่ง และคุณต้องการให้ซองข้อความอ่านตามโซนของผู้ใช้ไม่ว่าโฮสต์จะย้ายไปที่ใด
- **ตั้ง `envelopeTimestamp: "off"`** สำหรับซองข้อความที่ใช้โทเคนน้อย เมื่อบริบท timestamp ไม่เป็นประโยชน์ต่อการสนทนา

สำหรับข้อมูลอ้างอิงพฤติกรรมฉบับเต็ม ตัวอย่างตามผู้ให้บริการ และการจัดรูปแบบเวลาที่ผ่านไป ดู [วันที่และเวลา](/th/date-time)

## ที่เกี่ยวข้อง

- [วันที่และเวลา](/th/date-time) — พฤติกรรมและตัวอย่างทั้งหมดของซองข้อความ/เครื่องมือ/พรอมป์
- [Heartbeat](/th/gateway/heartbeat) — ชั่วโมงที่ใช้งานใช้เขตเวลาสำหรับการตั้งเวลา
- [Cron Jobs](/th/automation/cron-jobs) — นิพจน์ Cron ใช้เขตเวลาสำหรับการตั้งเวลา