TUI

Mulai cepat

Mode Gateway

1. Mulai Gateway.

openclaw gateway

2. Buka TUI.

openclaw tui

3. Ketik pesan lalu tekan Enter.

Gateway jarak jauh:

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

Gunakan --password jika Gateway Anda menggunakan autentikasi kata sandi.

Mode lokal

Jalankan TUI tanpa Gateway:

openclaw chat# atauopenclaw tui --local

• openclaw chat dan openclaw terminal adalah alias untuk openclaw tui --local.
• --local tidak dapat digabungkan dengan --url, --token, atau --password.
• Mode lokal menggunakan runtime agen tersemat secara langsung. Sebagian besar alat lokal berfungsi, tetapi fitur khusus Gateway tidak tersedia.
• openclaw tanpa argumen (tanpa subperintah) memilih target secara otomatis: instalasi yang belum dikonfigurasi menjalankan onboarding inferensi; konfigurasi yang tidak valid membuka panduan Doctor klasik; Gateway terkonfigurasi yang dapat dijangkau membuka shell TUI ini dalam mode Gateway; jika tidak, model lokal terkonfigurasi membukanya dalam mode lokal.

Yang Anda lihat

• Header: URL koneksi, agen saat ini, sesi saat ini.
• Log obrolan: pesan pengguna, balasan asisten, pemberitahuan sistem, kartu alat.
• Baris status: status koneksi/proses (menghubungkan, berjalan, streaming, menganggur, kesalahan).
• Footer: agen + sesi + model + status sasaran + think/fast/verbose/trace/reasoning + jumlah token + pengiriman.
• Input: editor teks dengan pelengkapan otomatis.

Model mental: agen + sesi

• Agen adalah slug unik (misalnya main, research). Gateway menyediakan daftarnya.
• Sesi dimiliki oleh agen saat ini.
• Kunci sesi disimpan sebagai agent:<agentId>:<sessionKey>.
  • Jika Anda mengetik /session main, TUI mengembangkannya menjadi agent:<currentAgent>:main.
  • Jika Anda mengetik /session agent:other:main, Anda beralih secara eksplisit ke sesi agen tersebut.
• Cakupan sesi:
  • per-sender (default): setiap agen memiliki banyak sesi.
  • global: TUI selalu menggunakan sesi global (pemilih mungkin kosong).
• Agen + sesi saat ini selalu terlihat di footer.
• Jika sesi memiliki sasaran, footer menampilkan status ringkasnya: Pursuing goal, Goal paused (/goal resume), Goal blocked (/goal resume), atau Goal achieved.
• Saat dimulai tanpa --session, TUI mode Gateway melanjutkan sesi terakhir yang dipilih untuk Gateway, agen, dan cakupan sesi yang sama jika sesi tersebut masih ada. Pemberian --session, /session, /new, atau /reset tetap bersifat eksplisit.

Pengiriman pesan + penyampaian

• Pesan selalu dikirim ke Gateway (atau runtime tersemat dalam mode lokal); menyampaikan kembali balasan asisten ke penyedia obrolan merupakan langkah terpisah yang secara default dinonaktifkan.
• TUI adalah permukaan sumber internal seperti WebChat, bukan saluran keluar generik. Harness yang memerlukan tools.message untuk balasan yang terlihat dapat memenuhi giliran TUI aktif dengan message.send tanpa target; penyampaian eksplisit ke penyedia tetap menggunakan saluran terkonfigurasi normal dan tidak pernah beralih ke lastChannel sebagai fallback.
• Penyampaian ditetapkan untuk seluruh sesi TUI saat peluncuran: mulai dengan openclaw tui --deliver untuk mengaktifkannya. Tidak ada perintah garis miring /deliver atau tombol alih Settings untuk mengubahnya di tengah sesi; mulai ulang TUI untuk mengubahnya.

Pemilih + overlay

• Pemilih model: mencantumkan model yang tersedia dan menetapkan penggantian sesi.
• Pemilih agen: memilih agen yang berbeda.
• Pemilih sesi: menampilkan hingga 50 sesi untuk agen saat ini yang diperbarui dalam 7 hari terakhir. Gunakan /session <key> untuk berpindah ke sesi lama yang diketahui.
• Settings (/settings): alihkan perluasan output alat dan visibilitas proses berpikir. Panel ini tidak mengontrol penyampaian.

Pintasan papan ketik

• Enter: kirim pesan
• Esc: batalkan proses aktif
• Ctrl+C: kosongkan input (tekan dua kali untuk keluar)
• Ctrl+D: keluar
• Ctrl+L: pemilih model
• Ctrl+G: pemilih agen
• Ctrl+P: pemilih sesi
• Ctrl+O: alihkan perluasan output alat
• Ctrl+T: alihkan visibilitas proses berpikir (memuat ulang riwayat)

