مصادقة النماذج في OpenClaw

تفتتح الوثائق هذه الصفحة بملاحظة عن نطاقها تستحق التكرار: فهي تغطي مصادقة مزوّدي النماذج، أي مفاتيح API وOAuth وإعادة استخدام Claude CLI ورمز الإعداد من Anthropic، لا الرمز أو كلمة المرور التي تحمي اتصال Gateway. يدعم OpenClaw بروتوكول OAuth ومفاتيح API للمزوّدين، والتوصية واضحة: لمضيف Gateway يعمل دائمًا، مفتاح API هو الخيار الأكثر قابلية للتنبؤ، بينما تعمل مسارات الاشتراك وOAuth عندما تتوافق مع حسابك لدى المزوّد. إليك الإعداد الموصى به، ومساري Anthropic، وأين تحفظ بيانات الاعتماد، وكيف تتحقق منها، والتدوير، وكيف تختار بيانات الاعتماد التي تستخدمها الجلسة.

الإعداد الموصى به

• أنشئ مفتاحًا في وحدة تحكم المزوّد، وصدّره (export) على مضيف Gateway، أي الجهاز الذي يشغل Gateway، ثم تحقق باستخدام الأمر models status.
• إذا كان Gateway يعمل تحت systemd أو launchd، فضع المفتاح في ملف env داخل مجلد الحالة ليتمكن البرنامج الخفي (daemon) من قراءته، ثم أعد التشغيل وتحقق مجددًا باستخدام models status وdoctor؛ ويمكن للإعداد الأولي تخزين المفاتيح لاستخدام البرنامج الخفي إذا كنت تفضل عدم إدارة المتغيرات.
• إعادة استخدام Claude CLI مسار معتمد من Anthropic، وهو المسار المفضل للاستخدام المحلي أو على سطح المكتب عندما يوجد تسجيل دخول Claude على المضيف: سجل الدخول في Claude Code، ثم اطلب من OpenClaw توجيه نماذج Anthropic عبر واجهة Claude CLI الخلفية المحلية؛ ولا يقرأ OpenClaw رموز تسجيل الدخول الأصلية ولا يخزنها ولا يجددها ولا يمررها أبدًا، إذ تجدد العملية المثبتة تسجيل دخولها بنفسها، ويجب أن تعثر الخدمة على الملف التنفيذي ضمن مسارها.
• رمز الإعداد هو مسار Anthropic الآخر: رمز طويل الأمد يطبعه Claude Code على أي جهاز، ويخزن على المضيف عبر الأمر auth login في الوضع setup-token، الذي يحتاج إلى طرفية تفاعلية.

لمضيف gateway يعمل دائمًا، مفتاح API هو الخيار الأكثر قابلية للتنبؤ؛ وتعمل مسارات الاشتراك/OAuth أيضًا عندما تتوافق مع نموذج حسابك لدى المزوّد.

أين تحفظ بيانات الاعتماد

يعمل إدخال الرمز يدويًا مع أي مزوّد، ويكتب في مخزن المصادقة SQLite الخاص بكل وكيل، وهو المكان الذي يقرأ منه OpenClaw ملفات تعريف المصادقة؛ أما تفاصيل نقاط النهاية مثل عناوين URL الأساسية وأنواع API ومعرّفات النماذج والترويسات والمهل فمكانها إعدادات المزوّد، لا ملفات التعريف. ويستورد doctor التثبيتات الأقدم التي تستخدم ملفات مصادقة JSON مع نسخ احتياطية تحمل طابعًا زمنيًا، والمسارات الخارجية مثل وضع Bedrock SDK بيانات وصفية في الإعدادات وليست بيانات اعتماد، ويمكن أن تكون بيانات الاعتماد مراجع أسرار للمفاتيح والرموز، إلا أن ملفات التعريف في وضع OAuth ترفضها. وإزالة المصادقة المحفوظة لا تلغي المفتاح لدى المزوّد، وإزالة مصادقة مزوّد عبر مستوى التحكم أثناء عمل Gateway تجهض عمليات التشغيل النشطة على ذلك المزوّد مع سبب توقف auth-revoked حتى يتمكن العملاء من إظهار سبب توقف التشغيل.

التحقق والتدوير والاختيار

