الانتقال إلى المحتوى الرئيسي

​
Anthropic (Claude)

تطوّر Anthropic عائلة نماذج Claude وتوفّر الوصول إليها عبر واجهة برمجة التطبيقات. في OpenClaw يمكنك المصادقة باستخدام مفتاح API أو setup-token.

​
الخيار A: مفتاح Anthropic API

الأفضل لـ: الوصول القياسي إلى API والفوترة حسب الاستخدام. أنشئ مفتاح API الخاص بك في وحدة تحكّم Anthropic.

​
إعداد CLI

openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​
مقتطف تهيئة

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

​
تخزين المطالبات مؤقتًا (Anthropic API)

يدعم OpenClaw ميزة تخزين المطالبات مؤقتًا الخاصة بـ Anthropic. هذه الميزة مقتصرة على API فقط؛ ولا تلتزم مصادقة الاشتراك بإعدادات التخزين المؤقت.

​
التهيئة

استخدم المعامل cacheRetention في تهيئة النموذج:
القيمةمدة التخزين المؤقتالوصف
noneلا يوجد مخبئتعطيل تخزين المطالبات مؤقتًا
short5 دقائقالافتراضي لمصادقة مفتاح API
longساعة واحدةتخزين ممتد (يتطلب علامة تجريبية)
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

​
الإعدادات الافتراضية

عند استخدام مصادقة مفتاح Anthropic API، يطبّق OpenClaw تلقائيًا cacheRetention: "short" (تخزين لمدة 5 دقائق) على جميع نماذج Anthropic. يمكنك تجاوز ذلك بتعيين cacheRetention صراحةً في التهيئة.

​
المعلمة القديمة

لا يزال المعامل الأقدم cacheControlTtl مدعومًا للتوافق مع الإصدارات السابقة:
  • "5m" يُطابِق short
  • "1h" يُطابِق long
نوصي بالانتقال إلى المعامل الجديد cacheRetention. يتضمن OpenClaw علامة تجريبية extended-cache-ttl-2025-04-11 لطلبات Anthropic API؛ احتفظ بها إذا قمت بتجاوز ترويسات الموفّر (راجع /gateway/configuration).

​
الخيار B: Claude setup-token

الأفضل لـ: استخدام اشتراك Claude الخاص بك.

​
من أين تحصل على setup-token

يتم إنشاء setup-tokens بواسطة Claude Code CLI، وليس من وحدة تحكّم Anthropic. يمكنك تشغيله على أي جهاز: 
claude setup-token
الصق الرمز في OpenClaw (المعالج: Anthropic token (paste setup-token))، أو شغّله على مضيف Gateway: 
openclaw models auth setup-token --provider anthropic
إذا أنشأت الرمز على جهاز مختلف، فقم بلصقه: 
openclaw models auth paste-token --provider anthropic

​
إعداد CLI (setup-token)

# Paste a setup-token during onboarding
openclaw onboard --auth-choice setup-token

​
مقتطف تهيئة (setup-token)

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

​
ملاحظات

  • أنشئ setup-token باستخدام claude setup-token ثم الصقه، أو شغّل openclaw models auth setup-token على مضيف Gateway.
  • إذا رأيت رسالة «OAuth token refresh failed …» عند استخدام اشتراك Claude، فأعد المصادقة باستخدام setup-token. راجع /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription.
  • تفاصيل المصادقة + قواعد إعادة الاستخدام موجودة في /concepts/oauth.

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

أخطاء 401 / الرمز أصبح غير صالح فجأة
  • قد تنتهي مصادقة اشتراك Claude أو يتم سحبها. أعد تشغيل claude setup-token والصقه على مضيف Gateway.
  • إذا كان تسجيل دخول Claude CLI موجودًا على جهاز مختلف، فاستخدم openclaw models auth paste-token --provider anthropic على مضيف Gateway.
لم يتم العثور على مفتاح API لموفّر “anthropic”
  • المصادقة لكل وكيل. الوكلاء الجدد لا يرثون مفاتيح الوكيل الرئيسي.
  • أعد تشغيل التهيئة الأولية لذلك الوكيل، أو الصق setup-token / مفتاح API على مضيف Gateway، ثم تحقّق باستخدام openclaw models status.
لم يتم العثور على بيانات اعتماد للملف الشخصي anthropic:default
  • شغّل openclaw models status لمعرفة ملف المصادقة النشط.
  • أعد تشغيل التهيئة الأولية، أو الصق setup-token / مفتاح API لذلك الملف الشخصي.
لا يوجد ملف مصادقة متاح (الكل في فترة تهدئة/غير متاح)
  • تحقّق من openclaw models status --json بحثًا عن auth.unusableProfiles.
  • أضف ملف Anthropic آخر أو انتظر انتهاء فترة التهدئة.
المزيد: /gateway/troubleshooting و /help/faq.