TUI

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

Gateway मोड

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

openclaw gateway

2. TUI खोलें।

openclaw tui

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

रिमोट Gateway:

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

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

स्थानीय मोड

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

openclaw chat# याopenclaw tui --local

• openclaw chat और openclaw terminal, openclaw tui --local के उपनाम हैं।
• --local को --url, --token, या --password के साथ संयोजित नहीं किया जा सकता।
• स्थानीय मोड सीधे एम्बेड किए गए एजेंट रनटाइम का उपयोग करता है। अधिकांश स्थानीय टूल काम करते हैं, लेकिन केवल Gateway वाली सुविधाएँ उपलब्ध नहीं होतीं।
• केवल openclaw (कोई उपकमांड नहीं) लक्ष्य अपने आप चुनता है: कॉन्फ़िगर नहीं किया गया इंस्टॉलेशन अनुमान ऑनबोर्डिंग चलाता है; अमान्य कॉन्फ़िगरेशन क्लासिक Doctor मार्गदर्शन खोलता है; पहुँच योग्य कॉन्फ़िगर किया गया Gateway, Gateway मोड में यह TUI शेल खोलता है; अन्यथा कॉन्फ़िगर किया गया स्थानीय मॉडल इसे स्थानीय मोड में खोलता है।

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

• हेडर: कनेक्शन URL, वर्तमान एजेंट, वर्तमान सत्र।
• चैट लॉग: उपयोगकर्ता संदेश, सहायक के उत्तर, सिस्टम सूचनाएँ, टूल कार्ड।
• स्थिति पंक्ति: कनेक्शन/रन स्थिति (कनेक्ट हो रहा है, चल रहा है, स्ट्रीम हो रहा है, निष्क्रिय, त्रुटि)।
• फुटर: एजेंट + सत्र + मॉडल + लक्ष्य स्थिति + विचार/तेज़/विस्तृत/ट्रेस/तर्क + टोकन गणना + डिलीवरी।
• इनपुट: स्वतः-पूर्णता वाला टेक्स्ट एडिटर।

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

• एजेंट अद्वितीय स्लग होते हैं (जैसे main, research)। Gateway इनकी सूची उपलब्ध कराता है।
• सत्र वर्तमान एजेंट से संबंधित होते हैं।
• सत्र कुंजियाँ agent:<agentId>:<sessionKey> के रूप में संग्रहीत होती हैं।
  • यदि आप /session main टाइप करते हैं, तो TUI इसे agent:<currentAgent>:main में विस्तारित करता है।
  • यदि आप /session agent:other:main टाइप करते हैं, तो आप स्पष्ट रूप से उस एजेंट सत्र पर स्विच करते हैं।
• सत्र का दायरा:
  • per-sender (डिफ़ॉल्ट): प्रत्येक एजेंट के कई सत्र होते हैं।
  • global: TUI हमेशा global सत्र का उपयोग करता है (चयनकर्ता खाली हो सकता है)।
• वर्तमान एजेंट + सत्र हमेशा फुटर में दिखाई देते हैं।
• यदि सत्र में कोई लक्ष्य है, तो फुटर उसकी संक्षिप्त स्थिति दिखाता है: Pursuing goal, Goal paused (/goal resume), Goal blocked (/goal resume), या Goal achieved।
• जब --session के बिना शुरू किया जाता है, तो Gateway-मोड TUI उसी Gateway, एजेंट और सत्र दायरे के लिए अंतिम चयनित सत्र को फिर से शुरू करता है, बशर्ते वह सत्र अभी भी मौजूद हो। --session, /session, /new, या /reset देना स्पष्ट चयन ही रहता है।

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

