---
read_when:
    - تريد تغيير النماذج الافتراضية أو عرض حالة مصادقة المزوّد
    - تريد فحص النماذج/المزوّدين المتاحين وتصحيح أخطاء ملفات تعريف المصادقة
summary: مرجع CLI لـ `openclaw models` (status/list/set/scan، الأسماء المستعارة، آليات الرجوع الاحتياطي، المصادقة)
title: النماذج
x-i18n:
    generated_at: "2026-05-01T07:37:56Z"
    model: gpt-5.5
    provider: openai
    source_hash: 538d3e4808329737fdc044dc6e14e5c7c78052e75d8a8b3b257b1ebd821c84d1
    source_path: cli/models.md
    workflow: 16
---

# `openclaw models`

اكتشاف النماذج وفحصها وتكوينها (النموذج الافتراضي، الاحتياطيات، ملفات تعريف المصادقة).

ذات صلة:

- المزوّدون + النماذج: [النماذج](/ar/providers/models)
- مفاهيم اختيار النموذج + أمر الشرطة المائلة `/models`: [مفهوم النماذج](/ar/concepts/models)
- إعداد مصادقة المزوّد: [بدء الاستخدام](/ar/start/getting-started)

## الأوامر الشائعة

```bash
openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan
```

يعرض `openclaw models status` القيم المحلولة للافتراضي/الاحتياطيات إضافة إلى نظرة عامة على المصادقة.
عندما تكون لقطات استخدام المزوّدين متاحة، يتضمن قسم حالة OAuth/مفتاح API
نوافذ استخدام المزوّدين ولقطات الحصص.
مزوّدو نوافذ الاستخدام الحاليون: Anthropic، وGitHub Copilot، وGemini CLI، وOpenAI
Codex، وMiniMax، وXiaomi، وz.ai. تأتي مصادقة الاستخدام من خطافات خاصة بكل مزوّد
عندما تكون متاحة؛ وإلا يعود OpenClaw إلى بيانات اعتماد OAuth/مفتاح API
المطابقة من ملفات تعريف المصادقة أو البيئة أو التكوين.
في خرج `--json`، تكون `auth.providers` هي النظرة العامة للمزوّد
الواعية بالبيئة/التكوين/المخزن، بينما تكون `auth.oauth` هي صحة ملف تعريف مخزن المصادقة فقط.
أضف `--probe` لتشغيل فحوصات مصادقة حية على كل ملف تعريف مزوّد مكوّن.
الفحوصات طلبات حقيقية (قد تستهلك الرموز وتطلق حدود المعدل).
استخدم `--agent <id>` لفحص حالة النموذج/المصادقة لوكيل مكوّن. عند حذفه،
يستخدم الأمر `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR` إذا كان مضبوطا، وإلا يستخدم
الوكيل الافتراضي المكوّن.
يمكن أن تأتي صفوف الفحص من ملفات تعريف المصادقة أو بيانات اعتماد البيئة أو `models.json`.

ملاحظات:

- يقبل `models set <model-or-alias>` الصيغة `provider/model` أو اسما مستعارا.
- `models list` للقراءة فقط: يقرأ التكوين وملفات تعريف المصادقة وحالة الفهرس
  الحالية وصفوف الفهرس المملوكة للمزوّد، لكنه لا يعيد كتابة
  `models.json`.
- عمود `Auth` على مستوى المزوّد وللقراءة فقط. يتم حسابه من بيانات تعريف ملف
  تعريف المصادقة المحلي، وعلامات البيئة، ومفاتيح المزوّد المكوّنة، وعلامات المزوّد المحلي،
  وعلامات بيئة/ملف تعريف AWS Bedrock، وبيانات تعريف المصادقة الاصطناعية في Plugin؛
  ولا يحمّل وقت تشغيل المزوّد، ولا يقرأ أسرار keychain، ولا يستدعي واجهات API
  الخاصة بالمزوّدين، ولا يثبت جاهزية التنفيذ الدقيقة لكل نموذج.
- يمكن أن يتضمن `models list --all --provider <id>` صفوف فهرس ثابتة مملوكة للمزوّد
  من بيانات Plugin أو بيانات تعريف فهرس المزوّدين المضمّنين حتى عندما لا تكون
  قد صادقت مع ذلك المزوّد بعد. تظل تلك الصفوف تظهر على أنها غير متاحة
  حتى يتم تكوين المصادقة المطابقة.
