TUI

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

# โหมด Gateway

1. เริ่ม Gateway

openclaw gateway

2. เปิด TUI

openclaw tui

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

Gateway ระยะไกล:

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

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

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

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

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

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

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

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

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

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

ลูปทั่วไป:

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

openclaw chat

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

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

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

!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)

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

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

• รัน /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 — อินเทอร์เฟซควบคุมผ่านเว็บ
• การกำหนดค่า — ตรวจสอบ อ่านค่าตรวจสอบ และแก้ไข openclaw.json
• Doctor — การซ่อมแซมแบบมีคำแนะนำและการตรวจสอบการย้าย
• ข้อมูลอ้างอิง CLI — ข้อมูลอ้างอิงคำสั่ง CLI ฉบับเต็ม