---
read_when:
    - คุณต้องการคำแนะนำการใช้งาน TUI แบบทีละขั้นตอนที่เหมาะสำหรับผู้เริ่มต้น
    - คุณต้องการรายการทั้งหมดของฟีเจอร์ คำสั่ง และทางลัดของ TUI
summary: 'อินเทอร์เฟซผู้ใช้แบบเทอร์มินัล (TUI): เชื่อมต่อกับ Gateway หรือเรียกใช้ภายในเครื่องในโหมดฝังตัว'
title: TUI
x-i18n:
    generated_at: "2026-05-05T10:23:17Z"
    model: gpt-5.5
    provider: openai
    source_hash: 2b517ff434cc440aeffd8698df75d4d85c22a19e59b38a1f2383e58e1b4084ff
    source_path: web/tui.md
    workflow: 16
---

## เริ่มต้นอย่างรวดเร็ว

### โหมด Gateway

1. เริ่ม Gateway

```bash
openclaw gateway
```

2. เปิด TUI

```bash
openclaw tui
```

3. พิมพ์ข้อความแล้วกด Enter

Gateway ระยะไกล:

```bash
openclaw tui --url ws://<host>:<port> --token <gateway-token>
```

ใช้ `--password` หาก Gateway ของคุณใช้การยืนยันตัวตนด้วยรหัสผ่าน

### โหมดภายในเครื่อง

เรียกใช้ TUI โดยไม่มี Gateway:

```bash
openclaw chat
# or
openclaw tui --local
```

หมายเหตุ:

- `openclaw chat` และ `openclaw terminal` เป็นนามแฝงของ `openclaw tui --local`
- ไม่สามารถใช้ `--local` ร่วมกับ `--url`, `--token` หรือ `--password`
- โหมดภายในเครื่องใช้รันไทม์เอเจนต์แบบฝังโดยตรง เครื่องมือภายในเครื่องส่วนใหญ่ใช้งานได้ แต่ฟีเจอร์ที่ใช้ได้เฉพาะ Gateway จะไม่พร้อมใช้งาน
- `openclaw` และ `openclaw crestodian` ก็ใช้เชลล์ TUI นี้เช่นกัน โดยมี Crestodian เป็นแบ็กเอนด์แชตสำหรับตั้งค่าและซ่อมแซมภายในเครื่อง

## สิ่งที่คุณจะเห็น

- ส่วนหัว: URL การเชื่อมต่อ, เอเจนต์ปัจจุบัน, เซสชันปัจจุบัน
- บันทึกแชต: ข้อความของผู้ใช้, คำตอบของผู้ช่วย, การแจ้งเตือนระบบ, การ์ดเครื่องมือ
- บรรทัดสถานะ: สถานะการเชื่อมต่อ/การรัน (กำลังเชื่อมต่อ, กำลังรัน, กำลังสตรีม, ว่าง, ข้อผิดพลาด)
- ส่วนท้าย: สถานะการเชื่อมต่อ + เอเจนต์ + เซสชัน + โมเดล + think/fast/verbose/trace/reasoning + จำนวนโทเค็น + deliver
- อินพุต: โปรแกรมแก้ไขข้อความพร้อมการเติมอัตโนมัติ

## โมเดลทางความคิด: เอเจนต์ + เซสชัน

- เอเจนต์คือ slug ที่ไม่ซ้ำกัน (เช่น `main`, `research`) Gateway เปิดเผยรายการนี้
- เซสชันเป็นของเอเจนต์ปัจจุบัน
- คีย์เซสชันถูกเก็บเป็น `agent:<agentId>:<sessionKey>`
  - หากคุณพิมพ์ `/session main` TUI จะขยายเป็น `agent:<currentAgent>:main`
  - หากคุณพิมพ์ `/session agent:other:main` คุณจะสลับไปยังเซสชันเอเจนต์นั้นโดยตรง
- ขอบเขตเซสชัน:
  - `per-sender` (ค่าเริ่มต้น): เอเจนต์แต่ละตัวมีหลายเซสชัน
  - `global`: TUI จะใช้เซสชัน `global` เสมอ (ตัวเลือกอาจว่าง)
