CLI commands

TUI

openclaw tui

افتح واجهة الطرفية المتصلة بـ Gateway، أو شغّلها في وضع محلي مضمّن.

ذات صلة:

  • دليل TUI: TUI

الخيارات

العلم الافتراضي الوصف
--local false التشغيل مقابل وقت تشغيل الوكيل المحلي المضمّن بدلًا من Gateway.
--url <url> gateway.remote.url من الإعدادات عنوان URL لـ Gateway WebSocket.
--token <token> (لا شيء) رمز Gateway إذا كان مطلوبًا.
--password <pass> (لا شيء) كلمة مرور Gateway إذا كانت مطلوبة.
--session <key> main (أو global عندما يكون النطاق عامًا) مفتاح الجلسة. داخل مساحة عمل وكيل، يحدد ذلك الوكيل تلقائيًا ما لم تُستخدم بادئة.
--deliver false تسليم ردود المساعد عبر القنوات المضبوطة.
--thinking <level> (افتراضي النموذج) تجاوز مستوى التفكير.
--message <text> (لا شيء) إرسال رسالة أولية بعد الاتصال.
--timeout-ms <ms> agents.defaults.timeoutSeconds مهلة الوكيل. تسجل القيم غير الصالحة تحذيرًا ويتم تجاهلها.
--history-limit <n> 200 إدخالات السجل المراد تحميلها عند الإرفاق.

الأسماء المستعارة: يستدعي openclaw chat وopenclaw terminal الأمر نفسه مع تضمين --local ضمنيًا.

ملاحظات:

  • chat وterminal اسمان مستعاران لـ openclaw tui --local.
  • لا يمكن دمج --local مع --url أو --token أو --password.
  • يحل tui مراجع SecretRefs الخاصة بمصادقة Gateway المضبوطة لمصادقة الرمز/كلمة المرور عندما يكون ذلك ممكنًا (موفرو env/file/exec).
  • عند التشغيل من داخل دليل مساحة عمل وكيل مضبوط، يحدد TUI ذلك الوكيل تلقائيًا كافتراضي لمفتاح الجلسة (ما لم يكن --session صريحًا بصيغة agent:<id>:...).
  • لإظهار اسم مضيف Gateway في التذييل للاتصالات غير المحلية المدعومة بعنوان URL، شغّل openclaw config set tui.footer.showRemoteHost true. يكون وسم المضيف معطلًا افتراضيًا ولا يظهر أبدًا لاتصالات loopback أو الاتصالات المحلية المضمّنة.
  • يستخدم الوضع المحلي وقت تشغيل الوكيل المضمّن مباشرة. تعمل معظم الأدوات المحلية، لكن ميزات Gateway فقط غير متاحة.
  • يضيف الوضع المحلي /auth [provider] داخل سطح أوامر TUI.
  • تظل بوابات موافقة Plugin مطبقة في الوضع المحلي. الأدوات التي تتطلب موافقة تطلب قرارًا في الطرفية؛ لا تتم الموافقة على أي شيء تلقائيًا بصمت لأن Gateway غير مشارك.
  • تظهر أهداف الجلسة في التذييل ويمكن إدارتها باستخدام /goal.

أمثلة

bash
openclaw chatopenclaw tui --localopenclaw tuiopenclaw tui --url ws://127.0.0.1:18789 --token <token>openclaw tui --session main --deliveropenclaw chat --message "Compare my config to the docs and tell me what to fix"# when run inside an agent workspace, infers that agent automaticallyopenclaw tui --session bugfix

حلقة إصلاح الإعدادات

استخدم الوضع المحلي عندما تكون الإعدادات الحالية صالحة بالفعل وتريد من الوكيل المضمّن فحصها ومقارنتها بالوثائق والمساعدة في إصلاحها من الطرفية نفسها:

إذا كان openclaw config validate يفشل بالفعل، فاستخدم openclaw configure أو openclaw doctor --fix أولًا. لا يتجاوز openclaw chat حارس الإعدادات غير الصالحة.

bash
openclaw chat

ثم داخل TUI:

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

طبّق إصلاحات مستهدفة باستخدام openclaw config set أو openclaw configure، ثم أعد تشغيل openclaw config validate. راجع TUI والإعدادات.

ذات صلة

Was this useful?
On this page

On this page