TUI

त्वरित शुरुआत

Gateway मोड

1. Gateway शुरू करें।

openclaw gateway

2. TUI खोलें।

openclaw tui

3. संदेश टाइप करें और Enter दबाएँ।

रिमोट Gateway:

openclaw tui --url ws://<host>:<port> --token <gateway-token>

यदि आपका Gateway पासवर्ड auth का उपयोग करता है, तो --password का उपयोग करें।

स्थानीय मोड

Gateway के बिना TUI चलाएँ:

openclaw chat# oropenclaw tui --local

नोट:

• openclaw chat और openclaw terminal, openclaw tui --local के alias हैं।
• --local को --url, --token, या --password के साथ जोड़ा नहीं जा सकता।
• स्थानीय मोड embedded agent runtime का सीधे उपयोग करता है। अधिकांश स्थानीय tools काम करते हैं, लेकिन केवल-Gateway सुविधाएँ उपलब्ध नहीं होतीं।
• config file में authored settings होने के बाद, openclaw और openclaw crestodian भी इसी TUI shell का उपयोग करते हैं, जहाँ Crestodian स्थानीय setup और repair chat backend होता है।

आपको क्या दिखता है

• Header: connection URL, मौजूदा agent, मौजूदा session।
• Chat log: user messages, assistant replies, system notices, tool cards।
• Status line: connection/run state (connecting, running, streaming, idle, error)।
• Footer: agent + session + model + goal state + think/fast/verbose/trace/reasoning + token counts + deliver। जब tui.footer.showRemoteHost सक्षम होता है, तो रिमोट Gateway connections connection host भी दिखाते हैं।
• Input: autocomplete वाला text editor।

मानसिक मॉडल: agents + sessions

• Agents unique slugs होते हैं (जैसे main, research)। Gateway सूची expose करता है।

• Sessions मौजूदा agent से संबंधित होते हैं।

• Session keys agent:<agentId>:<sessionKey> के रूप में संग्रहीत होते हैं।

  • यदि आप /session main टाइप करते हैं, तो TUI इसे agent:<currentAgent>:main में expand करता है।
  • यदि आप /session agent:other:main टाइप करते हैं, तो आप स्पष्ट रूप से उस agent session पर switch करते हैं।

• Session scope:

  • per-sender (default): हर agent के पास कई sessions होते हैं।
  • global: TUI हमेशा global session का उपयोग करता है (picker खाली हो सकता है)।

• मौजूदा agent + session हमेशा footer में दिखाई देते हैं।

• non-local URL-backed connections के लिए Gateway host दिखाने के लिए, इससे opt in करें:

  openclaw config set tui.footer.showRemoteHost true

  Loopback और embedded local connections कभी host label नहीं दिखाते।

• यदि session में goal है, तो footer उसकी compact state दिखाता है, जैसे Pursuing goal, Goal paused (/goal resume), या Goal achieved।

• --session के बिना शुरू करने पर, gateway-mode TUI उसी gateway, agent, और session scope के लिए last selected session resume करता है, यदि वह session अभी भी मौजूद है। --session, /session, /new, या /reset पास करना स्पष्ट ही रहता है।

भेजना + delivery

• Messages Gateway को भेजे जाते हैं; providers को delivery default रूप से off होती है।
• TUI, WebChat की तरह एक internal source surface है, generic outbound channel नहीं। visible replies के लिए tools.message की आवश्यकता रखने वाले harnesses active TUI turn को targetless message.send से satisfy कर सकते हैं; explicit provider delivery अभी भी सामान्य configured channels का उपयोग करती है और कभी lastChannel पर fallback नहीं करती।
• Turn delivery on करें:
  • /deliver on
  • या Settings panel
  • या openclaw tui --deliver के साथ शुरू करें

Pickers + overlays

• Model picker: उपलब्ध models की सूची दिखाएँ और session override set करें।
• Agent picker: कोई अलग agent चुनें।
• Session picker: मौजूदा agent के लिए पिछले 7 दिनों में updated अधिकतम 50 sessions दिखाता है। पुराने known session पर जाने के लिए /session <key> का उपयोग करें।
• Settings: deliver, tool output expansion, और thinking visibility toggle करें।

Keyboard shortcuts

• Enter: message भेजें
• Esc: active run abort करें
• Ctrl+C: input clear करें (exit करने के लिए दो बार दबाएँ)
• Ctrl+D: exit
• Ctrl+L: model picker
• Ctrl+G: agent picker
• Ctrl+P: session picker
• Ctrl+O: tool output expansion toggle करें
• Ctrl+T: thinking visibility toggle करें (history reload करता है)

Slash commands

Core:

• /help
• /status
• /agent <id> (या /agents)
• /session <key> (या /sessions)
• /model <provider/model> (या /models)

Session controls:

• /think <off|minimal|low|medium|high>
• /fast <status|on|off>
• /verbose <on|full|off>
• /trace <on|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full|reset> (reset/inherit/clear/default session override clear करता है)
• /goal [status] | /goal start <objective> | /goal pause|resume|complete|block|clear
• /elevated <on|off|ask|full> (alias: /elev)
• /activation <mention|always>
• /deliver <on|off>

