> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TUI

# TUI (Terminal UI)

## त्वरित प्रारंभ

1. Gateway प्रारंभ करें।

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway
```

2. TUI खोलें।

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tui
```

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

दूरस्थ Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tui --url ws://<host>:<port> --token <gateway-token>
```

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

## आप क्या देखते हैं

* Header: कनेक्शन URL, वर्तमान एजेंट, वर्तमान सत्र।
* Chat log: उपयोगकर्ता संदेश, सहायक उत्तर, सिस्टम सूचनाएँ, टूल कार्ड्स।
* Status line: कनेक्शन/रन स्थिति (connecting, running, streaming, idle, error)।
* Footer: कनेक्शन स्थिति + एजेंट + सत्र + मॉडल + think/verbose/reasoning + टोकन गणना + deliver।
* Input: ऑटोकम्प्लीट के साथ टेक्स्ट एडिटर।

## मानसिक मॉडल: एजेंट्स + सत्र

* 3. एजेंट अद्वितीय स्लग होते हैं (उदा. `main`, `research`)। 4. गेटवे सूची को उपलब्ध कराता है।
* सत्र वर्तमान एजेंट से संबंधित होते हैं।
* सत्र कुंजियाँ `agent:<agentId>:<sessionKey>` के रूप में संग्रहीत होती हैं।
  * यदि आप `/session main` टाइप करते हैं, तो TUI इसे `agent:<currentAgent>:main` में विस्तारित करता है।
  * यदि आप `/session agent:other:main` टाइप करते हैं, तो आप उस एजेंट सत्र पर स्पष्ट रूप से स्विच करते हैं।
* सत्र स्कोप:
  * `per-sender` (डिफ़ॉल्ट): प्रत्येक एजेंट के कई सत्र होते हैं।
  * `global`: TUI हमेशा `global` सत्र का उपयोग करता है (पिकर खाली हो सकता है)।
* वर्तमान एजेंट + सत्र हमेशा फ़ूटर में दिखाई देते हैं।

## भेजना + डिलीवरी

* संदेश Gateway को भेजे जाते हैं; प्रदाताओं तक डिलीवरी डिफ़ॉल्ट रूप से बंद रहती है।
* डिलीवरी चालू करें:
  * `/deliver on`
  * या Settings पैनल
  * या `openclaw tui --deliver` के साथ प्रारंभ करें

## पिकर्स + ओवरले

* Model picker: उपलब्ध मॉडलों की सूची और सत्र ओवरराइड सेट करें।
* Agent picker: किसी अन्य एजेंट का चयन करें।
* Session picker: केवल वर्तमान एजेंट के सत्र दिखाता है।
* Settings: deliver, टूल आउटपुट विस्तार, और thinking दृश्यता टॉगल करें।

## कीबोर्ड शॉर्टकट्स

* Enter: संदेश भेजें
* Esc: सक्रिय रन को रद्द करें
* Ctrl+C: इनपुट साफ़ करें (बाहर निकलने के लिए दो बार दबाएँ)
* Ctrl+D: बाहर निकलें
* Ctrl+L: मॉडल पिकर
* Ctrl+G: एजेंट पिकर
* Ctrl+P: सत्र पिकर
* Ctrl+O: टूल आउटपुट विस्तार टॉगल करें
* Ctrl+T: thinking दृश्यता टॉगल करें (इतिहास रीलोड करता है)

## स्लैश कमांड्स

कोर:

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

सत्र नियंत्रण:

* `/think <off|minimal|low|medium|high>`
* `/verbose <on|full|off>`
* `/reasoning <on|off|stream>`
* `/usage <off|tokens|full>`
* `/elevated <on|off|ask|full>` (उपनाम: `/elev`)
* `/activation <mention|always>`
* `/deliver <on|off>`

सत्र जीवनचक्र:

* `/new` या `/reset` (सत्र रीसेट करें)
* `/abort` (सक्रिय रन रद्द करें)
* `/settings`
* `/exit`

5. अन्य गेटवे स्लैश कमांड (उदाहरण के लिए, `/context`) गेटवे को फ़ॉरवर्ड किए जाते हैं और सिस्टम आउटपुट के रूप में दिखाए जाते हैं। 6. देखें [Slash commands](/tools/slash-commands)।

## लोकल शेल कमांड्स

* TUI होस्ट पर स्थानीय शेल कमांड चलाने के लिए किसी पंक्ति की शुरुआत `!` से करें।
* TUI प्रति सत्र एक बार स्थानीय निष्पादन की अनुमति पूछता है; अस्वीकार करने पर सत्र के लिए `!` निष्क्रिय रहता है।
* कमांड्स TUI कार्य निर्देशिका में एक नए, नॉन-इंटरैक्टिव शेल में चलते हैं (कोई स्थायी `cd`/env नहीं)।
* अकेला `!` सामान्य संदेश के रूप में भेजा जाता है; प्रारंभिक स्पेस स्थानीय निष्पादन को ट्रिगर नहीं करते।

## टूल आउटपुट

* टूल कॉल्स कार्ड्स के रूप में args + परिणामों के साथ दिखते हैं।
* Ctrl+O से संकुचित/विस्तारित दृश्य के बीच टॉगल होता है।
* टूल चलते समय, आंशिक अपडेट उसी कार्ड में स्ट्रीम होते हैं।

## इतिहास + स्ट्रीमिंग

* कनेक्ट होने पर, TUI नवीनतम इतिहास लोड करता है (डिफ़ॉल्ट 200 संदेश)।
* स्ट्रीमिंग प्रतिक्रियाएँ अंतिम होने तक उसी स्थान पर अपडेट होती रहती हैं।
* TUI समृद्ध टूल कार्ड्स के लिए एजेंट टूल इवेंट्स भी सुनता है।

## कनेक्शन विवरण

* TUI Gateway के साथ `mode: "tui"` के रूप में पंजीकृत होता है।
* पुनःकनेक्ट पर सिस्टम संदेश दिखते हैं; इवेंट गैप्स लॉग में प्रदर्शित होते हैं।

## विकल्प

* `--url <url>`: Gateway WebSocket URL (डिफ़ॉल्ट config या `ws://127.0.0.1:<port>`)
* `--token <token>`: Gateway टोकन (यदि आवश्यक हो)
* `--password <password>`: Gateway पासवर्ड (यदि आवश्यक हो)
* `--session <key>`: सत्र कुंजी (डिफ़ॉल्ट: `main`, या स्कोप global होने पर `global`)
* `--deliver`: सहायक उत्तरों को प्रदाता तक डिलीवर करें (डिफ़ॉल्ट बंद)
* `--thinking <level>`: भेजने के लिए thinking स्तर ओवरराइड करें
* `--timeout-ms <ms>`: एजेंट टाइमआउट (ms में) (डिफ़ॉल्ट `agents.defaults.timeoutSeconds`)