- เอเจนต์ + เซสชันปัจจุบันจะแสดงอยู่ในส่วนท้ายเสมอ
- เมื่อเริ่มโดยไม่มี `--session` TUI ในโหมด Gateway จะกลับไปใช้เซสชันที่เลือกล่าสุดสำหรับ Gateway, เอเจนต์ และขอบเขตเซสชันเดียวกัน หากเซสชันนั้นยังมีอยู่ การส่ง `--session`, `/session`, `/new` หรือ `/reset` ยังคงเป็นการระบุอย่างชัดเจน

## การส่ง + การนำส่ง

- ข้อความถูกส่งไปยัง Gateway; การนำส่งไปยังผู้ให้บริการถูกปิดโดยค่าเริ่มต้น
- เปิดการนำส่ง:
  - `/deliver on`
  - หรือแผงการตั้งค่า
  - หรือเริ่มด้วย `openclaw tui --deliver`

## ตัวเลือก + โอเวอร์เลย์

- ตัวเลือกโมเดล: แสดงรายการโมเดลที่ใช้ได้และตั้งค่าการแทนที่ของเซสชัน
- ตัวเลือกเอเจนต์: เลือกเอเจนต์อื่น
- ตัวเลือกเซสชัน: แสดงเซสชันสูงสุด 50 รายการสำหรับเอเจนต์ปัจจุบันที่อัปเดตใน 7 วันที่ผ่านมา ใช้ `/session <key>` เพื่อข้ามไปยังเซสชันเก่าที่ทราบคีย์
- การตั้งค่า: สลับการนำส่ง, การขยายเอาต์พุตเครื่องมือ และการแสดงการคิด

## แป้นพิมพ์ลัด

- Enter: ส่งข้อความ
- Esc: ยกเลิกการรันที่ใช้งานอยู่
- Ctrl+C: ล้างอินพุต (กดสองครั้งเพื่อออก)
- Ctrl+D: ออก
- Ctrl+L: ตัวเลือกโมเดล
- Ctrl+G: ตัวเลือกเอเจนต์
- Ctrl+P: ตัวเลือกเซสชัน
- Ctrl+O: สลับการขยายเอาต์พุตเครื่องมือ
- Ctrl+T: สลับการแสดงการคิด (โหลดประวัติใหม่)

## คำสั่ง slash

หลัก:

- `/help`
- `/status`
- `/agent <id>` (หรือ `/agents`)
- `/session <key>` (หรือ `/sessions`)
- `/model <provider/model>` (หรือ `/models`)

การควบคุมเซสชัน:

- `/think <off|minimal|low|medium|high>`
- `/fast <status|on|off>`
- `/verbose <on|full|off>`
- `/trace <on|off>`
- `/reasoning <on|off|stream>`
- `/usage <off|tokens|full>`
- `/elevated <on|off|ask|full>` (นามแฝง: `/elev`)
- `/activation <mention|always>`
- `/deliver <on|off>`

วงจรชีวิตเซสชัน:

- `/new` หรือ `/reset` (รีเซ็ตเซสชัน)
- `/abort` (ยกเลิกการรันที่ใช้งานอยู่)
- `/settings`
- `/exit`

โหมดภายในเครื่องเท่านั้น:

- `/auth [provider]` เปิดโฟลว์การยืนยันตัวตน/เข้าสู่ระบบของผู้ให้บริการภายใน TUI

คำสั่ง slash อื่นของ Gateway (เช่น `/context`) จะถูกส่งต่อไปยัง Gateway และแสดงเป็นเอาต์พุตระบบ ดู [คำสั่ง slash](/th/tools/slash-commands)

## คำสั่งเชลล์ภายในเครื่อง

