CLI commands

TUI

`openclaw tui`

Buka antarmuka terminal yang terhubung ke Gateway, atau jalankan dalam mode tertanam lokal.

Panduan terkait: TUI

Opsi

Flag	Bawaan	Deskripsi
`--local`	`false`	Jalankan dengan runtime agen tertanam lokal, bukan Gateway.
`--url <url>`	`gateway.remote.url` dari konfigurasi	URL WebSocket Gateway.
`--token <token>`	(tidak ada)	Token Gateway jika diperlukan.
`--password <pass>`	(tidak ada)	Kata sandi Gateway jika diperlukan.
`--tls-fingerprint <sha256>`	`gateway.remote.tlsFingerprint`	Sidik jari sertifikat TLS yang diharapkan untuk Gateway `wss://` yang disematkan.
`--session <key>`	`main` (atau `global` saat cakupan global)	Kunci sesi. Di dalam ruang kerja agen, agen tersebut dipilih otomatis kecuali diberi prefiks.
`--deliver`	`false`	Kirim balasan asisten melalui kanal yang dikonfigurasi.
`--thinking <level>`	(bawaan model)	Penggantian tingkat pemikiran.
`--message <text>`	(tidak ada)	Kirim pesan awal setelah terhubung.
`--timeout-ms <ms>`	`agents.defaults.timeoutSeconds`	Batas waktu agen. Nilai yang tidak valid mencatat peringatan dan diabaikan.
`--history-limit <n>`	`200`	Entri riwayat yang dimuat saat dilampirkan.

Alias: openclaw chat dan openclaw terminal menjalankan perintah ini dengan --local tersirat.

Catatan

--local tidak dapat digabungkan dengan --url, --token, --password, atau --tls-fingerprint.
tui menyelesaikan SecretRef autentikasi Gateway yang dikonfigurasi untuk autentikasi token/kata sandi jika memungkinkan (penyedia env/file/exec).
Tanpa URL atau port eksplisit, tui mengikuti port Gateway lokal aktif yang dicatat oleh Gateway yang sedang berjalan. --url, OPENCLAW_GATEWAY_URL, OPENCLAW_GATEWAY_PORT, dan konfigurasi Gateway jarak jauh yang eksplisit tetap didahulukan.
Saat dijalankan dari dalam direktori ruang kerja agen yang dikonfigurasi, TUI secara otomatis memilih agen tersebut sebagai bawaan kunci sesi (kecuali --session secara eksplisit berupa agent:<id>:...).
Untuk menampilkan nama host Gateway di footer bagi koneksi berbasis URL nonlokal, jalankan openclaw config set tui.footer.showRemoteHost true. Dinonaktifkan secara bawaan; tidak pernah ditampilkan untuk koneksi local loopback atau koneksi lokal tertanam.
Mode lokal menggunakan runtime agen tertanam secara langsung. Sebagian besar alat lokal berfungsi, tetapi fitur khusus Gateway tidak tersedia.
Mode lokal menambahkan /auth [provider] ke antarmuka perintah TUI.
Gerbang persetujuan Plugin tetap berlaku dalam mode lokal: alat yang memerlukan persetujuan meminta keputusan di terminal, tidak ada yang disetujui otomatis secara diam-diam.
Tujuan sesi muncul di footer dan dapat dikelola dengan /goal.

Contoh

bash

openclaw chatopenclaw tui --localopenclaw tuiopenclaw tui --url ws://127.0.0.1:18789 --token <token>openclaw tui --session main --deliveropenclaw chat --message "Compare my config to the docs and tell me what to fix"# saat dijalankan di dalam ruang kerja agen, menyimpulkan agen tersebut secara otomatisopenclaw tui --session bugfix

Siklus perbaikan konfigurasi

Gunakan mode lokal agar agen tertanam memeriksa konfigurasi saat ini, membandingkannya dengan dokumentasi, dan membantu memperbaikinya dari terminal yang sama.

Jika openclaw config validate sudah gagal, jalankan openclaw configure atau openclaw doctor --fix terlebih dahulu; openclaw chat tidak melewati pengaman konfigurasi tidak valid.

bash

openclaw chat

Kemudian di dalam TUI:

text

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

Terapkan perbaikan yang ditargetkan dengan openclaw config set atau openclaw configure, lalu jalankan kembali openclaw config validate. Lihat TUI dan Konfigurasi.

Terkait

Was this useful?

TUI