---
read_when:
    - คุณต้องการทำความเข้าใจการกำหนดเส้นทางเซสชันและการแยกกันทำงาน
    - คุณต้องการกำหนดค่าขอบเขต DM สำหรับการตั้งค่าที่มีผู้ใช้หลายคน
    - คุณกำลังดีบักการรีเซ็ตเซสชันรายวันหรือเมื่อไม่มีการใช้งาน
summary: OpenClaw จัดการเซสชันการสนทนาอย่างไร
title: การจัดการเซสชัน
x-i18n:
    generated_at: "2026-06-27T17:29:48Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: f65249b17c8b45f569531134471683e9f458015b02af29ddf4aa6e1e5c2eac05
    source_path: concepts/session.md
    workflow: 16
---

OpenClaw จัดระเบียบการสนทนาเป็น **เซสชัน** ข้อความแต่ละรายการจะถูกกำหนดเส้นทางไปยัง
เซสชันตามแหล่งที่มา -- DM, แชตกลุ่ม, cron jobs และอื่นๆ

## วิธีการกำหนดเส้นทางข้อความ

| แหล่งที่มา          | พฤติกรรม                  |
| --------------- | ------------------------- |
| ข้อความโดยตรง | ใช้เซสชันร่วมกันตามค่าเริ่มต้น |
| แชตกลุ่ม     | แยกตามกลุ่ม        |
| ห้อง/ช่องทาง  | แยกตามห้อง         |
| Cron jobs       | เซสชันใหม่ต่อการรันแต่ละครั้ง     |
| Webhooks        | แยกตาม hook         |

## การแยก DM

ตามค่าเริ่มต้น DM ทั้งหมดจะใช้เซสชันเดียวร่วมกันเพื่อความต่อเนื่อง วิธีนี้เหมาะสำหรับ
การตั้งค่าสำหรับผู้ใช้คนเดียว

<Warning>
หากมีหลายคนที่สามารถส่งข้อความถึงเอเจนต์ของคุณได้ ให้เปิดใช้การแยก DM หากไม่เปิดใช้ ผู้ใช้ทั้งหมด
จะใช้บริบทการสนทนาเดียวกัน -- ข้อความส่วนตัวของ Alice จะมองเห็นได้สำหรับ Bob
</Warning>

**วิธีแก้:**

```json5
{
  session: {
    dmScope: "per-channel-peer", // isolate by channel + sender
  },
}
```

ตัวเลือกอื่นๆ:

- `main` (ค่าเริ่มต้น) -- DM ทั้งหมดใช้เซสชันเดียวร่วมกัน
- `per-peer` -- แยกตามผู้ส่ง (ข้ามช่องทาง)
- `per-channel-peer` -- แยกตามช่องทาง + ผู้ส่ง (แนะนำ)
- `per-account-channel-peer` -- แยกตามบัญชี + ช่องทาง + ผู้ส่ง

<Tip>
หากคนเดียวกันติดต่อคุณจากหลายช่องทาง ให้ใช้
`session.identityLinks` เพื่อเชื่อมโยงตัวตนของพวกเขาเพื่อให้ใช้เซสชันเดียวร่วมกัน
</Tip>

### Dock ช่องทางที่เชื่อมโยง

คำสั่ง Dock ช่วยให้ผู้ใช้ย้ายเส้นทางตอบกลับของเซสชันแชตโดยตรงปัจจุบันไปยัง
ช่องทางที่เชื่อมโยงอีกช่องทางหนึ่งได้โดยไม่ต้องเริ่มเซสชันใหม่ ดูตัวอย่าง การกำหนดค่า และ
การแก้ไขปัญหาได้ที่ [การ Dock ช่องทาง](/th/concepts/channel-docking)

ตรวจสอบการตั้งค่าของคุณด้วย `openclaw security audit`

## วงจรชีวิตของเซสชัน

เซสชันจะถูกนำกลับมาใช้จนกว่าจะหมดอายุ:

- **รีเซ็ตรายวัน** (ค่าเริ่มต้น) -- เซสชันใหม่เวลา 4:00 น. ตามเวลาท้องถิ่นบนโฮสต์ Gateway
  ความใหม่รายวันอิงตามเวลาที่ `sessionId` ปัจจุบันเริ่มต้น ไม่ใช่
  การเขียนเมตาดาต้าในภายหลัง