Session lifecycle:

• /new या /reset (session reset करें)
• /abort (active run abort करें)
• /settings
• /exit

केवल local mode:

• /auth [provider] TUI के अंदर provider auth/login flow खोलता है।

अन्य Gateway slash commands (उदाहरण के लिए, /context) Gateway को forward किए जाते हैं और system output के रूप में दिखाए जाते हैं। Slash commands देखें।

Local shell commands

• TUI host पर local shell command चलाने के लिए किसी line के आगे ! लगाएँ।
• TUI local execution allow करने के लिए प्रति session एक बार prompt करता है; decline करने पर session के लिए ! disabled रहता है।
• Commands TUI working directory में fresh, non-interactive shell में चलते हैं (कोई persistent cd/env नहीं)।
• Local shell commands अपने environment में OPENCLAW_SHELL=tui-local प्राप्त करते हैं।
• अकेला ! सामान्य message के रूप में भेजा जाता है; leading spaces local exec trigger नहीं करते।

local TUI से configs repair करें

जब मौजूदा config पहले से validate होता है और आप चाहते हैं कि embedded agent उसी machine पर इसे inspect करे, docs से compare करे, और running Gateway पर निर्भर हुए बिना drift repair करने में मदद करे, तब local mode का उपयोग करें।

यदि openclaw config validate पहले से fail हो रहा है, तो पहले openclaw configure या openclaw doctor --fix से शुरू करें। openclaw chat invalid- config guard को bypass नहीं करता।

Typical loop:

1. local mode शुरू करें:

openclaw chat

2. agent से पूछें कि आप क्या check कराना चाहते हैं, उदाहरण के लिए:

Compare my gateway auth config with the docs and suggest the smallest fix.

3. exact evidence और validation के लिए local shell commands का उपयोग करें:

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

4. openclaw config set या openclaw configure से narrow changes apply करें, फिर !openclaw config validate फिर से चलाएँ।
5. यदि Doctor automatic migration या repair recommend करता है, तो उसे review करें और !openclaw doctor --fix चलाएँ।

Tips:

• openclaw.json को हाथ से edit करने के बजाय openclaw config set या openclaw configure को प्राथमिकता दें।
• openclaw docs "<query>" उसी machine से live docs index search करता है।
• जब आपको structured schema और SecretRef/resolvability errors चाहिए हों, तो openclaw config validate --json उपयोगी है।

Tool output

• Tool calls args + results वाले cards के रूप में दिखते हैं।
• Ctrl+O collapsed/expanded views के बीच toggle करता है।
• Tools चलने के दौरान, partial updates उसी card में stream होते हैं।

Terminal colors

• TUI assistant body text को आपके terminal के default foreground में रखता है ताकि dark और light terminals दोनों readable रहें।
• यदि आपका terminal light background उपयोग करता है और auto-detection गलत है, तो openclaw tui launch करने से पहले OPENCLAW_THEME=light set करें।
• इसके बजाय original dark palette force करने के लिए, OPENCLAW_THEME=dark set करें।

History + streaming

• Connect होने पर, TUI latest history load करता है (default 200 messages)।
• Streaming responses finalized होने तक in place update होते हैं।
• TUI richer tool cards के लिए agent tool events भी listen करता है।

Connection details

• TUI Gateway के साथ mode: "tui" के रूप में register करता है।
• Reconnects system message दिखाते हैं; event gaps log में surfaced होते हैं।

Options

• --local: local embedded agent runtime के विरुद्ध चलाएँ
• --url <url>: Gateway WebSocket URL (config या ws://127.0.0.1:<port> default होता है)
• --token <token>: Gateway token (यदि required हो)
• --password <password>: Gateway password (यदि required हो)
• --session <key>: Session key (default: main, या scope global होने पर global)
• --deliver: assistant replies provider तक deliver करें (default off)
• --thinking <level>: sends के लिए thinking level override करें
• --message <text>: connect होने के बाद initial message भेजें
• --timeout-ms <ms>: Agent timeout ms में (default agents.defaults.timeoutSeconds)
• --history-limit <n>: load करने के लिए history entries (default 200)

Troubleshooting

message भेजने के बाद कोई output नहीं:

• Gateway connected और idle/busy है, यह confirm करने के लिए TUI में /status चलाएँ।
• Gateway logs check करें: openclaw logs --follow।
• confirm करें कि agent run कर सकता है: openclaw status और openclaw models status।
• यदि आप chat channel में messages expect करते हैं, तो delivery enable करें (/deliver on या --deliver)।

Connection troubleshooting

• disconnected: सुनिश्चित करें कि Gateway चल रहा है और आपके --url/--token/--password correct हैं।
• picker में कोई agents नहीं: openclaw agents list और अपना routing config check करें।
• Empty session picker: आप global scope में हो सकते हैं या अभी कोई sessions नहीं हो सकते।

Related

• Control UI — web-based control interface
• Config — openclaw.json inspect, validate, और edit करें
• Doctor — guided repair और migration checks
• CLI Reference — पूरा CLI command reference