• संदेश हमेशा Gateway (या स्थानीय मोड में एम्बेडेड रनटाइम) को भेजे जाते हैं; सहायक का उत्तर वापस किसी चैट प्रदाता को पहुँचाना एक अलग चरण है, जो डिफ़ॉल्ट रूप से बंद रहता है।
• TUI, WebChat जैसी आंतरिक स्रोत सतह है, कोई सामान्य आउटबाउंड चैनल नहीं। दृश्यमान उत्तरों के लिए tools.message की आवश्यकता वाले हार्नेस, लक्ष्य-रहित message.send से सक्रिय TUI टर्न को पूरा कर सकते हैं; स्पष्ट प्रदाता डिलीवरी फिर भी सामान्य कॉन्फ़िगर किए गए चैनलों का उपयोग करती है और कभी भी lastChannel पर वापस नहीं जाती।
• लॉन्च के समय पूरे TUI सत्र के लिए डिलीवरी तय हो जाती है: इसे चालू करने के लिए openclaw tui --deliver से शुरू करें। सत्र के बीच में इसे बदलने के लिए कोई /deliver स्लैश कमांड या Settings टॉगल नहीं है; इसे बदलने के लिए TUI फिर से शुरू करें।

चयनकर्ता + ओवरले

• मॉडल चयनकर्ता: उपलब्ध मॉडलों की सूची दिखाएँ और सत्र ओवरराइड सेट करें।
• एजेंट चयनकर्ता: कोई अलग एजेंट चुनें।
• सत्र चयनकर्ता: वर्तमान एजेंट के पिछले 7 दिनों में अपडेट किए गए अधिकतम 50 सत्र दिखाता है। किसी पुराने ज्ञात सत्र पर जाने के लिए /session <key> का उपयोग करें।
• सेटिंग्स (/settings): टूल आउटपुट विस्तार और विचारों की दृश्यता टॉगल करें। यह पैनल डिलीवरी को नियंत्रित नहीं करता।

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

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

स्लैश कमांड

कोर:

• /help
• /status (Gateway को अग्रेषित; सत्र/मॉडल सारांश दिखाता है)
• /gateway-status (उपनाम /gwstatus; सीधे Gateway कनेक्शन की स्थिति दिखाता है)
• /agent <id> (या /agents)
• /session <key> (या /sessions)
• /model <provider/model> (या /models)

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

• /think <off|minimal|low|medium|high> (मॉडल के आधार पर उच्चतर स्तरों में xhigh/max जैसे स्तर जोड़े जा सकते हैं)
• /fast <status|auto|on|off>
• /verbose <on|full|off>
• /trace <on|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full|reset> (reset/inherit/clear/default सत्र ओवरराइड साफ़ करता है)
• /goal [status] | /goal start <objective> | /goal edit <objective> | /goal pause|resume|complete|block|clear
• /elevated <on|off|ask|full> (उपनाम: /elev)
• /activation <mention|always>
• /queue <steer|followup|collect|interrupt> [debounce:<duration>] [cap:<n>] [drop:<summarize|old|new>]
• /queue default (या /queue reset) सत्र ओवरराइड साफ़ करता है

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

• /new (नई कुंजी के अंतर्गत नया, पृथक सत्र बनाएँ; पुराने सत्र के अन्य TUI क्लाइंट प्रभावित नहीं होते)
• /reset (वर्तमान सत्र कुंजी को उसी स्थान पर रीसेट करें)
• /abort (सक्रिय रन निरस्त करें)
• /settings
• /exit (या /quit)

केवल स्थानीय मोड:

• /auth [provider] TUI के भीतर प्रदाता प्रमाणीकरण/लॉगिन प्रवाह खोलता है।

स्थानीय मोड एम्बेडेड रनटाइम के भीतर उन्हीं कतार मोड को लागू करता है। रन के बीच में दिया गया प्रॉम्प्ट सत्र की /queue नीति का पालन करता है: जब रनटाइम इसे स्वीकार कर सकता है तब steer इसे सम्मिलित करता है, followup अलग टर्न की प्रतीक्षा करता है, collect लंबित प्रॉम्प्ट संयोजित करता है, और interrupt नया रन शुरू करने से पहले वर्तमान रन रोकता है। स्पष्ट /steer <message> केवल Gateway के लिए है; स्थानीय मोड में /queue steer के साथ सामान्य संदेश का उपयोग करें।

