TUI (ٹرمینل UI)¶
فوری آغاز¶
- Gateway شروع کریں۔
openclaw gateway
- TUI کھولیں۔
openclaw tui
- ایک پیغام لکھیں اور 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: آٹو کمپلیٹ کے ساتھ ٹیکسٹ ایڈیٹر۔
ذہنی ماڈل: ایجنٹس + سیشنز¶
- Agents منفرد slugs ہوتے ہیں (مثلاً
main,research)۔ Gateway فہرست فراہم کرتا ہے۔ - سیشنز موجودہ ایجنٹ سے وابستہ ہوتے ہیں۔
- سیشن کیز
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، ٹول آؤٹ پٹ کی توسیع، اور سوچ کی نمائش ٹوگل کریں۔
کی بورڈ شارٹ کٹس¶
- Enter: پیغام بھیجیں
- Esc: فعال رن منسوخ کریں
- Ctrl+C: ان پٹ صاف کریں (باہر نکلنے کے لیے دو بار دبائیں)
- Ctrl+D: باہر نکلیں
- Ctrl+L: ماڈل منتخب کرنے کا اختیار
- Ctrl+G: ایجنٹ منتخب کرنے کا اختیار
- Ctrl+P: سیشن منتخب کرنے کا اختیار
- Ctrl+O: ٹول آؤٹ پٹ کی توسیع ٹوگل کریں
- Ctrl+T: سوچ کی نمائش ٹوگل کریں (ہسٹری ری لوڈ ہوتی ہے)
Slash کمانڈز¶
بنیادی:
/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
دیگر Gateway slash کمانڈز (مثال کے طور پر، /context) Gateway کو فارورڈ کی جاتی ہیں اور سسٹم آؤٹ پٹ کے طور پر دکھائی جاتی ہیں۔ Slash commands دیکھیں۔
لوکل شیل کمانڈز¶
- TUI ہوسٹ پر لوکل شیل کمانڈ چلانے کے لیے لائن کے آغاز میں
!لگائیں۔ - TUI ہر سیشن میں ایک بار لوکل ایگزیکیوشن کی اجازت مانگتا ہے؛ انکار کرنے سے اس سیشن کے لیے
!غیر فعال رہتا ہے۔ - کمانڈز TUI ورکنگ ڈائریکٹری میں ایک نئی، نان-انٹرایکٹو شیل میں چلتی ہیں (مستقل
cd/env نہیں)۔ - صرف
!کو عام پیغام کے طور پر بھیجا جاتا ہے؛ ابتدائی اسپیسز لوکل ایگزیک کو ٹرگر نہیں کرتیں۔
ٹول آؤٹ پٹ¶
- ٹول کالز args + نتائج کے ساتھ کارڈز کے طور پر دکھائی جاتی ہیں۔
- Ctrl+O کولپسڈ/ایکسپینڈڈ ویوز کے درمیان ٹوگل کرتا ہے۔
- جب ٹولز چل رہے ہوں تو جزوی اپڈیٹس اسی کارڈ میں اسٹریمنگ ہوتی ہیں۔
ہسٹری + اسٹریمنگ¶
- کنیکٹ پر، TUI تازہ ترین ہسٹری لوڈ کرتا ہے (بطورِ طے شدہ 200 پیغامات)۔
- اسٹریمنگ جوابات حتمی ہونے تک جگہ پر اپڈیٹ ہوتے رہتے ہیں۔
- TUI بھرپور ٹول کارڈز کے لیے ایجنٹ ٹول ایونٹس بھی سنتا ہے۔
کنکشن کی تفصیلات¶
- TUI Gateway کے ساتھ
mode: "tui"کے طور پر رجسٹر ہوتا ہے۔ - ری کنیکٹس پر سسٹم پیغام دکھایا جاتا ہے؛ ایونٹ گیپس لاگ میں نمایاں کی جاتی ہیں۔
اختیارات¶
--url <url>: Gateway WebSocket URL (کنفیگ یاws://127.0.0.1:<port>بطورِ طے شدہ)--token <token>: Gateway ٹوکن (اگر درکار ہو)--password <password>: Gateway پاس ورڈ (اگر درکار ہو)--session <key>: سیشن کی (بطورِ طے شدہ:main، یا جب اسکوپ گلوبل ہو توglobal)--deliver: اسسٹنٹ کے جوابات فراہم کنندہ تک پہنچائیں (بطورِ طے شدہ بند)--thinking <level>: بھیجنے کے لیے سوچ کی سطح اووررائیڈ کریں--timeout-ms <ms>: ایجنٹ ٹائم آؤٹ (ملی سیکنڈ میں) (بطورِ طے شدہagents.defaults.timeoutSeconds)
نوٹ: جب آپ --url سیٹ کرتے ہیں تو TUI کنفیگ یا ماحول کی اسناد پر واپس نہیں جاتا۔
--token یا --password کو واضح طور پر فراہم کریں۔ واضح اسناد کا نہ ہونا ایک خرابی ہے۔
خرابیوں کا ازالہ¶
پیغام بھیجنے کے بعد کوئی آؤٹ پٹ نہیں:
- 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اور اپنی راؤٹنگ کنفیگ چیک کریں۔ - خالی سیشن پکر: ممکن ہے آپ گلوبل اسکوپ میں ہوں یا ابھی کوئی سیشن موجود نہ ہو۔