---
read_when:
    - تريد جولة إرشادية مناسبة للمبتدئين حول TUI
    - تحتاج إلى القائمة الكاملة لميزات TUI وأوامره واختصاراته
summary: 'واجهة المستخدم الطرفية (TUI): الاتصال بـ Gateway أو التشغيل محليًا في الوضع المضمّن'
title: TUI
x-i18n:
    generated_at: "2026-05-06T08:19:44Z"
    model: gpt-5.5
    provider: openai
    source_hash: 2b517ff434cc440aeffd8698df75d4d85c22a19e59b38a1f2383e58e1b4084ff
    source_path: web/tui.md
    workflow: 16
---

## البدء السريع

### وضع Gateway

1. ابدأ تشغيل Gateway.

```bash
openclaw gateway
```

2. افتح TUI.

```bash
openclaw tui
```

3. اكتب رسالة واضغط Enter.

Gateway البعيد:

```bash
openclaw tui --url ws://<host>:<port> --token <gateway-token>
```

استخدم `--password` إذا كان Gateway لديك يستخدم مصادقة كلمة المرور.

### الوضع المحلي

شغّل TUI من دون Gateway:

```bash
openclaw chat
# or
openclaw tui --local
```

ملاحظات:

- `openclaw chat` و`openclaw terminal` اسمان بديلان لـ `openclaw tui --local`.
- لا يمكن دمج `--local` مع `--url` أو `--token` أو `--password`.
- يستخدم الوضع المحلي وقت تشغيل الوكيل المضمّن مباشرة. تعمل معظم الأدوات المحلية، لكن الميزات الخاصة بـ Gateway فقط غير متاحة.
- يستخدم `openclaw` و`openclaw crestodian` أيضًا صدفة TUI هذه، مع Crestodian كواجهة خلفية محلية لمحادثة الإعداد والإصلاح.

## ما تراه

- الرأس: عنوان URL للاتصال، الوكيل الحالي، الجلسة الحالية.
- سجل المحادثة: رسائل المستخدم، ردود المساعد، إشعارات النظام، بطاقات الأدوات.
- سطر الحالة: حالة الاتصال/التشغيل (جارٍ الاتصال، قيد التشغيل، جارٍ البث، خامل، خطأ).
- التذييل: حالة الاتصال + الوكيل + الجلسة + النموذج + think/fast/verbose/trace/reasoning + عدادات الرموز + التسليم.
- الإدخال: محرر نصوص مع إكمال تلقائي.

## النموذج الذهني: الوكلاء + الجلسات

- الوكلاء هم معرّفات فريدة مختصرة (مثل `main` و`research`). يعرِض Gateway القائمة.
- تنتمي الجلسات إلى الوكيل الحالي.
- تُخزَّن مفاتيح الجلسات بصيغة `agent:<agentId>:<sessionKey>`.
  - إذا كتبت `/session main`، يوسّعها TUI إلى `agent:<currentAgent>:main`.
  - إذا كتبت `/session agent:other:main`، تنتقل صراحةً إلى جلسة ذلك الوكيل.
- نطاق الجلسة:
  - `per-sender` (الافتراضي): لكل وكيل جلسات كثيرة.
  - `global`: يستخدم TUI دائمًا جلسة `global` (قد يكون المنتقي فارغًا).
- يكون الوكيل الحالي + الجلسة الحالية مرئيين دائمًا في التذييل.
- عند البدء من دون `--session`، يستأنف TUI في وضع Gateway آخر جلسة محددة لنفس Gateway والوكيل ونطاق الجلسة إذا كانت تلك الجلسة لا تزال موجودة. يظل تمرير `--session` أو `/session` أو `/new` أو `/reset` إجراءً صريحًا.

## الإرسال + التسليم

- تُرسل الرسائل إلى Gateway؛ ويكون التسليم إلى المزوّدين متوقفًا افتراضيًا.
- فعّل التسليم:
  - `/deliver on`
  - أو من لوحة الإعدادات
  - أو ابدأ باستخدام `openclaw tui --deliver`

## المنتقيات + الطبقات المتراكبة

- منتقي النموذج: يعرض النماذج المتاحة ويضبط تجاوز الجلسة.
- منتقي الوكيل: اختر وكيلاً مختلفًا.
- منتقي الجلسة: يعرض حتى 50 جلسة للوكيل الحالي تم تحديثها خلال آخر 7 أيام. استخدم `/session <key>` للانتقال إلى جلسة أقدم معروفة.
- الإعدادات: بدّل التسليم، وتوسيع مخرجات الأدوات، وإظهار التفكير.

## اختصارات لوحة المفاتيح

