​

TUI (Giao diện dòng lệnh)

​

Khởi động nhanh

1. Khởi động Gateway.

openclaw gateway

2. Mở TUI.

openclaw tui

3. Gõ một tin nhắn và nhấn Enter.

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

​

Những gì bạn thấy

• Header: URL kết nối, tác tử hiện tại, phiên hiện tại.
• Nhật ký trò chuyện: tin nhắn người dùng, trả lời của trợ lý, thông báo hệ thống, thẻ công cụ.
• Dòng trạng thái: trạng thái kết nối/chạy (đang kết nối, đang chạy, đang stream, rảnh, lỗi).
• Footer: trạng thái kết nối + tác tử + phiên + mô hình + think/verbose/reasoning + số token + deliver.
• Input: trình soạn thảo văn bản có tự động hoàn thành.

​

Mô hình tư duy: tác tử + phiên

• Agents are unique slugs (e.g. main, research). Gateway phơi bày danh sách này.
• Phiên thuộc về tác tử hiện tại.
• Khóa phiên được lưu dưới dạng agent:<agentId>:<sessionKey>.
  • Nếu bạn gõ /session main, TUI sẽ mở rộng thành agent:<currentAgent>:main.
  • Nếu bạn gõ /session agent:other:main, bạn sẽ chuyển sang phiên của tác tử đó một cách tường minh.
• Phạm vi phiên:
  • per-sender (mặc định): mỗi tác tử có nhiều phiên.
  • global: TUI luôn dùng phiên global (bộ chọn có thể trống).
• Tác tử + phiên hiện tại luôn hiển thị ở footer.

​

Gửi + chuyển giao

• Tin nhắn được gửi tới Gateway; việc chuyển giao tới các nhà cung cấp mặc định là tắt.
• Bật chuyển giao:
  • /deliver on
  • hoặc bảng Cài đặt
  • hoặc khởi động với openclaw tui --deliver

​

Bộ chọn + lớp phủ

• Bộ chọn mô hình: liệt kê các mô hình khả dụng và đặt ghi đè cho phiên.
• Bộ chọn tác tử: chọn một tác tử khác.
• Bộ chọn phiên: chỉ hiển thị các phiên của tác tử hiện tại.
• Cài đặt: bật/tắt chuyển giao, mở rộng đầu ra công cụ và hiển thị suy nghĩ.

​

Phím tắt bàn phím

• Enter: gửi tin nhắn
• Esc: hủy lần chạy đang hoạt động
• Ctrl+C: xóa nội dung nhập (nhấn hai lần để thoát)
• Ctrl+D: thoát
• Ctrl+L: bộ chọn mô hình
• Ctrl+G: bộ chọn tác tử
• Ctrl+P: bộ chọn phiên
• Ctrl+O: bật/tắt mở rộng đầu ra công cụ
• Ctrl+T: bật/tắt hiển thị suy nghĩ (tải lại lịch sử)

​

Lệnh slash

• /help
• /status
• /agent <id> (hoặc /agents)
• /session <key> (hoặc /sessions)
• /model <provider/model> (hoặc /models)

• /think <off|minimal|low|medium|high>
• /verbose <on|full|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full>
• /elevated <on|off|ask|full> (bí danh: /elev)
• /activation <mention|always>
• /deliver <on|off>

• /new hoặc /reset (đặt lại phiên)
• /abort (hủy lần chạy đang hoạt động)
• /settings
• /exit

​

Lệnh shell cục bộ

• Thêm tiền tố ! vào đầu dòng để chạy lệnh shell cục bộ trên máy chủ TUI.
• TUI sẽ hỏi một lần mỗi phiên để cho phép thực thi cục bộ; từ chối sẽ giữ ! bị vô hiệu cho phiên đó.
• Lệnh chạy trong một shell mới, không tương tác, tại thư mục làm việc của TUI (không có cd/env bền vững).
• Một ! đứng riêng lẻ sẽ được gửi như tin nhắn bình thường; khoảng trắng đầu dòng không kích hoạt thực thi cục bộ.

​

Đầu ra công cụ

• Các lần gọi công cụ hiển thị dưới dạng thẻ với tham số + kết quả.
• Ctrl+O chuyển đổi giữa chế độ thu gọn/mở rộng.
• Khi công cụ chạy, các cập nhật từng phần sẽ stream vào cùng một thẻ.

​

Lịch sử + streaming

• Khi kết nối, TUI tải lịch sử gần nhất (mặc định 200 tin nhắn).
• Phản hồi streaming cập nhật tại chỗ cho đến khi hoàn tất.
• TUI cũng lắng nghe các sự kiện công cụ của tác tử để có thẻ công cụ phong phú hơn.

​

Chi tiết kết nối

• TUI đăng ký với Gateway dưới tên mode: "tui".
• Khi kết nối lại sẽ hiển thị thông báo hệ thống; các khoảng trống sự kiện sẽ được phản ánh trong nhật ký.

​

Tùy chọn

• --url <url>: URL WebSocket của Gateway (mặc định từ cấu hình hoặc ws://127.0.0.1:<port>)
• --token <token>: token Gateway (nếu cần)
• --password <password>: mật khẩu Gateway (nếu cần)
• --session <key>: khóa phiên (mặc định: main, hoặc global khi phạm vi là global)
• --deliver: chuyển giao trả lời của trợ lý tới nhà cung cấp (mặc định tắt)
• --thinking <level>: ghi đè mức độ suy nghĩ cho các lần gửi
• --timeout-ms <ms>: thời gian chờ của tác tử tính bằng ms (mặc định agents.defaults.timeoutSeconds)

​

Xử lý sự cố

• Chạy /status trong TUI để xác nhận Gateway đã kết nối và đang rảnh/bận.
• Kiểm tra log của Gateway: openclaw logs --follow.
• Xác nhận tác tử có thể chạy: openclaw status và openclaw models status.
• Nếu bạn mong đợi tin nhắn trong một kênh chat, hãy bật chuyển giao (/deliver on hoặc --deliver).
• --history-limit <n>: số mục lịch sử cần tải (mặc định 200)

​

Xử lý sự cố kết nối

• disconnected: đảm bảo Gateway đang chạy và --url/--token/--password của bạn là chính xác.
• Không có tác tử trong bộ chọn: kiểm tra openclaw agents list và cấu hình định tuyến của bạn.
• Bộ chọn phiên trống: có thể bạn đang ở phạm vi global hoặc chưa có phiên nào.