الواجهات على الويب
واجهة المستخدم النصية (TUI)
البدء السريع
- ابدأ تشغيل البوابة.
openclaw gateway
- افتح واجهة المستخدم النصية (TUI).
openclaw tui
- اكتب رسالة واضغط على Enter.
بوابة بعيدة:
openclaw tui --url ws://<host>:<port> --token <gateway-token>
استخدم --password إذا كانت بوابتك تستخدم مصادقة بكلمة مرور.
ما تراه
- الرأس: عنوان URL للاتصال، الوكيل الحالي، الجلسة الحالية.
- سجل المحادثة: رسائل المستخدم، ردود المساعد، إشعارات النظام، بطاقات الأدوات.
- سطر الحالة: حالة الاتصال/التشغيل (جارٍ الاتصال، قيد التشغيل، بث، خامل، خطأ).
- التذييل: حالة الاتصال + الوكيل + الجلسة + النموذج + التفكير/التفصيل/الاستدلال + عدد الرموز المميزة + التسليم.
- الإدخال: محرر نصوص مع الإكمال التلقائي.
النموذج الذهني: وكلاء + جلسات
- الوكلاء هي سلاجات فريدة (مثل
main،research). تعرض البوابة القائمة. - الجلسات تابعة للوكيل الحالي.
- تُخزن مفاتيح الجلسات كـ
agent:<agentId>:<sessionKey>.- إذا كتبت
/session main، تقوم واجهة المستخدم النصية (TUI) بتوسيعها إلىagent:<currentAgent>:main. - إذا كتبت
/session agent:other:main، تنتقل إلى جلسة ذلك الوكيل بشكل صريح.
- إذا كتبت
- نطاق الجلسة:
per-sender(الافتراضي): لكل وكيل العديد من الجلسات.global: تستخدم واجهة المستخدم النصية (TUI) دائمًا جلسةglobal(قد يكون منتقي الجلسات فارغًا).
- الوكيل الحالي + الجلسة الحالية مرئيان دائمًا في التذييل.
الإرسال + التسليم
- تُرسل الرسائل إلى البوابة؛ التسليم إلى مقدمي الخدمة معطل بشكل افتراضي.
- قم بتشغيل التسليم:
/deliver on- أو من خلال لوحة الإعدادات
- أو ابدأ بـ
openclaw tui --deliver
منتقي القوائم + الطبقات المنبثقة
- منتقي النماذج: يعرض النماذج المتاحة ويحدد تجاوز الجلسة.
- منتقي الوكلاء: اختر وكيلًا مختلفًا.
- منتقي الجلسات: يعرض فقط جلسات الوكيل الحالي.
- الإعدادات: تبديل التسليم، توسيع إخراج الأداة، ووضوح التفكير.
اختصارات لوحة المفاتيح
- Enter: إرسال الرسالة
- Esc: إحباط التشغيل النشط
- Ctrl+C: مسح الإدخال (اضغط مرتين للخروج)
- Ctrl+D: خروج
- Ctrl+L: منتقي النماذج
- Ctrl+G: منتقي الوكلاء
- Ctrl+P: منتقي الجلسات
- Ctrl+O: تبديل توسيع إخراج الأداة
- Ctrl+T: تبديل وضوح التفكير (يعيد تحميل السجل)
أوامر الشرطة المائلة
الأساسية:
/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
يتم توجيه أوامر الشرطة المائلة الأخرى للبوابة (على سبيل المثال، /context) إلى البوابة وعرضها كمخرجات نظام. راجع أوامر الشرطة المائلة.
أوامر الطرفية المحلية
- ابدأ السطر بـ
!لتشغيل أمر طرفية محلي على مضيف واجهة المستخدم النصية (TUI). - تطلب واجهة المستخدم النصية (TUI) مرة واحدة لكل جلسة للسماح بالتنفيذ المحلي؛ رفض الطلب يحافظ على تعطيل
!للجلسة. - تُنفذ الأوامر في طرفية جديدة غير تفاعلية في دليل عمل واجهة المستخدم النصية (TUI) (لا يوجد
cd/env مستمر). - تتلقى أوامر الطرفية المحلية
OPENCLAW_SHELL=tui-localفي بيئتها. - يُرسل
!وحده كرسالة عادية؛ المسافات البادئة لا تُشغل التنفيذ المحلي.
إخراج الأداة
- تظهر استدعاءات الأداة كبطاقات تحتوي على وسيطات + نتائج.
- Ctrl+O يبدل بين العرض المطوي/الموسع.
- أثناء تشغيل الأدوات، تتدفق التحديثات الجزئية إلى نفس البطاقة.
السجل + البث
- عند الاتصال، تقوم واجهة المستخدم النصية (TUI) بتحميل أحدث السجل (افتراضيًا 200 رسالة).
- يتم تحديث الردوات التي يتم بثها في مكانها حتى يتم إنهاؤها.
- تستمع واجهة المستخدم النصية (TUI) أيضًا إلى أحداث أداة الوكيل للحصول على بطاقات أدوات أكثر ثراءً.
تفاصيل الاتصال
- تسجل واجهة المستخدم النصية (TUI) نفسها مع البوابة كـ
mode: "tui". - تظهر عمليات إعادة الاتصال رسالة نظام؛ يتم عرض الفجوات في الأحداث في السجل.
الخيارات
--url <url>: عنوان URL لـ WebSocket الخاص بالبوابة (الافتراضي هو التكوين أوws://127.0.0.1:<port>)--token <token>: رمز البوابة (إذا كان مطلوبًا)--password <password>: كلمة مرور البوابة (إذا كانت مطلوبة)--session <key>: مفتاح الجلسة (الافتراضي:main، أوglobalعندما يكون النطاق عامًا)--deliver: تسليم ردود المساعد إلى مقدم الخدمة (معطل افتراضيًا)--thinking <level>: تجاوز مستوى التفكير للإرسالات--timeout-ms <ms>: مهلة الوكيل بالمللي ثانية (الافتراضي هوagents.defaults.timeoutSeconds)
ملاحظة: عند تعيين --url، لا تعود واجهة المستخدم النصية (TUI) إلى بيانات اعتماد التكوين أو البيئة. قم بتمرير --token أو --password بشكل صريح. عدم وجود بيانات اعتماد صريحة يعتبر خطأ.
استكشاف الأخطاء وإصلاحها
لا يوجد إخراج بعد إرسال رسالة:
- قم بتشغيل
/statusفي واجهة المستخدم النصية (TUI) للتأكد من أن البوابة متصلة وخاملة/مشغولة. - تحقق من سجلات البوابة:
openclaw logs --follow. - تأكد من قدرة الوكيل على التشغيل:
openclaw statusوopenclaw models status. - إذا كنت تتوقع رسائل في قناة دردشة، قم بتمكين التسليم (
/deliver onأو--deliver). --history-limit <n>: عدد إدخالات السجل المراد تحميلها (الافتراضي 200)
استكشاف أخطاء الاتصال وإصلاحها
disconnected: تأكد من أن البوابة قيد التشغيل وأن--url/--token/--passwordالخاصة بك صحيحة.- لا توجد وكلاء في المنتقي: تحقق من
openclaw agents listوتكوين التوجيه الخاص بك. - منتقي الجلسات فارغ: قد تكون في نطاق عام أو ليس لديك جلسات بعد.