> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TUI

# `openclaw tui`

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

ذات صلة:

* دليل TUI: [TUI](/ar/web/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 غير مشارك.
* تظهر [أهداف](/ar/tools/goal) الجلسة في التذييل ويمكن إدارتها باستخدام `/goal`.

## أمثلة

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw chat
openclaw tui --local
openclaw tui
openclaw tui --url ws://127.0.0.1:18789 --token <token>
openclaw tui --session main --deliver
openclaw chat --message "Compare my config to the docs and tell me what to fix"
# when run inside an agent workspace, infers that agent automatically
openclaw tui --session bugfix
```

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

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw chat
```

ثم داخل TUI:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
!openclaw config file
!openclaw docs gateway auth token secretref
!openclaw config validate
!openclaw doctor
```

طبّق إصلاحات مستهدفة باستخدام `openclaw config set` أو `openclaw configure`، ثم
أعد تشغيل `openclaw config validate`. راجع [TUI](/ar/web/tui) و[الإعدادات](/ar/cli/config).

## ذات صلة

* [مرجع CLI](/ar/cli)
* [TUI](/ar/web/tui)
* [الهدف](/ar/tools/goal)