मुख्य सामग्री पर जाएं

​
TUI (Terminal UI)

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

  1. Gateway प्रारंभ करें।
openclaw gateway
  1. TUI खोलें।
openclaw tui
  1. एक संदेश टाइप करें और 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: ऑटोकम्प्लीट के साथ टेक्स्ट एडिटर।

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

    1. एजेंट अद्वितीय स्लग होते हैं (उदा. 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
  1. अन्य गेटवे स्लैश कमांड (उदाहरण के लिए, /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)
  1. नोट: जब आप --url सेट करते हैं, तो TUI कॉन्फ़िग या एनवायरनमेंट क्रेडेंशियल्स पर फ़ॉलबैक नहीं करता।
  2. --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 स्कोप में हो सकते हैं या अभी तक कोई सत्र नहीं है।