openclaw models

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

ذات صلة:

• المزوّدون + النماذج: النماذج
• مفاهيم اختيار النموذج + أمر الشرطة المائلة /models: مفهوم النماذج
• إعداد مصادقة المزوّد: البدء

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

openclaw models statusopenclaw models listopenclaw models set <model-or-alias>openclaw models scan

يعرض openclaw models status الاحتياطيات/الافتراضي المحلول مع نظرة عامة على المصادقة. عندما تكون لقطات استخدام المزوّدين متاحة، يتضمن قسم حالة OAuth/API-key نوافذ استخدام المزوّدين ولقطات الحصص. مزوّدو نوافذ الاستخدام الحاليون: Anthropic وGitHub Copilot وGemini CLI وOpenAI وMiniMax وXiaomi وz.ai. تأتي مصادقة الاستخدام من خطافات خاصة بالمزوّدين عند توفرها؛ وإلا يعود OpenClaw إلى مطابقة بيانات اعتماد OAuth/API-key من ملفات تعريف المصادقة أو env أو التكوين. في مخرج --json، يكون auth.providers هو النظرة العامة للمزوّد الواعية بـ env/config/store، بينما يكون auth.oauth صحة ملفات تعريف مخزن المصادقة فقط. أضف --probe لتشغيل فحوصات مصادقة حية على كل ملف تعريف مزوّد مكوّن. الفحوصات هي طلبات حقيقية (قد تستهلك رموزا وتؤدي إلى حدود معدل). استخدم --agent <id> لفحص حالة نموذج/مصادقة وكيل مكوّن. عند حذفه، يستخدم الأمر OPENCLAW_AGENT_DIR إذا كان مضبوطا، وإلا يستخدم الوكيل الافتراضي المكوّن. يمكن أن تأتي صفوف الفحص من ملفات تعريف المصادقة أو بيانات اعتماد env أو models.json. لاستكشاف أخطاء OAuth في OpenAI ChatGPT/Codex، تعد openclaw models status وopenclaw models auth list --provider openai و openclaw config get agents.defaults.model --json أسرع طريقة لتأكيد ما إذا كان لدى الوكيل ملف تعريف OAuth صالحا لـ openai من أجل openai/* عبر وقت تشغيل Codex الأصلي. راجع إعداد مزوّد OpenAI.

ملاحظات:

• يقبل models set <model-or-alias> صيغة provider/model أو اسما مستعارا.
• models list للقراءة فقط: يقرأ التكوين وملفات تعريف المصادقة وحالة الفهرس الحالية وصفوف الفهرس المملوكة للمزوّدين، لكنه لا يعيد كتابة models.json.
• عمود Auth على مستوى المزوّد وللقراءة فقط. يتم حسابه من بيانات تعريف ملف تعريف المصادقة المحلية، وعلامات env، ومفاتيح المزوّدين المكوّنة، وعلامات المزوّدين المحليين، وعلامات env/profile الخاصة بـ AWS Bedrock، وبيانات تعريف المصادقة الاصطناعية الخاصة بالـ Plugin؛ ولا يحمّل وقت تشغيل المزوّد، ولا يقرأ أسرار keychain، ولا يستدعي واجهات API للمزوّدين، ولا يثبت الجاهزية الدقيقة للتنفيذ لكل نموذج.
• يمكن أن يتضمن models list --all --provider <id> صفوف فهرس ثابتة مملوكة للمزوّد من بيانات Plugin manifests أو بيانات تعريف فهرس المزوّد المضمّن حتى عندما لا تكون قد صادقت مع ذلك المزوّد بعد. تظل تلك الصفوف تظهر على أنها غير متاحة حتى يتم تكوين مصادقة مطابقة.
• يحافظ models list على استجابة مستوى التحكم أثناء بطء اكتشاف فهرس المزوّد. تعود العروض الافتراضية والمكوّنة إلى صفوف نماذج مكوّنة أو اصطناعية بعد انتظار قصير وتترك الاكتشاف ينتهي في الخلفية. استخدم --all عندما تحتاج إلى الفهرس المكتشف الكامل الدقيق وتكون مستعدا لانتظار اكتشاف المزوّد.
• يدمج models list --all الواسع صفوف فهرس manifest فوق صفوف السجل من دون تحميل خطافات تكميلية لوقت تشغيل المزوّد. تستخدم المسارات السريعة لبيانات manifest المفلترة حسب المزوّد فقط المزوّدين الموسومين static؛ أما المزوّدون الموسومون refreshable فيبقون مدعومين بالسجل/الذاكرة المخبأة ويلحقون صفوف manifest كملحقات، بينما يبقى المزوّدون الموسومون runtime على اكتشاف السجل/وقت التشغيل.
• يحافظ models list على فصل بيانات تعريف النموذج الأصلية وحدود وقت التشغيل. في مخرج الجدول، يعرض Ctx القيمة contextTokens/contextWindow عندما يختلف حد وقت التشغيل الفعال عن نافذة السياق الأصلية؛ وتتضمن صفوف JSON القيمة contextTokens عندما يكشف المزوّد ذلك الحد.
• يرشح models list --provider <id> حسب معرف المزوّد، مثل moonshot أو openai. لا يقبل تسميات العرض من ملتقطات المزوّدين التفاعلية، مثل 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 (exit 1=expired/missing, 2=expiring)
• --probe (فحص حي لملفات تعريف المصادقة المكوّنة)
• --probe-provider <name> (فحص مزوّد واحد)
• --probe-profile <id> (معرفات ملفات تعريف مكررة أو مفصولة بفواصل)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id> (معرف الوكيل المكوّن؛ يتجاوز OPENCLAW_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 لم يستطع حل مرشح نموذج قابل للفحص لذلك المزوّد.

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

openclaw models aliases listopenclaw models fallbacks list

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

openclaw models auth addopenclaw models auth list [--provider <id>] [--json]openclaw models auth login --provider <id>openclaw models auth login --provider openai --profile-id openai:workopenclaw models auth paste-api-key --provider <id>openclaw models auth setup-token --provider <id>openclaw models auth paste-token

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

يسرد models auth list ملفات تعريف المصادقة المحفوظة للوكيل المحدد من دون طباعة الرمز أو API-key أو مادة سر OAuth. استخدم --provider <id> للتصفية إلى مزوّد واحد، مثل openai، و--json للبرمجة النصية.

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

بالنسبة إلى نماذج OpenAI، يكون --provider openai افتراضيا تسجيل دخول حساب ChatGPT/Codex. استخدم --method api-key فقط عندما تريد إضافة ملف تعريف API-key لـ OpenAI، عادة كنسخة احتياطية لحدود اشتراك Codex. شغل openclaw doctor --fix لترحيل حالة المصادقة/ملف التعريف القديمة ذات بادئة OpenAI Codex إلى openai.

أمثلة:

openclaw models auth login --provider openai --set-defaultopenclaw models auth login --provider openai --method api-keyopenclaw models auth paste-api-key --provider openaiopenclaw models auth list --provider openai

ملاحظات:

• يقبل login الخيار --profile-id <id> للمزوّدين الذين يدعمون ملفات تعريف مسماة أثناء تسجيل الدخول. استخدم هذا لإبقاء عمليات تسجيل الدخول المتعددة للمزوّد نفسه منفصلة.
• يقبل paste-api-key مفاتيح API المنشأة في مكان آخر، ويطلب قيمة المفتاح، ويكتبها إلى معرف ملف التعريف الافتراضي <provider>:manual ما لم تمرر --profile-id. في الأتمتة، مرر المفتاح عبر stdin، على سبيل المثال printf "%s\n" "$OPENAI_API_KEY" | openclaw models auth paste-api-key --provider openai.
• يظل setup-token وpaste-token أوامر رموز عامة للمزوّدين الذين يكشفون طرق مصادقة بالرموز.
• يتطلب setup-token واجهة TTY تفاعلية ويشغل طريقة مصادقة الرموز الخاصة بالمزوّد (مع الافتراض إلى طريقة setup-token الخاصة بذلك المزوّد عندما يكشف واحدة).
• يقبل paste-token سلسلة رمز منشأة في مكان آخر أو من الأتمتة.
• يتطلب paste-token الخيار --provider، ويطلب قيمة الرمز افتراضيا، ويكتبها إلى معرف ملف التعريف الافتراضي <provider>:manual ما لم تمرر --profile-id.
• في الأتمتة، مرر الرمز عبر stdin بدلا من تمريره كوسيط حتى لا تظهر بيانات اعتماد المزوّد في سجل shell أو قوائم العمليات.
• يخزن paste-token --expires-in <duration> انتهاء صلاحية مطلقا للرمز من مدة نسبية مثل 365d أو 12h.
• بالنسبة إلى openai، تختلف مفاتيح API الخاصة بـ OpenAI ومادة رمز ChatGPT/OAuth كأشكال مصادقة. استخدم paste-api-key لمفاتيح API الخاصة بـ OpenAI بصيغة sk-... وpaste-token فقط لمادة مصادقة الرموز.
• ملاحظة Anthropic: أخبرنا موظفو Anthropic أن استخدام Claude CLI بنمط OpenClaw مسموح به مرة أخرى، لذلك يتعامل OpenClaw مع إعادة استخدام Claude CLI واستخدام claude -p على أنهما معتمدان لهذا التكامل ما لم تنشر Anthropic سياسة جديدة.
• يظل Anthropic setup-token / paste-token متاحين كمسار رموز OpenClaw مدعوم، لكن OpenClaw يفضل الآن إعادة استخدام Claude CLI وclaude -p عند توفرهما.

ذات صلة

• مرجع CLI
• اختيار النموذج
• تجاوز فشل النموذج