Skip to main content

​
المصادقة

يدعم OpenClaw كلاً من OAuth ومفاتيح API لموفّري النماذج. لحسابات Anthropic، نوصي باستخدام مفتاح API. للوصول عبر اشتراك Claude، استخدم الرمز طويل الأمد الذي تم إنشاؤه بواسطة claude setup-token. راجع /concepts/oauth للاطلاع على تدفّق OAuth الكامل وتخطيط التخزين.

​
إعداد Anthropic الموصى به (مفتاح API)

إذا كنت تستخدم Anthropic مباشرةً، فاستعمل مفتاح API.
  1. أنشئ مفتاح API في وحدة تحكم Anthropic.
  2. ضعه على مضيف Gateway (الجهاز الذي يشغّل openclaw gateway).
  1. إذا كان Gateway يعمل تحت systemd/launchd، ففضّل وضع المفتاح في ~/.openclaw/.env كي يتمكن الـ daemon من قراءته:
بعد ذلك أعد تشغيل الـ daemon (أو أعد تشغيل عملية Gateway لديك) ثم أعد التحقق:
إذا كنت تفضّل عدم إدارة متغيرات البيئة بنفسك، يمكن لمعالج التهيئة الأولية تخزين مفاتيح API لاستخدام الـ daemon: openclaw onboard. راجع Help لمزيد من التفاصيل حول وراثة متغيرات البيئة (env.shellEnv، ~/.openclaw/.env، systemd/launchd).

​
Anthropic: setup-token (مصادقة الاشتراك)

بالنسبة إلى Anthropic، المسار الموصى به هو مفتاح API. إذا كنت تستخدم اشتراك Claude، فمسار setup-token مدعوم أيضًا. شغّله على مضيف Gateway:
ثم الصقه في OpenClaw:
إذا تم إنشاء الرمز على جهاز آخر، فالصقه يدويًا:
إذا ظهرت لك رسالة خطأ من Anthropic مثل:
…فاستخدم مفتاح API لـ Anthropic بدلًا من ذلك. إدخال الرمز يدويًا (أي موفّر؛ يكتب auth-profiles.json + يحدّث التهيئة):
تحقّق ملائم للأتمتة (ينهي التنفيذ بـ 1 عند الانتهاء/الغياب، و2 عند قرب الانتهاء):
تم توثيق سكربتات التشغيل الاختيارية (systemd/Termux) هنا: /automation/auth-monitoring
يتطلّب claude setup-token طرفية TTY تفاعلية.

​
التحقق من حالة مصادقة النموذج

​
التحكّم في بيانات الاعتماد المستخدمة

​
لكل جلسة (أمر الدردشة)

استخدم /model <alias-or-id>@<profileId> لتثبيت بيانات اعتماد موفّر محددة للجلسة الحالية (أمثلة على معرّفات الملفات التعريفية: anthropic:default، anthropic:work). استخدم /model (أو /model list) لاختيار مختصر؛ واستخدم /model status للعرض الكامل (المرشّحون + ملف المصادقة التالي، مع تفاصيل نقطة نهاية الموفّر عند التهيئة).

​
لكل وكيل (تجاوز عبر CLI)

عيّن تجاوز ترتيب ملف تعريف المصادقة بشكل صريح لوكيل معيّن (يُخزَّن في auth-profiles.json الخاص بذلك الوكيل):
استخدم --agent <id> لاستهداف وكيل محدّد؛ أو احذفه لاستخدام الوكيل الافتراضي المُهيّأ.

​
استكشاف الأخطاء وإصلاحها

​
«لم يتم العثور على بيانات اعتماد»

إذا كان ملف تعريف رمز Anthropic مفقودًا، شغّل claude setup-token على مضيف Gateway، ثم أعد التحقق:

​
انتهت صلاحية الرمز المميز

شغّل openclaw models status لتأكيد أي ملف تعريف على وشك الانتهاء. إذا كان ملف التعريف مفقودًا، فأعد تشغيل claude setup-token وألصق الرمز مرة أخرى.

​
المتطلبات

  • اشتراك Claude Max أو Pro (لـ claude setup-token)
  • تثبيت Claude Code CLI (توفر أمر claude)