- เติม `!` นำหน้าบรรทัดเพื่อรันคำสั่งเชลล์ภายในเครื่องบนโฮสต์ TUI
- TUI จะถามหนึ่งครั้งต่อเซสชันเพื่ออนุญาตการดำเนินการภายในเครื่อง หากปฏิเสธ `!` จะยังคงถูกปิดใช้สำหรับเซสชันนั้น
- คำสั่งรันในเชลล์ใหม่แบบไม่โต้ตอบในไดเรกทอรีทำงานของ TUI (ไม่มี `cd`/env แบบคงอยู่)
- คำสั่งเชลล์ภายในเครื่องจะได้รับ `OPENCLAW_SHELL=tui-local` ในสภาพแวดล้อม
- `!` เดี่ยว ๆ จะถูกส่งเป็นข้อความปกติ ช่องว่างนำหน้าไม่ทริกเกอร์การดำเนินการภายในเครื่อง

## ซ่อมแซมการกำหนดค่าจาก TUI ภายในเครื่อง

ใช้โหมดภายในเครื่องเมื่อการกำหนดค่าปัจจุบันตรวจสอบผ่านแล้ว และคุณต้องการให้
เอเจนต์แบบฝังตรวจสอบบนเครื่องเดียวกัน เปรียบเทียบกับเอกสาร
และช่วยซ่อมแซม drift โดยไม่ต้องพึ่งพา Gateway ที่กำลังรันอยู่

หาก `openclaw config validate` ล้มเหลวอยู่แล้ว ให้เริ่มด้วย `openclaw configure`
หรือ `openclaw doctor --fix` ก่อน `openclaw chat` ไม่ข้ามตัวป้องกันการกำหนดค่าไม่ถูกต้อง

ลูปทั่วไป:

1. เริ่มโหมดภายในเครื่อง:

```bash
openclaw chat
```

2. ถามเอเจนต์ว่าคุณต้องการตรวจสอบอะไร เช่น:

```text
Compare my gateway auth config with the docs and suggest the smallest fix.
```

3. ใช้คำสั่งเชลล์ภายในเครื่องเพื่อหลักฐานและการตรวจสอบที่แน่นอน:

```text
!openclaw config file
!openclaw docs gateway auth token secretref
!openclaw config validate
!openclaw doctor
```

4. ใช้การเปลี่ยนแปลงแบบจำกัดด้วย `openclaw config set` หรือ `openclaw configure` จากนั้นรัน `!openclaw config validate` อีกครั้ง
5. หาก Doctor แนะนำการย้ายหรือซ่อมแซมอัตโนมัติ ให้ตรวจสอบและรัน `!openclaw doctor --fix`

เคล็ดลับ:

- ควรใช้ `openclaw config set` หรือ `openclaw configure` แทนการแก้ไข `openclaw.json` ด้วยมือ
- `openclaw docs "<query>"` ค้นหาดัชนีเอกสารสดจากเครื่องเดียวกัน
- `openclaw config validate --json` มีประโยชน์เมื่อคุณต้องการข้อผิดพลาดของ schema แบบมีโครงสร้างและ SecretRef/resolvability

## เอาต์พุตเครื่องมือ

- การเรียกเครื่องมือแสดงเป็นการ์ดพร้อมอาร์กิวเมนต์ + ผลลัพธ์
- Ctrl+O สลับระหว่างมุมมองแบบยุบ/ขยาย
- ขณะเครื่องมือกำลังรัน การอัปเดตบางส่วนจะสตรีมเข้าในการ์ดเดียวกัน

## สีเทอร์มินัล

- TUI คงข้อความเนื้อหาของผู้ช่วยไว้เป็นสีพื้นหน้าค่าเริ่มต้นของเทอร์มินัล เพื่อให้เทอร์มินัลทั้งแบบมืดและสว่างอ่านได้เสมอ
- หากเทอร์มินัลของคุณใช้พื้นหลังสว่างและการตรวจจับอัตโนมัติผิด ให้ตั้งค่า `OPENCLAW_THEME=light` ก่อนเปิด `openclaw tui`
- หากต้องการบังคับใช้พาเลตสีมืดเดิมแทน ให้ตั้งค่า `OPENCLAW_THEME=dark`

## ประวัติ + การสตรีม

