> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TUI

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

## Khởi động nhanh

1. Khởi động Gateway.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway
```

2. Mở TUI.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tui
```

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

Gateway từ xa:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tui --url ws://<host>:<port> --token <gateway-token>
```

Dùng `--password` nếu Gateway của bạn dùng xác thực bằng mật khẩu.

## 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

Cốt lõi:

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

Điều khiển phiên:

* `/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>`

Vòng đời phiên:

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

Other Gateway slash commands (for example, `/context`) are forwarded to the Gateway and shown as system output. 37. Xem [Slash commands](/tools/slash-commands).

## 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`)

Lưu ý: khi bạn đặt `--url`, TUI không fallback về thông tin xác thực từ config hoặc môi trường.
Truyền `--token` hoặc `--password` một cách tường minh. Thiếu thông tin xác thực tường minh là một lỗi.

## Xử lý sự cố

Không có đầu ra sau khi gửi tin nhắn:

* 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.