---
read_when:
    - تريد واجهة مستخدم طرفية لـ Gateway (ملائمة للاستخدام عن بُعد)
    - تريد تمرير url/token/session من السكربتات
    - تريد تشغيل TUI في الوضع المضمّن المحلي بدون Gateway
    - تريد استخدام openclaw chat أو openclaw tui --local
summary: مرجع CLI لـ `openclaw tui` (مدعومة بـ Gateway أو واجهة مستخدم طرفية مضمّنة محلية)
title: TUI
x-i18n:
    generated_at: "2026-05-10T19:32:45Z"
    model: gpt-5.5
    provider: openai
    source_hash: 3e59f0f5360a456d19cfee38adc540b27665c55de68480616f269d1088f13677
    source_path: cli/tui.md
    workflow: 16
---

# `openclaw tui`

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

ذات صلة:

- دليل TUI: [TUI](/ar/web/tui)

## الخيارات

| العلم                 | الافتراضي                                | الوصف                                                                              |
| --------------------- | ----------------------------------------- | ---------------------------------------------------------------------------------- |
| `--local`             | `false`                                   | التشغيل مقابل وقت تشغيل الوكيل المحلي المضمّن بدلًا من Gateway.                  |
| `--url <url>`         | `gateway.remote.url` من الإعداد           | عنوان URL لـ WebSocket الخاص بـ Gateway.                                          |
| `--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 فقط غير متاحة.
- يضيف الوضع المحلي `/auth [provider]` داخل سطح أوامر TUI.
- تظل بوابات موافقة Plugin مطبقة في الوضع المحلي. الأدوات التي تتطلب الموافقة تطلب قرارًا في الطرفية؛ لا تتم الموافقة التلقائية بصمت على أي شيء لمجرد أن Gateway غير مشارك.

## أمثلة

```bash
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
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](/ar/web/tui) و[الإعداد](/ar/cli/config).

## ذات صلة

- [مرجع CLI](/ar/cli)
- [TUI](/ar/web/tui)