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

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 ของผู้ใช้

```json5
{
  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 ของโมเดล

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

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

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