OpenClaw:

• /openclaw [request] सामान्य एजेंट TUI से OpenClaw सेटअप/मरम्मत चैट पर वापस जाता है और वैकल्पिक रूप से एक अनुरोध अग्रेषित करता है।

अन्य Gateway स्लैश कमांड (उदाहरण के लिए, /context) Gateway को अग्रेषित किए जाते हैं और सिस्टम आउटपुट के रूप में दिखाए जाते हैं। स्लैश कमांड देखें।

स्थानीय शेल कमांड

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

OpenClaw सेटअप और मरम्मत सहायक

OpenClaw रिंग-ज़ीरो सेटअप/मरम्मत सहायक है, जो कॉन्फ़िगर किया गया डिफ़ॉल्ट मॉडल लाइव अनुमान जाँच पास करने के बाद openclaw setup के रूप में उपलब्ध होता है। यदि अनुमान उपलब्ध नहीं है, तो इंटरैक्टिव आह्वान अनुमान ऑनबोर्डिंग पर लौटता है और स्वचालन मरम्मत मार्गदर्शन के साथ विफल हो जाता है। यह openclaw tui --local वाले उसी स्थानीय TUI शेल के भीतर चलता है और OpenClaw के टाइप किए गए, अनुमोदन-नियंत्रित संचालनों तक सीमित AI एजेंट द्वारा समर्थित है:

openclaw setup                       # इंटरैक्टिव रूप से शुरू करेंopenclaw setup -m "स्थिति"           # एक अनुरोध चलाएँ और बाहर निकलेंopenclaw setup -m "डिफ़ॉल्ट मॉडल openai/gpt-5.2 सेट करें" --yes   # कॉन्फ़िगरेशन लेखन लागू करें

• स्थायी कॉन्फ़िगरेशन लेखन के लिए अनुमोदन आवश्यक है: या तो इंटरैक्टिव रूप से पुष्टि करें या --yes दें।
• --json चैट शुरू करने के बजाय स्टार्टअप अवलोकन को JSON के रूप में प्रिंट करता है।
• OpenClaw के भीतर से, open-tui अनुरोध (उदाहरण के लिए, किसी सामान्य एजेंट से बात करने के लिए कहना) OpenClaw से बाहर निकलकर नियमित एजेंट TUI खोलता है; वापस आने के लिए वहाँ /openclaw का उपयोग करें।

स्थानीय मोड का उपयोग तब करें जब वर्तमान कॉन्फ़िगरेशन पहले से मान्य हो और आप चाहते हों कि एम्बेडेड एजेंट उसी मशीन पर उसका निरीक्षण करे, दस्तावेज़ों से उसकी तुलना करे और चलते हुए Gateway पर निर्भर हुए बिना विचलन ठीक करने में सहायता करे।

यदि openclaw config validate पहले से विफल हो रहा है, तो पहले openclaw configure या openclaw doctor --fix से शुरू करें; openclaw chat को शुरू होने के लिए अभी भी लोड करने योग्य कॉन्फ़िगरेशन चाहिए।

सामान्य चक्र:

1. स्थानीय मोड शुरू करें:

openclaw chat

2. एजेंट से बताएँ कि आप क्या जाँचना चाहते हैं, उदाहरण के लिए:

मेरे Gateway प्रमाणीकरण कॉन्फ़िगरेशन की दस्तावेज़ों से तुलना करें और सबसे छोटा सुधार सुझाएँ।

3. सटीक प्रमाण और सत्यापन के लिए स्थानीय शेल कमांड का उपयोग करें:

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

4. openclaw config set या openclaw configure से सीमित बदलाव लागू करें, फिर !openclaw config validate दोबारा चलाएँ।
5. यदि Doctor स्वचालित माइग्रेशन या मरम्मत सुझाता है, तो उसकी समीक्षा करें और !openclaw doctor --fix चलाएँ।

