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# oropenclaw 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 + จำนวนโทเคน + การส่งมอบ เมื่อเปิดใช้ tui.footer.showRemoteHost การเชื่อมต่อ Gateway ระยะไกลจะแสดงโฮสต์การเชื่อมต่อด้วย
• ช่องป้อนข้อมูล: ตัวแก้ไขข้อความพร้อมการเติมข้อความอัตโนมัติ

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

• เอเจนต์คือ slug ที่ไม่ซ้ำกัน (เช่น main, research) Gateway จะแสดงรายการให้

• เซสชันเป็นของเอเจนต์ปัจจุบัน

• คีย์เซสชันถูกจัดเก็บเป็น agent:<agentId>:<sessionKey>

  • หากคุณพิมพ์ /session main TUI จะขยายเป็น agent:<currentAgent>:main
  • หากคุณพิมพ์ /session agent:other:main คุณจะสลับไปยังเซสชันของเอเจนต์นั้นอย่างชัดเจน

• ขอบเขตเซสชัน:

  • per-sender (ค่าเริ่มต้น): เอเจนต์แต่ละตัวมีหลายเซสชัน
  • global: TUI ใช้เซสชัน global เสมอ (ตัวเลือกอาจว่างเปล่า)

• เอเจนต์ + เซสชันปัจจุบันจะแสดงอยู่ในส่วนท้ายเสมอ

• หากต้องการแสดงโฮสต์ Gateway สำหรับการเชื่อมต่อที่อิง URL และไม่ใช่ภายในเครื่อง ให้เปิดใช้ด้วย:

  openclaw config set tui.footer.showRemoteHost true

  การเชื่อมต่อแบบลูปแบ็กและการเชื่อมต่อภายในเครื่องแบบฝังจะไม่แสดงป้ายโฮสต์

• หากเซสชันมี เป้าหมาย ส่วนท้ายจะแสดงสถานะแบบย่อ เช่น Pursuing goal, Goal paused (/goal resume) หรือ Goal achieved

• เมื่อเริ่มโดยไม่มี --session TUI ในโหมด Gateway จะกลับมาใช้เซสชันที่เลือกครั้งล่าสุดสำหรับ Gateway, เอเจนต์ และขอบเขตเซสชันเดียวกัน หากเซสชันนั้นยังมีอยู่ การส่ง --session, /session, /new หรือ /reset ยังคงเป็นการระบุอย่างชัดเจน

การส่ง + การส่งมอบ

• ข้อความจะถูกส่งไปยัง Gateway; การส่งมอบไปยังผู้ให้บริการปิดอยู่ตามค่าเริ่มต้น
• TUI เป็นพื้นผิวต้นทางภายในเช่น WebChat ไม่ใช่ช่องทางขาออกทั่วไป Harness ที่ต้องใช้ tools.message สำหรับคำตอบที่มองเห็นได้สามารถตอบสนองเทิร์น TUI ที่ใช้งานอยู่ด้วย message.send แบบไม่มีเป้าหมาย; การส่งมอบไปยังผู้ให้บริการอย่างชัดเจนยังคงใช้ช่องทางที่กำหนดค่าตามปกติ และจะไม่ถอยกลับไปใช้ lastChannel
• เปิดการส่งมอบ:
  • /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: สลับการมองเห็นการคิด (โหลดประวัติใหม่)

คำสั่งสแลช

หลัก:

• /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|reset> (reset/inherit/clear/default จะล้างการแทนที่ของเซสชัน)
• /goal [status] | /goal start <objective> | /goal pause|resume|complete|block|clear
• /elevated <on|off|ask|full> (นามแฝง: /elev)
• /activation <mention|always>
• /deliver <on|off>

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

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

เฉพาะโหมดภายในเครื่อง:

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

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

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

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

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

ใช้โหมดภายในเครื่องเมื่อการกำหนดค่าปัจจุบันผ่านการตรวจสอบแล้ว และคุณต้องการให้ เอเจนต์แบบฝังตรวจสอบบนเครื่องเดียวกัน เปรียบเทียบกับเอกสาร และช่วยซ่อมแซมความคลาดเคลื่อนโดยไม่ต้องพึ่งพา 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 มีประโยชน์เมื่อคุณต้องการข้อผิดพลาดของสคีมาแบบมีโครงสร้างและข้อผิดพลาดด้านความสามารถในการ resolve ของ SecretRef

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

• การเรียกเครื่องมือจะแสดงเป็นการ์ดพร้อมอาร์กิวเมนต์ + ผลลัพธ์
• 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 หรือยังไม่มีเซสชัน

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

• UI ควบคุม — อินเทอร์เฟซควบคุมบนเว็บ
• การกำหนดค่า — ตรวจสอบ ตรวจสอบความถูกต้อง และแก้ไข openclaw.json
• Doctor — การซ่อมแซมแบบมีคำแนะนำและการตรวจสอบการย้ายข้อมูล
• ข้อมูลอ้างอิง CLI — ข้อมูลอ้างอิงคำสั่ง CLI ฉบับเต็ม