7. नोट: जब आप `--url` सेट करते हैं, तो TUI कॉन्फ़िग या एनवायरनमेंट क्रेडेंशियल्स पर फ़ॉलबैक नहीं करता।
8. `--token` या `--password` को स्पष्ट रूप से प्रदान करें। 9. स्पष्ट क्रेडेंशियल्स का न होना एक त्रुटि है।

## समस्या-निवारण

संदेश भेजने के बाद कोई आउटपुट नहीं:

* Gateway कनेक्टेड है और idle/busy है या नहीं, यह पुष्टि करने के लिए TUI में `/status` चलाएँ।
* Gateway लॉग्स जाँचें: `openclaw logs --follow`।
* पुष्टि करें कि एजेंट चल सकता है: `openclaw status` और `openclaw models status`।
* यदि आप किसी चैट चैनल में संदेशों की अपेक्षा करते हैं, तो डिलीवरी सक्षम करें (`/deliver on` या `--deliver`)।
* `--history-limit <n>`: लोड किए जाने वाले इतिहास प्रविष्टियाँ (डिफ़ॉल्ट 200)

## कनेक्शन समस्या-निवारण

* `disconnected`: सुनिश्चित करें कि Gateway चल रहा है और आपके `--url/--token/--password` सही हैं।
* पिकर में कोई एजेंट नहीं: `openclaw agents list` और अपनी रूटिंग config जाँचें।
* खाली सत्र पिकर: आप global स्कोप में हो सकते हैं या अभी तक कोई सत्र नहीं है।