- يحافظ `models list` على استجابة مستوى التحكم أثناء بطء اكتشاف فهرس المزوّدين.
  تعود العروض الافتراضية والمكوّنة إلى صفوف النماذج المكوّنة أو الاصطناعية
  بعد انتظار قصير وتترك الاكتشاف ينتهي في الخلفية. استخدم `--all` عندما تحتاج
  إلى الفهرس المكتشف الكامل والدقيق وتكون مستعدا لانتظار اكتشاف المزوّد.
- يدمج `models list --all` الواسع صفوف فهرس البيان فوق صفوف السجل
  من دون تحميل خطافات الإكمال وقت تشغيل المزوّد. تستخدم المسارات السريعة لبيانات البيان
  المصفاة حسب المزوّد المزوّدين المعلّمين `static` فقط؛ ويبقى المزوّدون المعلّمون
  `refreshable` مدعومين بالسجل/الذاكرة المؤقتة وتضاف صفوف البيان كإضافات، بينما
  يبقى المزوّدون المعلّمون `runtime` على اكتشاف السجل/وقت التشغيل.
- يحافظ `models list` على فصل بيانات تعريف النموذج الأصلية عن حدود وقت التشغيل. في خرج الجدول،
  يعرض `Ctx` القيمة `contextTokens/contextWindow` عندما يختلف حد وقت التشغيل الفعلي
  عن نافذة السياق الأصلية؛ وتتضمن صفوف JSON القيمة `contextTokens`
  عندما يعرّض المزوّد ذلك الحد.
- يرشح `models list --provider <id>` حسب معرّف المزوّد، مثل `moonshot` أو
  `openai-codex`. ولا يقبل تسميات العرض من منتقيات المزوّد التفاعلية،
  مثل `Moonshot AI`.
- يتم تحليل مراجع النماذج بالتقسيم عند أول `/`. إذا كان معرّف النموذج يتضمن `/` (على نمط OpenRouter)، فأدرج بادئة المزوّد (مثال: `openrouter/moonshotai/kimi-k2`).
- إذا حذفت المزوّد، يحل OpenClaw الإدخال كاسم مستعار أولا، ثم
  كمطابقة فريدة لمزوّد مكوّن لذلك المعرّف الدقيق للنموذج، وبعد ذلك فقط
  يعود إلى المزوّد الافتراضي المكوّن مع تحذير إيقاف. إذا لم يعد ذلك المزوّد
  يعرّض النموذج الافتراضي المكوّن، يعود OpenClaw إلى أول مزوّد/نموذج مكوّن
  بدلا من إظهار افتراضي قديم لمزوّد محذوف.
- قد يعرض `models status` القيمة `marker(<value>)` في خرج المصادقة للعناصر النائبة غير السرية (على سبيل المثال `OPENAI_API_KEY`، و`secretref-managed`، و`minimax-oauth`، و`oauth:chutes`، و`ollama-local`) بدلا من إخفائها كأسرار.

### فحص النماذج

يقرأ `models scan` فهرس OpenRouter العام `:free` ويرتب المرشحين
للاستخدام الاحتياطي. الفهرس نفسه عام، لذلك لا تحتاج الفحوصات المعتمدة على بيانات التعريف فقط
إلى مفتاح OpenRouter.

يحاول OpenClaw افتراضيا فحص دعم الأدوات والصور باستدعاءات نماذج حية.
إذا لم يتم تكوين مفتاح OpenRouter، يعود الأمر إلى خرج بيانات التعريف فقط
ويوضح أن نماذج `:free` لا تزال تتطلب `OPENROUTER_API_KEY`
للفحوصات والاستدلال.

الخيارات:

- `--no-probe` (بيانات التعريف فقط؛ بلا بحث في التكوين/الأسرار)
- `--min-params <b>`
- `--max-age-days <days>`
- `--provider <name>`
- `--max-candidates <n>`
- `--timeout <ms>` (طلب الفهرس ومهلة كل فحص)
- `--concurrency <n>`
- `--yes`
- `--no-input`
- `--set-default`
- `--set-image`
- `--json`

يتطلب `--set-default` و`--set-image` فحوصات حية؛ نتائج الفحص المعتمدة على بيانات التعريف فقط
معلوماتية ولا تطبق على التكوين.

### حالة النماذج

الخيارات:

