TUI (Terminal UI)¶

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

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

openclaw gateway

2. TUI खोलें।

openclaw tui

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

दूरस्थ Gateway:

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।

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

• 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 स्कोप में हो सकते हैं या अभी तक कोई सत्र नहीं है।