TUI Overview
openclaw tui launches a Terminal User Interface that provides an intuitive way to manage all OpenClaw features without memorizing command-line arguments.
Start the TUI
openclaw tui
Main Interface
The TUI displays a dashboard on startup:
┌─ OpenClaw Dashboard ─────────────────────────────┐
│ │
│ Status: ● Running Uptime: 2d 5h 30m │
│ Version: 1.2.3 Port: 3000 │
│ │
│ ┌─ Channels ─────────┐ ┌─ Quick Stats ────────┐│
│ │ ● telegram-main │ │ Messages today: 520 ││
│ │ ● discord-dev │ │ Active users: 12 ││
│ │ ○ whatsapp-cs │ │ Tokens used: 125K ││
│ │ ● webchat │ │ Est. cost: $2.50 ││
│ └────────────────────┘ └──────────────────────┘│
│ │
│ [C]hannels [M]odels [A]gents [L]ogs [S]ettings │
│ [P]lugins [T]est [H]elp [Q]uit │
└────────────────────────────────────────────────────┘
Feature Panels
Channel Management (C)
Press C to enter the channel management panel:
┌─ Channels ──────────────────────────────────────────┐
│ │
│ Name Type Status Messages/hr │
│ ───────────────────────────────────────────────── │
│ > telegram-main Telegram ● Online 45 │
│ discord-dev Discord ● Online 30 │
│ whatsapp-cs WhatsApp ○ Offline 0 │
│ webchat Web Chat ● Online 12 │
│ │
│ [Enter] Details [A]dd [E]dit [D]elete [R]econ │
│ [Esc] Back │
└──────────────────────────────────────────────────────┘
Log Viewer (L)
Press L to enter the real-time log panel:
┌─ Logs (live) ─────────────────────────────────────┐
│ 10:30:01 [INFO] Message received: telegram/user1 │
│ 10:30:02 [INFO] Processing with model: gpt-4o │
│ 10:30:03 [INFO] Response sent (1.2s, 45 tokens) │
│ 10:30:15 [WARN] Rate limit approaching: user2 │
│ 10:30:20 [INFO] Message received: discord/user3 │
│ 10:30:21 [INFO] Processing with model: gpt-4o │
│ 10:30:22 [ERROR] Provider timeout: openai (30s) │
│ 10:30:22 [INFO] Fallback to: gpt-4o-mini │
│ │
│ Level: [A]ll [I]nfo [W]arn [E]rror [/]Search │
│ [Esc] Back │
└────────────────────────────────────────────────────┘
Test Chat (T)
Press T to enter the built-in test chat:
┌─ Test Chat ────────────────────────────────────────┐
│ Model: gpt-4o-mini Channel: test │
│ ────────────────────────────────────────────────── │
│ │
│ You: Hello, please introduce yourself │
│ │
│ AI: Hello! I'm the OpenClaw AI assistant. I can │
│ help you answer questions, write code, │
│ translate text, and more. How can I help? │
│ │
│ You: _ │
│ │
│ [Tab] Switch model [Ctrl+L] Clear [Esc] Back │
└─────────────────────────────────────────────────────┘
Keyboard Shortcuts
| Shortcut | Function |
|---|---|
C |
Channel management |
M |
Model management |
A |
Agent management |
L |
Log viewer |
S |
Settings |
P |
Plugin management |
T |
Test chat |
H |
Help |
Q |
Quit |
Tab |
Switch panels |
Esc |
Go back |
/ |
Search |
? |
Current panel help |
Command-Line Options
# Specify a theme
openclaw tui --theme dark
openclaw tui --theme light
# Go directly to a specific panel
openclaw tui --panel channels
openclaw tui --panel logs
# Compact mode (for small terminals)
openclaw tui --compact
Remote Connection
The TUI supports connecting to a remote Gateway:
openclaw tui --remote https://gateway.example.com --api-key your-key
Summary
openclaw tui provides a fully featured management interface for users who prefer terminal-based workflows. It centralizes common operations in a single interface accessible via keyboard shortcuts, making it an ideal tool for managing OpenClaw over SSH.