Perintah garis miring

Inti:

• /help
• /status (diteruskan ke Gateway; menampilkan ringkasan sesi/model)
• /gateway-status (alias /gwstatus; menampilkan status koneksi Gateway secara langsung)
• /agent <id> (atau /agents)
• /session <key> (atau /sessions)
• /model <provider/model> (atau /models)

Kontrol sesi:

• /think <off|minimal|low|medium|high> (tingkat yang lebih tinggi dapat menambahkan level seperti xhigh/max tergantung pada model)
• /fast <status|auto|on|off>
• /verbose <on|full|off>
• /trace <on|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full|reset> (reset/inherit/clear/default menghapus penggantian sesi)
• /goal [status] | /goal start <objective> | /goal edit <objective> | /goal pause|resume|complete|block|clear
• /elevated <on|off|ask|full> (alias: /elev)
• /activation <mention|always>
• /queue <steer|followup|collect|interrupt> [debounce:<duration>] [cap:<n>] [drop:<summarize|old|new>]
• /queue default (atau /queue reset) menghapus penggantian sesi

Siklus hidup sesi:

• /new (membuat sesi baru yang terisolasi dengan kunci baru; tidak memengaruhi klien TUI lain pada sesi lama)
• /reset (mengatur ulang kunci sesi saat ini di tempat)
• /abort (membatalkan proses aktif)
• /settings
• /exit (atau /quit)

Khusus mode lokal:

• /auth [provider] membuka alur autentikasi/login penyedia di dalam TUI.

Mode lokal menerapkan mode antrean yang sama di dalam runtime tersemat. Prompt di tengah proses mengikuti kebijakan /queue sesi: steer menyisipkan saat runtime dapat menerimanya, followup menunggu giliran terpisah, collect menggabungkan prompt yang tertunda, dan interrupt menghentikan proses saat ini sebelum memulai proses baru. /steer <message> eksplisit hanya tersedia untuk Gateway; gunakan /queue steer beserta pesan normal dalam mode lokal.

OpenClaw:

• /openclaw [request] kembali dari TUI agen normal ke obrolan penyiapan/perbaikan OpenClaw, dengan opsi meneruskan satu permintaan.

Perintah garis miring Gateway lainnya (misalnya, /context) diteruskan ke Gateway dan ditampilkan sebagai output sistem. Lihat Perintah garis miring.

Perintah shell lokal

• Awali baris dengan ! untuk menjalankan perintah shell lokal pada host TUI.
• TUI meminta izin sekali per sesi untuk mengizinkan eksekusi lokal; penolakan membuat ! tetap dinonaktifkan selama sesi.
• Perintah dijalankan dalam shell baru yang noninteraktif di direktori kerja TUI (tanpa cd/lingkungan yang persisten).
• Perintah shell lokal menerima OPENCLAW_SHELL=tui-local dalam lingkungannya.
• ! tunggal dikirim sebagai pesan normal; spasi di awal tidak memicu eksekusi lokal.

Pembantu penyiapan dan perbaikan OpenClaw

OpenClaw adalah asisten penyiapan/perbaikan ring-zero, yang tersedia sebagai openclaw setup setelah model default terkonfigurasi lolos pemeriksaan inferensi langsung. Jika inferensi tidak tersedia, pemanggilan interaktif kembali ke onboarding inferensi dan otomatisasi gagal dengan panduan perbaikan. Asisten ini berjalan di dalam shell TUI lokal yang sama dengan openclaw tui --local, didukung oleh agen AI yang dibatasi pada operasi OpenClaw yang bertipe dan memerlukan persetujuan:

openclaw setup                       # mulai secara interaktifopenclaw setup -m "status"           # jalankan satu permintaan lalu keluaropenclaw setup -m "set default model openai/gpt-5.2" --yes   # terapkan penulisan konfigurasi

• Penulisan konfigurasi persisten memerlukan persetujuan: konfirmasikan secara interaktif atau berikan --yes.
• --json mencetak ikhtisar awal sebagai JSON alih-alih memulai obrolan.
• Dari dalam OpenClaw, permintaan open-tui (misalnya, meminta berbicara dengan agen normal) keluar dari OpenClaw dan membuka TUI agen biasa; gunakan /openclaw di sana untuk kembali.

Gunakan mode lokal ketika konfigurasi saat ini sudah valid dan Anda ingin agen tersemat memeriksanya di mesin yang sama, membandingkannya dengan dokumentasi, dan membantu memperbaiki penyimpangan tanpa bergantung pada Gateway yang sedang berjalan.

