TUI

text

Copy

openclaw tui

Open the terminal UI connected to the Gateway, or run it in local embedded mode.

Related:

• TUI guide: TUI

Notes:

• text

  Copy

  chat
  and
  text

  Copy

  terminal
  are aliases for
  text

  Copy

  openclaw tui --local
  .
• text

  Copy

  --local
  cannot be combined with
  text

  Copy

  --url
  ,
  text

  Copy

  --token
  , or
  text

  Copy

  --password
  .
• text

  Copy

  tui
  resolves configured gateway auth SecretRefs for token/password auth when possible (
  text

  Copy

  env
  /
  text

  Copy

  file
  /
  text

  Copy

  exec
  providers).
• When launched from inside a configured agent workspace directory, TUI auto-selects that agent for the session key default (unless
  text

  Copy

  --session
  is explicitly
  text

  Copy

  agent:<id>:...
  ).
• Local mode uses the embedded agent runtime directly. Most local tools work, but Gateway-only features are unavailable.
• Local mode adds
  text

  Copy

  /auth [provider]
  inside the TUI command surface.
• Plugin approval gates still apply in local mode. Tools that require approval prompt for a decision in the terminal; nothing is silently auto-approved because the Gateway is not involved.

Examples

bash
Copy
openclaw chat
openclaw tui --local
openclaw tui
openclaw tui --url ws://127.0.0.1:18789 --token <token>
openclaw tui --session main --deliver
openclaw chat --message "Compare my config to the docs and tell me what to fix"
# when run inside an agent workspace, infers that agent automatically
openclaw tui --session bugfix

Config repair loop

Use local mode when the current config already validates and you want the embedded agent to inspect it, compare it against the docs, and help repair it from the same terminal:

If

is already failing, use or first. does not bypass the invalid- config guard.

bash
Copy
openclaw chat

Then inside the TUI:

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

Apply targeted fixes with

or , then rerun . See TUI and Config.

Related

• CLI reference
• TUI