About
Getting Started
LLM Providers
Channels
Tools
Agent Memory
Advanced
Security

Interactive TUI

GoClaw includes a terminal-based user interface (TUI) for direct interaction with your agent.

Starting the TUI

goclaw gateway -i

The -i flag starts the gateway with the interactive TUI enabled.

Interface Layout

The TUI has a split-pane layout:

┌─────────────────────────────────┬────────────────────┐
│ Chat                            │ Logs               │
│                                 │                    │
│ You: switch on the lights       │ [INFO] tool call   │
│ Agent: Done — lights are on.    │ [INFO] hass: call  │
│                                 │                    │
│ > Type a message...             │                    │
├─────────────────────────────────┴────────────────────┤
│ ✓ Ready │ User: Alice │ Tab: focus │ Enter: send │
└──────────────────────────────────────────────────────┘

Panels

  • Chat Panel — Conversation with your agent
  • Logs Panel — Real-time gateway logs

Status Bar

Shows connection status, current user, and keyboard shortcuts.

Keyboard Shortcuts

KeyAction
EnterSend message
TabSwitch focus between panels
Ctrl+LToggle layout (horizontal/vertical split)
Ctrl+CExit
Up/DownScroll through message history
PgUp/PgDnScroll logs

Configuration

The TUI is enabled by the -i flag; no additional configuration needed.

Log Level

Control log verbosity:

# Normal logging
goclaw gateway -i

# Debug logging (more verbose)
goclaw gateway -i -d

# Trace logging (very verbose)
goclaw gateway -i -t

Tips

  • The TUI is great for development and testing
  • Logs panel shows tool calls, API requests, and errors in real-time
  • Use Tab to switch between chat and logs for scrolling
  • The gateway continues running all channels (Telegram, HTTP) alongside the TUI

Limitations

  • Requires a terminal with color support
  • Minimum terminal size: 80x24 characters
  • Some terminals may not render Unicode characters correctly