Jika openclaw config validate sudah gagal, mulai dengan openclaw configure atau openclaw doctor --fix terlebih dahulu; openclaw chat tetap memerlukan konfigurasi yang dapat dimuat agar dapat dimulai.

Siklus umum:

1. Mulai mode lokal:

openclaw chat

2. Tanyakan kepada agen apa yang ingin Anda periksa, misalnya:

Bandingkan konfigurasi autentikasi Gateway saya dengan dokumentasi dan sarankan perbaikan terkecil.

3. Gunakan perintah shell lokal untuk bukti dan validasi yang tepat:

!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctor

4. Terapkan perubahan terbatas dengan openclaw config set atau openclaw configure, lalu jalankan kembali !openclaw config validate.
5. Jika Doctor menyarankan migrasi atau perbaikan otomatis, tinjau lalu jalankan !openclaw doctor --fix.

Kiat:

• Utamakan openclaw config set atau openclaw configure daripada mengedit openclaw.json secara manual.
• openclaw docs "<query>" mencari indeks dokumentasi langsung dari mesin yang sama.
• openclaw config validate --json berguna ketika Anda menginginkan skema terstruktur serta kesalahan SecretRef/keteruraian.

Output alat

• Panggilan alat ditampilkan sebagai kartu dengan argumen + hasil.
• Ctrl+O beralih antara tampilan diciutkan/diperluas.
• Saat alat berjalan, pembaruan parsial dialirkan ke kartu yang sama.

Warna terminal

• TUI mempertahankan teks isi asisten dalam warna latar depan default terminal Anda agar terminal gelap maupun terang tetap mudah dibaca.
• Jika terminal Anda menggunakan latar belakang terang dan deteksi otomatis keliru, tetapkan OPENCLAW_THEME=light sebelum meluncurkan openclaw tui.
• Untuk memaksakan palet gelap asli, tetapkan OPENCLAW_THEME=dark.

Riwayat + streaming

• Saat terhubung, TUI memuat riwayat terbaru (default 200 pesan).
• Respons streaming diperbarui di tempat hingga selesai.
• TUI juga memantau peristiwa alat agen untuk kartu alat yang lebih kaya.

Detail koneksi

• TUI terhubung dengan ID klien openclaw-tui dalam mode klien umum ui (mode yang sama dengan yang digunakan Control UI dan WebChat untuk kebijakan Gateway).
• Koneksi ulang menampilkan pesan sistem; jeda peristiwa ditampilkan dalam log.

Opsi

• --local: Jalankan dengan runtime agen tertanam lokal
• --url <url>: URL WebSocket Gateway (secara default menggunakan gateway.remote.url dari konfigurasi, atau ws://127.0.0.1:<port> pada loopback)
• --token <token>: Token Gateway (jika diperlukan)
• --password <password>: Kata sandi Gateway (jika diperlukan)
• --tls-fingerprint <sha256>: Sidik jari sertifikat TLS yang diharapkan untuk Gateway wss:// yang disematkan
• --session <key>: Kunci sesi (default: main, atau global jika cakupannya global)
• --deliver: Kirim balasan asisten ke penyedia (secara default nonaktif)
• --thinking <level>: Timpa tingkat penalaran untuk pengiriman
• --message <text>: Kirim pesan awal setelah terhubung
• --timeout-ms <ms>: Batas waktu agen dalam milidetik (secara default agents.defaults.timeoutSeconds)
• --history-limit <n>: Entri riwayat yang akan dimuat (default 200)

Pemecahan masalah

Tidak ada keluaran setelah mengirim pesan:

• Jalankan /status di TUI untuk memastikan Gateway terhubung dan dalam keadaan menganggur/sibuk.
• Periksa log Gateway: openclaw logs --follow.
• Pastikan agen dapat berjalan: openclaw status dan openclaw models status.
• Jika Anda mengharapkan pesan di saluran obrolan, pastikan TUI dimulai dengan --deliver (fitur ini tidak dapat diaktifkan kemudian tanpa memulai ulang).

Pemecahan masalah koneksi

• disconnected: pastikan Gateway berjalan dan --url/--token/--password Anda sudah benar.
• Tidak ada agen dalam pemilih: periksa openclaw agents list dan konfigurasi perutean Anda.
• Pemilih sesi kosong: Anda mungkin berada dalam cakupan global atau belum memiliki sesi.

Terkait

• UI Kontrol — antarmuka kontrol berbasis web
• Konfigurasi — periksa, validasi, dan edit openclaw.json
• Doctor — pemeriksaan perbaikan dan migrasi terpandu
• Referensi CLI — referensi lengkap perintah CLI