- **รีเซ็ตเมื่อไม่ได้ใช้งาน** (ไม่บังคับ) -- เซสชันใหม่หลังจากไม่มีการใช้งานเป็นระยะเวลาหนึ่ง ตั้งค่า
  `session.reset.idleMinutes` ความใหม่เมื่อไม่ได้ใช้งานอิงตามการโต้ตอบจริงล่าสุดของผู้ใช้/ช่องทาง
  ดังนั้น Heartbeat, Cron และเหตุการณ์ระบบ exec จะไม่
  ทำให้เซสชันยังคงอยู่
- **รีเซ็ตด้วยตนเอง** -- พิมพ์ `/new` หรือ `/reset` ในแชต `/new <model>` ยัง
  เปลี่ยนโมเดลด้วย

เมื่อกำหนดค่าทั้งการรีเซ็ตรายวันและการรีเซ็ตเมื่อไม่ได้ใช้งาน รายการใดหมดอายุก่อนจะมีผล
Heartbeat, Cron, exec และ turn ของเหตุการณ์ระบบอื่นๆ อาจเขียนเมตาดาต้าเซสชัน
แต่การเขียนเหล่านั้นจะไม่ขยายความใหม่ของการรีเซ็ตรายวันหรือเมื่อไม่ได้ใช้งาน เมื่อการรีเซ็ต
หมุนเซสชัน ประกาศเหตุการณ์ระบบที่อยู่ในคิวสำหรับเซสชันเก่าจะถูก
ทิ้ง เพื่อไม่ให้การอัปเดตเบื้องหลังที่ค้างอยู่ถูกเติมไว้หน้าพรอมป์แรกใน
เซสชันใหม่

เซสชันที่มีเซสชัน CLI ที่ provider เป็นเจ้าของและยังใช้งานอยู่จะไม่ถูกตัดโดยค่าเริ่มต้นรายวัน
แบบโดยนัย ใช้ `/reset` หรือกำหนดค่า `session.reset` อย่างชัดเจนเมื่อควรให้
เซสชันเหล่านั้นหมดอายุตามตัวจับเวลา

## ตำแหน่งที่เก็บสถานะ

สถานะเซสชันทั้งหมดเป็นของ **Gateway** ไคลเอนต์ UI จะสอบถาม Gateway เพื่อรับ
ข้อมูลเซสชัน

- **ที่เก็บ:** `~/.openclaw/agents/<agentId>/sessions/sessions.json`
- **ทรานสคริปต์:** `~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl`

`sessions.json` เก็บ timestamp ของวงจรชีวิตแยกกัน:

- `sessionStartedAt`: เวลาที่ `sessionId` ปัจจุบันเริ่มต้น; การรีเซ็ตรายวันใช้ค่านี้
- `lastInteractionAt`: การโต้ตอบของผู้ใช้/ช่องทางล่าสุดที่ขยายอายุเมื่อไม่ได้ใช้งาน
- `updatedAt`: การกลายพันธุ์ของแถวในที่เก็บล่าสุด; มีประโยชน์สำหรับการแสดงรายการและการ prune แต่ไม่ใช่
  แหล่งอ้างอิงที่เชื่อถือได้สำหรับความใหม่ของการรีเซ็ตรายวัน/เมื่อไม่ได้ใช้งาน

แถวเก่าที่ไม่มี `sessionStartedAt` จะถูก resolve จาก header เซสชัน JSONL ของทรานสคริปต์
เมื่อมี หากแถวเก่ายังไม่มี `lastInteractionAt` ด้วย
ความใหม่เมื่อไม่ได้ใช้งานจะ fallback ไปยังเวลาเริ่มเซสชันนั้น ไม่ใช่การเขียน bookkeeping
ในภายหลัง

## การบำรุงรักษาเซสชัน

OpenClaw จำกัดพื้นที่จัดเก็บเซสชันโดยอัตโนมัติเมื่อเวลาผ่านไป ตามค่าเริ่มต้น จะทำงาน
ในโหมด `enforce` และใช้การ cleanup ระหว่างการบำรุงรักษา ตั้งค่า
`session.maintenance.mode` เป็น `"warn"` เพื่อรายงานสิ่งที่จะถูก cleanup โดยไม่เปลี่ยนแปลงที่เก็บ/ไฟล์:

```json5
{
  session: {
    maintenance: {
      mode: "enforce",
      pruneAfter: "30d",
      maxEntries: 500,
    },
  },
}
```

สำหรับขีดจำกัด `maxEntries` ระดับ production การเขียนของ runtime Gateway จะใช้ high-water buffer ขนาดเล็กและ cleanup กลับลงมาถึง cap ที่กำหนดค่าไว้เป็นชุด การอ่าน session store จะไม่ prune หรือ cap entries ระหว่างการเริ่มต้น Gateway วิธีนี้หลีกเลี่ยงการเรียกใช้การ cleanup store แบบเต็มทุกครั้งที่เริ่มต้นหรือทุกเซสชัน cron แบบแยก `openclaw sessions cleanup --enforce` จะใช้ cap ทันที

เซสชัน probe การรันโมเดลของ Gateway มีอายุสั้นตามค่าเริ่มต้น แถวที่ตรงกับ
คีย์ชัดเจนแบบเข้มงวด เช่น `agent:*:explicit:model-run-<uuid>` ใช้ระยะเก็บคงที่ `24h`
แต่การ cleanup จะถูก gate ด้วยแรงกดดัน: จะลบแถว probe ที่ค้างเฉพาะเมื่อ
ถึงแรงกดดันจาก maintenance/cap ของ session-entry เท่านั้น เมื่อ cleanup model-run ทำงาน
จะทำงานก่อน cutoff อายุ stale-entry ที่กว้างกว่าและ cap ของ entry เซสชัน direct ปกติ
group, thread, cron, hook, heartbeat, ACP และ sub-agent จะไม่สืบทอด
ระยะเก็บ 24 ชั่วโมงนี้

การบำรุงรักษาจะรักษาตัวชี้การสนทนาภายนอกที่คงทนไว้ รวมถึงเซสชันกลุ่ม
และเซสชันแชตที่ scoped ตาม thread ขณะเดียวกันยังอนุญาตให้รายการ cron,
hook, heartbeat, ACP และ sub-agent แบบสังเคราะห์หมดอายุออกไปได้

หากก่อนหน้านี้คุณใช้การแยก direct-message และภายหลังเปลี่ยน
`session.dmScope` กลับเป็น `main` ให้ preview แถว DM แบบ peer-keyed ที่ค้างอยู่ด้วย
`openclaw sessions cleanup --dry-run --fix-dm-scope` การใช้ flag เดียวกัน
จะ retire แถว direct-DM เก่าเหล่านั้นและเก็บทรานสคริปต์ของแถวเหล่านั้นไว้เป็น archive ที่ถูกลบ

Preview ด้วย `openclaw sessions cleanup --dry-run`

## การตรวจสอบเซสชัน

- `openclaw status` -- path ของ session store และกิจกรรมล่าสุด
- `openclaw sessions --json` -- เซสชันทั้งหมด (กรองด้วย `--active <minutes>`)
- `/status` ในแชต -- การใช้บริบท โมเดล และ toggle
- `/context list` -- สิ่งที่อยู่ใน system prompt

## อ่านเพิ่มเติม

- [Session Pruning](/th/concepts/session-pruning) -- การตัดแต่งผลลัพธ์ของเครื่องมือ
- [Compaction](/th/concepts/compaction) -- การสรุปการสนทนายาว
- [Session Tools](/th/concepts/session-tool) -- เครื่องมือเอเจนต์สำหรับงานข้ามเซสชัน
- [Session Management Deep Dive](/th/reference/session-management-compaction) --
  schema ของ store, ทรานสคริปต์, นโยบายการส่ง, เมตาดาต้า origin และการกำหนดค่าขั้นสูง
- [Multi-Agent](/th/concepts/multi-agent) — การกำหนดเส้นทางและการแยกเซสชันข้ามเอเจนต์
- [Background Tasks](/th/automation/tasks) — วิธีที่งานแบบ detached สร้าง task records พร้อมการอ้างอิงเซสชัน
- [Channel Routing](/th/channels/channel-routing) — วิธีที่ข้อความขาเข้าถูกกำหนดเส้นทางไปยังเซสชัน

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

- [Session pruning](/th/concepts/session-pruning)
- [Session tools](/th/concepts/session-tool)
- [Command queue](/th/concepts/queue)