- เมื่อเชื่อมต่อ TUI จะโหลดประวัติล่าสุด (ค่าเริ่มต้น 200 ข้อความ)
- การตอบกลับแบบสตรีมจะอัปเดตในตำแหน่งเดิมจนกว่าจะเสร็จสมบูรณ์
- TUI ยังรับฟังเหตุการณ์เครื่องมือของเอเจนต์เพื่อให้การ์ดเครื่องมือสมบูรณ์ยิ่งขึ้น

## รายละเอียดการเชื่อมต่อ

- TUI ลงทะเบียนกับ Gateway เป็น `mode: "tui"`
- การเชื่อมต่อใหม่จะแสดงข้อความระบบ; ช่องว่างของเหตุการณ์จะแสดงในบันทึก

## ตัวเลือก

- `--local`: รันกับรันไทม์เอเจนต์แบบฝังภายในเครื่อง
- `--url <url>`: URL WebSocket ของ Gateway (ค่าเริ่มต้นจากการกำหนดค่าหรือ `ws://127.0.0.1:<port>`)
- `--token <token>`: โทเค็น Gateway (หากจำเป็น)
- `--password <password>`: รหัสผ่าน Gateway (หากจำเป็น)
- `--session <key>`: คีย์เซสชัน (ค่าเริ่มต้น: `main` หรือ `global` เมื่อขอบเขตเป็น global)
- `--deliver`: นำส่งคำตอบของผู้ช่วยไปยังผู้ให้บริการ (ปิดโดยค่าเริ่มต้น)
- `--thinking <level>`: แทนที่ระดับการคิดสำหรับการส่ง
- `--message <text>`: ส่งข้อความเริ่มต้นหลังจากเชื่อมต่อ
- `--timeout-ms <ms>`: หมดเวลาเอเจนต์เป็น ms (ค่าเริ่มต้นเป็น `agents.defaults.timeoutSeconds`)
- `--history-limit <n>`: รายการประวัติที่จะโหลด (ค่าเริ่มต้น `200`)

<Warning>
เมื่อคุณตั้งค่า `--url` TUI จะไม่ย้อนกลับไปใช้ข้อมูลประจำตัวจากการกำหนดค่าหรือสภาพแวดล้อม ส่ง `--token` หรือ `--password` อย่างชัดเจน การไม่มีข้อมูลประจำตัวที่ระบุอย่างชัดเจนถือเป็นข้อผิดพลาด ในโหมดภายในเครื่อง อย่าส่ง `--url`, `--token` หรือ `--password`
</Warning>

## การแก้ไขปัญหา

ไม่มีเอาต์พุตหลังจากส่งข้อความ:

- รัน `/status` ใน TUI เพื่อยืนยันว่า Gateway เชื่อมต่ออยู่และว่าง/ยุ่ง
- ตรวจสอบบันทึก Gateway: `openclaw logs --follow`
- ยืนยันว่าเอเจนต์สามารถรันได้: `openclaw status` และ `openclaw models status`
- หากคุณคาดว่าจะเห็นข้อความในช่องแชต ให้เปิดการนำส่ง (`/deliver on` หรือ `--deliver`)

## การแก้ไขปัญหาการเชื่อมต่อ

- `disconnected`: ตรวจสอบว่า Gateway กำลังรันอยู่ และ `--url/--token/--password` ของคุณถูกต้อง
- ไม่มีเอเจนต์ในตัวเลือก: ตรวจสอบ `openclaw agents list` และการกำหนดค่าการกำหนดเส้นทางของคุณ
- ตัวเลือกเซสชันว่าง: คุณอาจอยู่ในขอบเขต global หรือยังไม่มีเซสชัน

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

- [Control UI](/th/web/control-ui) — อินเทอร์เฟซควบคุมผ่านเว็บ
- [การกำหนดค่า](/th/cli/config) — ตรวจสอบ อ่านค่าตรวจสอบ และแก้ไข `openclaw.json`
- [Doctor](/th/cli/doctor) — การซ่อมแซมแบบมีคำแนะนำและการตรวจสอบการย้าย
- [ข้อมูลอ้างอิง CLI](/th/cli) — ข้อมูลอ้างอิงคำสั่ง CLI ฉบับเต็ม