सुझाव:

• openclaw.json को हाथ से संपादित करने के बजाय openclaw config set या openclaw configure को प्राथमिकता दें।
• openclaw docs "<query>" उसी मशीन से लाइव दस्तावेज़ अनुक्रमणिका खोजता है।
• जब आपको संरचित स्कीमा और SecretRef/समाधान-योग्यता त्रुटियाँ चाहिए, तब openclaw config validate --json उपयोगी है।

टूल आउटपुट

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

टर्मिनल के रंग

• TUI सहायक के मुख्य टेक्स्ट को आपके टर्मिनल के डिफ़ॉल्ट अग्रभूमि रंग में रखता है, ताकि गहरे और हल्के दोनों टर्मिनल पठनीय रहें।
• यदि आपका टर्मिनल हल्की पृष्ठभूमि का उपयोग करता है और स्वतः-पहचान गलत है, तो openclaw tui लॉन्च करने से पहले OPENCLAW_THEME=light सेट करें।
• इसके बजाय मूल गहरा पैलेट लागू करने के लिए OPENCLAW_THEME=dark सेट करें।

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

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

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

• TUI मोटे ui क्लाइंट मोड के अंतर्गत क्लाइंट आईडी openclaw-tui से कनेक्ट होता है (वही मोड जिसका उपयोग Control UI और WebChat, Gateway नीति के लिए करते हैं)।
• दोबारा कनेक्ट होने पर सिस्टम संदेश दिखाई देता है; इवेंट के अंतराल लॉग में दिखाए जाते हैं।

विकल्प

• --local: स्थानीय एम्बेडेड एजेंट रनटाइम के विरुद्ध चलाएँ
• --url <url>: Gateway WebSocket URL (डिफ़ॉल्ट रूप से कॉन्फ़िगरेशन से gateway.remote.url, या लूपबैक पर ws://127.0.0.1:<port>)
• --token <token>: Gateway टोकन (यदि आवश्यक हो)
• --password <password>: Gateway पासवर्ड (यदि आवश्यक हो)
• --tls-fingerprint <sha256>: पिन किए गए wss:// Gateway के लिए अपेक्षित TLS प्रमाणपत्र फ़िंगरप्रिंट
• --session <key>: सत्र कुंजी (डिफ़ॉल्ट: main, या स्कोप ग्लोबल होने पर global)
• --deliver: सहायक के उत्तर प्रदाता को डिलीवर करें (डिफ़ॉल्ट रूप से बंद)
• --thinking <level>: भेजने के लिए चिंतन स्तर ओवरराइड करें
• --message <text>: कनेक्ट होने के बाद एक प्रारंभिक संदेश भेजें
• --timeout-ms <ms>: एजेंट टाइमआउट मिलीसेकंड में (डिफ़ॉल्ट रूप से agents.defaults.timeoutSeconds)
• --history-limit <n>: लोड की जाने वाली इतिहास प्रविष्टियाँ (डिफ़ॉल्ट 200)

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

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

• यह पुष्टि करने के लिए कि Gateway कनेक्टेड और निष्क्रिय/व्यस्त है, TUI में /status चलाएँ।
• Gateway लॉग जाँचें: openclaw logs --follow।
• पुष्टि करें कि एजेंट चल सकता है: openclaw status और openclaw models status।
• यदि आप किसी चैट चैनल में संदेशों की अपेक्षा करते हैं, तो पुष्टि करें कि TUI को --deliver के साथ शुरू किया गया था (पुनः आरंभ किए बिना इसे बाद में चालू नहीं किया जा सकता)।

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

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

संबंधित

• नियंत्रण UI — वेब-आधारित नियंत्रण इंटरफ़ेस
• कॉन्फ़िगरेशन — openclaw.json का निरीक्षण, सत्यापन और संपादन करें
• डॉक्टर — निर्देशित सुधार और माइग्रेशन जाँच
• CLI संदर्भ — संपूर्ण CLI कमांड संदर्भ