- 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>`
- `/fast <status|on|off>`
- `/verbose <on|full|off>`
- `/trace <on|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`

الوضع المحلي فقط:

- يفتح `/auth [provider]` تدفق مصادقة/تسجيل دخول المزوّد داخل TUI.

تُمرَّر أوامر الشرطة المائلة الأخرى الخاصة بـ Gateway (على سبيل المثال، `/context`) إلى Gateway وتُعرَض كمخرجات نظام. راجع [أوامر الشرطة المائلة](/ar/tools/slash-commands).

## أوامر الصدفة المحلية

- ابدأ السطر بـ `!` لتشغيل أمر صدفة محلي على مضيف TUI.
- يطلب TUI مرة واحدة في كل جلسة السماح بالتنفيذ المحلي؛ يؤدي الرفض إلى إبقاء `!` معطّلة في الجلسة.
- تعمل الأوامر في صدفة جديدة غير تفاعلية في دليل عمل TUI (لا يوجد `cd`/env دائم).
- تتلقى أوامر الصدفة المحلية `OPENCLAW_SHELL=tui-local` في بيئتها.
- تُرسل `!` وحدها كرسالة عادية؛ ولا تؤدي المسافات البادئة إلى تشغيل التنفيذ المحلي.

## إصلاح الإعدادات من TUI المحلي

استخدم الوضع المحلي عندما يكون الإعداد الحالي صالحًا بالفعل وتريد من
الوكيل المضمّن فحصه على الجهاز نفسه، ومقارنته بالوثائق،
والمساعدة في إصلاح الانحراف من دون الاعتماد على Gateway قيد التشغيل.

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

حلقة نموذجية:

1. ابدأ الوضع المحلي:

```bash
openclaw chat
```

2. اطلب من الوكيل ما تريد فحصه، على سبيل المثال:

```text
Compare my gateway auth config with the docs and suggest the smallest fix.
```

3. استخدم أوامر الصدفة المحلية للحصول على أدلة دقيقة والتحقق:

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

4. طبّق تغييرات محدودة باستخدام `openclaw config set` أو `openclaw configure`، ثم أعد تشغيل `!openclaw config validate`.
5. إذا أوصى Doctor بترحيل أو إصلاح تلقائي، فراجعه وشغّل `!openclaw doctor --fix`.

نصائح:

- فضّل `openclaw config set` أو `openclaw configure` على تعديل `openclaw.json` يدويًا.
- يبحث `openclaw docs "<query>"` في فهرس الوثائق الحية من الجهاز نفسه.
- يكون `openclaw config validate --json` مفيدًا عندما تريد أخطاء مخطط وبنية SecretRef وإمكانية حلها بصيغة منظمة.

## مخرجات الأدوات

- تظهر استدعاءات الأدوات كبطاقات تتضمن الوسائط + النتائج.
- يبدّل Ctrl+O بين العروض المطوية/الموسّعة.
- أثناء تشغيل الأدوات، تُبث التحديثات الجزئية داخل البطاقة نفسها.

## ألوان الطرفية

- يُبقي TUI نص جسم المساعد بلون المقدمة الافتراضي في طرفيتك حتى تظل الطرفيات الداكنة والفاتحة قابلة للقراءة.
- إذا كانت طرفيتك تستخدم خلفية فاتحة وكان الاكتشاف التلقائي خاطئًا، فاضبط `OPENCLAW_THEME=light` قبل تشغيل `openclaw tui`.
- لفرض اللوحة الداكنة الأصلية بدلًا من ذلك، اضبط `OPENCLAW_THEME=dark`.

## السجل + البث

- عند الاتصال، يحمّل TUI أحدث سجل (الافتراضي 200 رسالة).
- تُحدّث الاستجابات المتدفقة في موضعها حتى تكتمل.
- يستمع TUI أيضًا إلى أحداث أدوات الوكيل لتقديم بطاقات أدوات أغنى.

## تفاصيل الاتصال

- يسجّل TUI نفسه لدى Gateway باسم `mode: "tui"`.
- تعرض عمليات إعادة الاتصال رسالة نظام؛ وتظهر فجوات الأحداث في السجل.

## الخيارات

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

<Warning>
عند ضبط `--url`، لا يعود TUI إلى بيانات اعتماد الإعداد أو البيئة. مرّر `--token` أو `--password` صراحةً. يُعد فقدان بيانات الاعتماد الصريحة خطأ. في الوضع المحلي، لا تمرّر `--url` أو `--token` أو `--password`.
</Warning>

## استكشاف الأخطاء وإصلاحها

لا توجد مخرجات بعد إرسال رسالة:

- شغّل `/status` في TUI للتأكد من أن Gateway متصل وخامل/مشغول.
- تحقق من سجلات Gateway: `openclaw logs --follow`.
- تأكد من أن الوكيل يمكنه العمل: `openclaw status` و`openclaw models status`.
- إذا كنت تتوقع رسائل في قناة محادثة، ففعّل التسليم (`/deliver on` أو `--deliver`).

## استكشاف مشكلات الاتصال وإصلاحها

- `disconnected`: تأكد من أن Gateway قيد التشغيل وأن `--url/--token/--password` صحيحة.
- لا توجد وكلاء في المنتقي: تحقق من `openclaw agents list` وإعداد التوجيه لديك.
- منتقي الجلسات فارغ: قد تكون في نطاق عام أو لا توجد لديك جلسات بعد.

## ذات صلة

- [واجهة التحكم](/ar/web/control-ui) — واجهة تحكم مستندة إلى الويب
- [الإعداد](/ar/cli/config) — فحص `openclaw.json` والتحقق منه وتعديله
- [Doctor](/ar/cli/doctor) — إصلاح موجّه وفحوصات الترحيل
- [مرجع CLI](/ar/cli) — مرجع كامل لأوامر CLI