TUI

Mulai cepat

Mode Gateway

1. Mulai Gateway.

openclaw gateway

2. Buka TUI.

openclaw tui

3. Ketik pesan dan 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# oropenclaw tui --local

Catatan:

• 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 tertanam secara langsung. Sebagian besar alat lokal berfungsi, tetapi fitur khusus Gateway tidak tersedia.
• Setelah file konfigurasi memiliki pengaturan yang dibuat, openclaw dan openclaw crestodian juga menggunakan shell TUI ini, dengan Crestodian sebagai backend chat penyiapan dan perbaikan lokal.

Yang Anda lihat

• Header: URL koneksi, agen saat ini, sesi saat ini.
• Log chat: pesan pengguna, balasan asisten, pemberitahuan sistem, kartu alat.
• Baris status: status koneksi/jalankan (menghubungkan, berjalan, streaming, diam, error).
• Footer: agen + sesi + model + status tujuan + think/fast/verbose/trace/reasoning + jumlah token + deliver. Saat tui.footer.showRemoteHost diaktifkan, koneksi Gateway jarak jauh juga menampilkan host koneksi.
• Input: editor teks dengan pelengkapan otomatis.

Model mental: agen + sesi

• Agen adalah slug unik (mis. main, research). Gateway mengekspos daftarnya.

• Sesi milik agen saat ini.

• Kunci sesi disimpan sebagai agent:<agentId>:<sessionKey>.

  • Jika Anda mengetik /session main, TUI memperluasnya menjadi agent:<currentAgent>:main.
  • Jika Anda mengetik /session agent:other:main, Anda beralih ke sesi agen tersebut secara eksplisit.

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

• Untuk menampilkan host Gateway untuk koneksi berbasis URL non-lokal, aktifkan dengan:

  openclaw config set tui.footer.showRemoteHost true

  Koneksi loopback dan lokal tertanam tidak pernah menampilkan label host.

• Jika sesi memiliki tujuan, footer menampilkan status ringkasnya seperti Pursuing goal, Goal paused (/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 itu masih ada. Meneruskan --session, /session, /new, atau /reset tetap eksplisit.

Pengiriman + delivery

• Pesan dikirim ke Gateway; delivery ke penyedia nonaktif secara default.
• TUI adalah permukaan sumber internal seperti WebChat, bukan kanal keluar generik. Harness yang memerlukan tools.message untuk balasan terlihat dapat memenuhi giliran TUI aktif dengan message.send tanpa target; delivery penyedia eksplisit tetap menggunakan kanal terkonfigurasi normal dan tidak pernah fallback ke lastChannel.
• Aktifkan delivery:
  • /deliver on
  • atau panel Settings
  • atau mulai dengan openclaw tui --deliver

Pemilih + overlay

• Pemilih model: daftar model yang tersedia dan tetapkan override sesi.
• Pemilih agen: pilih agen yang berbeda.
• Pemilih sesi: menampilkan hingga 50 sesi untuk agen saat ini yang diperbarui dalam 7 hari terakhir. Gunakan /session <key> untuk melompat ke sesi lama yang diketahui.
• Settings: ubah delivery, perluasan output alat, dan visibilitas berpikir.

Pintasan keyboard

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

Perintah slash

Inti:

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

Kontrol sesi:

• /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 menghapus override sesi)
• /goal [status] | /goal start <objective> | /goal pause|resume|complete|block|clear
• /elevated <on|off|ask|full> (alias: /elev)
• /activation <mention|always>
• /deliver <on|off>

Siklus hidup sesi:

• /new atau /reset (reset sesi)
• /abort (batalkan proses aktif)
• /settings
• /exit

Hanya mode lokal:

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

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

Perintah shell lokal

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

Perbaiki konfigurasi dari TUI lokal

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

Jika openclaw config validate sudah gagal, mulai dengan openclaw configure atau openclaw doctor --fix terlebih dahulu. openclaw chat tidak melewati penjaga konfigurasi tidak valid.

Loop umum:

1. Mulai mode lokal:

openclaw chat

2. Minta agen memeriksa yang Anda inginkan, misalnya:

Compare my gateway auth config with the docs and suggest the smallest fix.

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 sempit dengan openclaw config set atau openclaw configure, lalu jalankan ulang !openclaw config validate.
5. Jika Doctor merekomendasikan migrasi atau perbaikan otomatis, tinjau dan jalankan !openclaw doctor --fix.

Tips:

• Lebih pilih openclaw config set atau openclaw configure daripada mengedit openclaw.json secara manual.
• openclaw docs "<query>" mencari indeks dokumentasi live dari mesin yang sama.
• openclaw config validate --json berguna saat Anda menginginkan skema terstruktur dan error SecretRef/keterpecahan resolusi.

Output alat

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

Warna terminal

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

Riwayat + streaming

• Saat tersambung, TUI memuat riwayat terbaru (default 200 pesan).
• Respons streaming diperbarui di tempat hingga difinalisasi.
• TUI juga mendengarkan event alat agen untuk kartu alat yang lebih kaya.

Detail koneksi

• TUI mendaftar ke Gateway sebagai mode: "tui".
• Koneksi ulang menampilkan pesan sistem; celah event ditampilkan di log.

Opsi

• --local: Jalankan terhadap runtime agen tertanam lokal
• --url <url>: URL WebSocket Gateway (default ke konfigurasi atau ws://127.0.0.1:<port>)
• --token <token>: Token Gateway (jika diperlukan)
• --password <password>: Kata sandi Gateway (jika diperlukan)
• --session <key>: Kunci sesi (default: main, atau global saat cakupan global)
• --deliver: Kirim balasan asisten ke penyedia (default nonaktif)
• --thinking <level>: Override tingkat berpikir untuk pengiriman
• --message <text>: Kirim pesan awal setelah tersambung
• --timeout-ms <ms>: Timeout agen dalam ms (default ke agents.defaults.timeoutSeconds)
• --history-limit <n>: Entri riwayat yang akan dimuat (default 200)

Pemecahan masalah

Tidak ada output setelah mengirim pesan:

• Jalankan /status di TUI untuk memastikan Gateway tersambung dan diam/sibuk.
• Periksa log Gateway: openclaw logs --follow.
• Pastikan agen dapat berjalan: openclaw status dan openclaw models status.
• Jika Anda mengharapkan pesan di kanal chat, aktifkan delivery (/deliver on atau --deliver).

Pemecahan masalah koneksi

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

Terkait

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