---
read_when:
    - عندما تريد شرحًا سهلًا للمبتدئين حول TUI
    - عندما تحتاج إلى القائمة الكاملة لميزات TUI وأوامرها واختصاراتها
summary: 'واجهة الطرفية (TUI): الاتصال بـ Gateway من أي جهاز'
title: TUI
x-i18n:
    generated_at: "2026-04-05T13:01:11Z"
    model: gpt-5.4
    provider: openai
    source_hash: a73f70d65ecc7bff663e8df28c07d70d2920d4732fbb8288c137d65b8653ac52
    source_path: web/tui.md
    workflow: 15
---

# TUI (واجهة الطرفية)

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

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 لديك يستخدم مصادقة كلمة المرور.

## ما الذي تراه

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

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

- الوكلاء هم معرّفات فريدة (مثل `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`

## أدوات الاختيار + التراكبات

- منتقي النموذج: يسرد النماذج المتاحة ويضبط تجاوز الجلسة.
- منتقي الوكيل: اختر وكيلًا مختلفًا.
- منتقي الجلسة: يعرض الجلسات الخاصة بالوكيل الحالي فقط.
- Settings: تبديل 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>`
- `/fast <status|on|off>`
- `/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 ‏(مثل `/context`) إلى Gateway وتُعرض كمخرجات نظام. راجع [أوامر الشرطة المائلة](/tools/slash-commands).

## أوامر shell المحلية

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

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

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

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

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

## السجل + التدفق

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

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

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

## الخيارات

- `--url <url>`: عنوان URL لـ Gateway WebSocket ‏(الافتراضي من التكوين أو `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`)

ملاحظة: عندما تضبط `--url`، لا تعود TUI إلى بيانات الاعتماد الموجودة في التكوين أو البيئة.
مرّر `--token` أو `--password` صراحةً. ويُعد غياب بيانات الاعتماد الصريحة خطأً.

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

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

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

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

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

## ذو صلة

- [Control UI](/web/control-ui) — واجهة تحكم قائمة على الويب
- [مرجع CLI](/cli) — المرجع الكامل لأوامر CLI
