TUI (Terminal UI)¶

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

1. เริ่มGateway

openclaw gateway

2. เปิดTUI

openclaw tui

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

Gatewayระยะไกล:

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

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

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

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

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

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

การส่งข้อความ + การส่งมอบ¶

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

ตัวเลือกเลือก (pickers) + โอเวอร์เลย์¶

• ตัวเลือกโมเดล: แสดงรายการโมเดลที่พร้อมใช้งานและตั้งค่า override ของเซสชัน
• ตัวเลือกเอเจนต์: เลือกเอเจนต์อื่น
• ตัวเลือกเซสชัน: แสดงเฉพาะเซสชันของเอเจนต์ปัจจุบัน
• การตั้งค่า: สลับ deliver การขยายเอาต์พุตเครื่องมือ และการแสดงการคิด

คีย์ลัดแป้นพิมพ์¶

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

คำสั่งสแลช¶

แกนหลัก:

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

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

• /think <off|minimal|low|medium|high>
• /verbose <on|full|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

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

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

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

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

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

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

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

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

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

ตัวเลือก¶

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

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

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

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

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

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

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