openclaw/docs/cli/tui.md

876 B

summary read_when title
CLI reference for `openclaw tui` (terminal UI connected to the Gateway)
You want a terminal UI for the Gateway (remote-friendly)
You want to pass url/token/session from scripts
tui

openclaw tui

Open the terminal UI connected to the Gateway.

Related:

  • TUI guide: TUI

Notes:

  • tui resolves configured gateway auth SecretRefs for token/password auth when possible (env/file/exec providers).
  • When launched from inside a configured agent workspace directory, TUI auto-selects that agent for the session key default (unless --session is explicitly agent:<id>:...).

Examples

openclaw tui
openclaw tui --url ws://127.0.0.1:18789 --token <token>
openclaw tui --session main --deliver
# when run inside an agent workspace, infers that agent automatically
openclaw tui --session bugfix