2.2 KiB
2.2 KiB
summary, read_when
| summary | read_when | ||
|---|---|---|---|
| Terminal UI (TUI) for Clawdbot via the Gateway |
|
TUI (Gateway chat client)
What it is
- A terminal UI that connects to the Gateway WebSocket and speaks the same chat APIs as WebChat.
- Uses Gateway agent events for tool cards while streaming responses.
- Works locally (loopback) or remotely (Tailscale/SSH tunnel) without running a separate agent process.
Run
clawdbot tui
Remote
clawdbot tui --url ws://127.0.0.1:18789 --token <gateway-token>
Use SSH tunneling or Tailscale to reach the Gateway WS.
Options
--url <url>: Gateway WebSocket URL (defaults to configgateway.remote.urlorws://127.0.0.1:18789).--token <token>: Gateway token (if required).--password <password>: Gateway password (if required).--session <key>: Session key (default:main, orglobalwhen scope is global).--deliver: Deliver assistant replies to the provider (default off).--thinking <level>: Override thinking level for sends.--timeout-ms <ms>: Agent timeout in ms (defaults toagents.defaults.timeoutSeconds).--history-limit <n>: History entries to load (default 200).
Controls
- Enter: send message
- Esc: abort active run
- Ctrl+C: clear input (press twice to exit)
- Ctrl+D: exit
- Ctrl+L: model picker
- Ctrl+G: agent picker
- Ctrl+P: session picker
- Ctrl+O: toggle tool output expansion
- Ctrl+T: toggle thinking visibility
Slash commands
/help/status/agent <id>(or/agents)/session <key>(or/sessions)/model <provider/model>(or/model list,/models)/think <off|minimal|low|medium|high>/verbose <on|off>/reasoning <on|off|stream>(stream = Telegram draft only)/cost <on|off>/elevated <on|off>/elev <on|off>/activation <mention|always>/deliver <on|off>/newor/reset/compact [instructions]/abort/settings/exit
Notes
- The TUI shows Gateway chat deltas (
event: chat) and agent tool events. - It registers as a Gateway client with
mode: "tui"for presence and debugging.