- `--json`
- `--plain`
- `--check` (يخرج 1=منتهي/مفقود، 2=قارب الانتهاء)
- `--probe` (فحص حي لملفات تعريف المصادقة المكوّنة)
- `--probe-provider <name>` (فحص مزوّد واحد)
- `--probe-profile <id>` (معرّفات ملفات تعريف مكررة أو مفصولة بفواصل)
- `--probe-timeout <ms>`
- `--probe-concurrency <n>`
- `--probe-max-tokens <n>`
- `--agent <id>` (معرّف وكيل مكوّن؛ يتجاوز `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`)

يبقي `--json` stdout مخصصا لحمولة JSON. يتم توجيه تشخيصات ملف تعريف المصادقة
والمزوّد وبدء التشغيل إلى stderr بحيث يمكن للسكربتات تمرير stdout مباشرة
إلى أدوات مثل `jq`.

حاويات حالة الفحص:

- `ok`
- `auth`
- `rate_limit`
- `billing`
- `timeout`
- `format`
- `unknown`
- `no_model`

حالات تفاصيل الفحص/رموز السبب المتوقعة:

- `excluded_by_auth_order`: يوجد ملف تعريف مخزن، لكن `auth.order.<provider>` الصريح
  حذفه، لذلك يبلغ الفحص عن الاستبعاد بدلا من
  تجربته.
- `missing_credential`، و`invalid_expires`، و`expired`، و`unresolved_ref`:
  ملف التعريف موجود لكنه غير مؤهل/غير قابل للحل.
- `no_model`: توجد مصادقة للمزوّد، لكن OpenClaw لم يتمكن من حل مرشح نموذج
  قابل للفحص لذلك المزوّد.

## الأسماء المستعارة + الاحتياطيات

```bash
openclaw models aliases list
openclaw models fallbacks list
```

## ملفات تعريف المصادقة

```bash
openclaw models auth add
openclaw models auth login --provider <id>
openclaw models auth setup-token --provider <id>
openclaw models auth paste-token
```

`models auth add` هو مساعد المصادقة التفاعلي. يمكنه تشغيل تدفق مصادقة مزوّد
(OAuth/مفتاح API) أو إرشادك إلى لصق الرمز يدويا، بحسب
المزوّد الذي تختاره.

يشغل `models auth login` تدفق مصادقة Plugin المزوّد (OAuth/مفتاح API). استخدم
`openclaw plugins list` لمعرفة المزوّدين المثبتين.
استخدم `openclaw models auth --agent <id> <subcommand>` لكتابة نتائج المصادقة إلى
مخزن وكيل مكوّن محدد. يتم احترام علم `--agent` الأصلي بواسطة
`add`، و`login`، و`setup-token`، و`paste-token`، و`login-github-copilot`.

أمثلة:

```bash
openclaw models auth login --provider openai-codex --set-default
```

ملاحظات:

- يظل `setup-token` و`paste-token` أمرين عامين للرموز للمزوّدين
  الذين يعرّضون طرق مصادقة بالرموز.
- يتطلب `setup-token` واجهة TTY تفاعلية ويشغل طريقة مصادقة الرمز الخاصة بالمزوّد
  (مع الرجوع افتراضيا إلى طريقة `setup-token` لذلك المزوّد عندما يعرّض
  واحدة).
- يقبل `paste-token` سلسلة رمز تم إنشاؤها في مكان آخر أو من الأتمتة.
- يتطلب `paste-token` الخيار `--provider`، ويطلب قيمة الرمز، ويكتبها
  إلى معرّف ملف التعريف الافتراضي `<provider>:manual` ما لم تمرر
  `--profile-id`.
- يخزن `paste-token --expires-in <duration>` انتهاء صلاحية مطلقا للرمز من
  مدة نسبية مثل `365d` أو `12h`.
- ملاحظة Anthropic: أخبرنا موظفو Anthropic أن استخدام Claude CLI بأسلوب OpenClaw مسموح به مرة أخرى، لذلك يتعامل OpenClaw مع إعادة استخدام Claude CLI واستخدام `claude -p` على أنهما معتمدان لهذا التكامل ما لم تنشر Anthropic سياسة جديدة.
- يظل Anthropic `setup-token` / `paste-token` متاحين كمسار رمز مدعوم في OpenClaw، لكن OpenClaw يفضل الآن إعادة استخدام Claude CLI و`claude -p` عندما يكونان متاحين.

## ذات صلة

- [مرجع CLI](/ar/cli)
- [اختيار النموذج](/ar/concepts/model-providers)
- [انتقال النموذج عند الفشل](/ar/concepts/model-failover)