• الفحصان هما models status وdoctor؛ وتجعل العلامة check الأمر يخرج بالرمز 1 عندما تكون بيانات الاعتماد منتهية الصلاحية أو مفقودة، وبالرمز 2 عندما توشك صلاحيتها على الانتهاء، لخدمة الأتمتة، وتشغل العلامة probe فحوص مصادقة حية مع علامات لتحديد النطاق، وتبلغ عن ملفات التعريف المستبعدة بترتيب المصادقة، والمزوّدين الذين لديهم مصادقة دون نموذج قابل للفحص، وفترات التهدئة الخاصة بحدود المعدل على مستوى النموذج التي تترك النماذج الشقيقة قابلة للاستخدام.
• يعيد بعض المزوّدين محاولة الطلب الذي بلغ حد المعدل بمفتاح بديل مضبوط، وفق أولوية ثابتة: مفتاح تجاوز حي واحد، ثم قائمة مفاتيح مفصولة بفاصل، ثم متغير المفتاح العادي، ثم أي صيغة تحمل بادئة، مع رجوع مزوّدي Google أيضًا إلى مفتاح Google العام؛ ولا يبدأ التدوير إلا مع أخطاء حد المعدل والحصة وكثرة الطلبات، أما عبارات التقييد الخاصة بكل مزوّد فتقود بدلًا من ذلك تصنيف الانتقال الاحتياطي (failover) المنفصل.
• تستخدم ملفات تعريف مفتاح OpenAI API وملفات تعريف OAuth من ChatGPT أو Codex معرّف OpenAI المرجعي نفسه، ويعيد doctor كتابة معرّفات ملفات تعريف Codex القديمة وإدخالات ترتيب المصادقة. وتبقى عمليات تسجيل الدخول المتعددة لمزوّد واحد منفصلة عبر معرّفات ملفات التعريف، وتحذف علامة force ملف تعريف عالقًا أو مرتبطًا بحساب خاطئ وتعيد تشغيل المسار، وتثبت الجلسة بيانات اعتماد محددة بالأمر model مع لاحقة ملف التعريف، وتقوم أوامر ترتيب المصادقة لكل وكيل get وset وclear بقراءة الاختيار التلقائي وضبطه ومسحه.

OpenClaw مع Claude وOpenClaw باشتراك ChatGPT هما مسارا الاشتراك اللذان تميزهما هذه الصفحة عن مفتاح API.

عند الفشل

تعني الرسالة No credentials found أن المفتاح غير موجود على مضيف Gateway، أو أن مسار setup-token لم يشغل قط، ويؤكد models status نجاح الإصلاح؛ ويظهر الرمز الذي يوشك على الانتهاء أو انتهت صلاحيته في الحالة نفسها، ويجدد عبر رمز الإعداد أو يستبدل بمفتاح API. وتمسح أوامر الجلسة الجديدة وإعادة الضبط حالة الرجوع الاحتياطي التلقائي والتدوير، لكنها تحافظ على تثبيتات ملفات التعريف الصريحة الصالحة، وتغيير ترتيب المصادقة لا يغير إلا الاختيار التلقائي. الانتقال الاحتياطي بين النماذج في OpenClaw هو الآلية التي تبدل النماذج أو المزوّدين عند تكرار الفشل، وهو مختلف عن تدوير المفاتيح، أما الأسرار في OpenClaw فهي صيغة المراجع التي تستخدمها مراجع المفاتيح والرموز.

على Diali

على Diali يوضع المفتاح الذي تجلبه في Vault، وتشير إليه الإعدادات التي نولدها؛ ومن دونه يعمل المساعد على رصيد الذكاء الاصطناعي المدار، وتبين لوحة التحكم أيهما قيد الاستخدام. ويمكن أيضًا تشغيله بخطة ChatGPT أو SuperGrok أو MiniMax تدفع ثمنها بالفعل: تعرض لوحة التحكم رمزًا لمرة واحدة، فتوافق عليه في صفحة المزوّد نفسه، ويحتفظ المساعد بتسجيل الدخول بنفسه، فلا تحتفظ Diali بالرمز المميز أبدًا. رمز الإعداد (setup token) من Anthropic وتسجيل الدخول عبر Claude CLI معطّلان على Diali، لأن شروط Anthropic لا تسمح لخدمة مستضافة بالعمل باشتراك Claude؛ استخدم بدلًا من ذلك مفتاح API من Anthropic أو الرصيد المُدار. OpenClaw المستضاف على Diali هو المساعد، أما مقال النماذج والمزوّدون في OpenClaw فيغطي المزوّدين الذين تعود إليهم المفاتيح.

• مفتاح API على المضيف من أجل Gateway يعمل دائمًا.
• ملفات تعريف المصادقة في SQLite، ونقاط النهاية في الإعدادات.
• التدوير عند بلوغ حدود المعدل؛ والانتقال الاحتياطي في كل ما عدا ذلك.