Providers
Anthropic
تبني Anthropic عائلة نماذج Claude. يدعم OpenClaw مساري مصادقة:
- مفتاح API — وصول مباشر إلى Anthropic API مع فوترة حسب الاستخدام (نماذج
anthropic/*) - Claude CLI — إعادة استخدام تسجيل دخول Claude Code موجود على المضيف نفسه
البدء
مفتاح API
الأفضل لـ: وصول API القياسي والفوترة حسب الاستخدام.
احصل على مفتاح API الخاص بك
أنشئ مفتاح API في Anthropic Console.
شغل الإعداد الأولي
openclaw onboard# choose: Anthropic API keyأو مرر المفتاح مباشرة:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"تحقق من أن النموذج متاح
openclaw models list --provider anthropicمثال على الإعدادات
{ env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" }, agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}Claude CLI
الأفضل لـ: إعادة استخدام تسجيل دخول Claude CLI موجود بدون مفتاح API منفصل.
تأكد من تثبيت Claude CLI وتسجيل الدخول إليه
تحقق باستخدام:
claude --versionشغل الإعداد الأولي
openclaw onboard# choose: Claude CLIيكتشف OpenClaw بيانات اعتماد Claude CLI الموجودة ويعيد استخدامها.
تحقق من أن النموذج متاح
openclaw models list --provider anthropicمثال على الإعدادات
فضل مرجع نموذج Anthropic القياسي مع تجاوز وقت تشغيل CLI:
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" }, models: { "anthropic/claude-opus-4-8": { agentRuntime: { id: "claude-cli" }, }, }, }, },}ما زالت مراجع النماذج القديمة claude-cli/claude-opus-4-7 تعمل من أجل
التوافق، لكن يجب أن تحافظ الإعدادات الجديدة على اختيار الموفر/النموذج كـ
anthropic/* وأن تضع واجهة التنفيذ الخلفية في سياسة وقت تشغيل الموفر/النموذج.
الفوترة وclaude -p
يستخدم OpenClaw مسار claude -p غير التفاعلي في Claude Code لتشغيل Claude CLI.
تتعامل Anthropic حاليا مع ذلك المسار على أنه استخدام Agent SDK/برمجي:
- أوقف تحديث دعم Anthropic في 15 يونيو 2026 خطة رصيد Agent SDK المنفصلة المعلن عنها سابقا مؤقتا.
- في الوقت الحالي، ما زال استخدام Claude Agent SDK و
claude -pوتطبيقات الجهات الخارجية ضمن خطة الاشتراك يستهلك من حدود استخدام الاشتراك المسجل به الدخول. - رصيد Agent SDK الشهري المعلن عنه سابقا غير متاح بينما تراجع Anthropic تلك الخطة.
- تستخدم تسجيلات دخول Console/مفتاح API فوترة API بنظام الدفع حسب الاستخدام ولا تحصل على رصيد Agent SDK الخاص بالاشتراك.
راجع مقال خطة Agent SDK من Anthropic للاطلاع على إشعار الإيقاف المؤقت، ومقالات خطة Claude Code لسلوك اشتراكات Pro/Max و Team/Enterprise.
يمكن أن تغير Anthropic فوترة Claude Code وسلوك حدود المعدل بدون
إصدار OpenClaw. تحقق من claude auth status و/status ووثائق
Anthropic المرتبطة عندما تكون قابلية توقع الفوترة مهمة.
افتراضيات التفكير (Claude Fable 5 و4.8 و4.6)
يستخدم anthropic/claude-fable-5 دائما التفكير التكيفي ويفترض جهدا high.
نظرا لأن Anthropic لا تسمح بتعطيل التفكير لهذا النموذج،
يستخدم /think off و/think minimal جهدا low. يحذف OpenClaw أيضا قيم
درجة الحرارة المخصصة لطلبات Fable 5.
يبقي Claude Opus 4.8 التفكير معطلا افتراضيا في OpenClaw. عندما تفعّل التفكير التكيفي صراحة باستخدام /think high|xhigh|max، يرسل OpenClaw قيم جهد Opus 4.8 الخاصة بـ Anthropic؛ تفترض نماذج Claude 4.6 القيمة adaptive.
تجاوز ذلك لكل رسالة باستخدام /think:<level> أو في معلمات النموذج:
{ agents: { defaults: { models: { "anthropic/claude-opus-4-8": { params: { thinking: "high" }, }, }, }, },}احتياطي رفض السلامة (Claude Fable 5)
سبب وجود هذا
تعيد مصنفات Fable 5 القيمة stop_reason: "refusal" على الطلبات في المجالات
المقيدة، كما تعطي نتائج إيجابية كاذبة في الأعمال القريبة من الحميدة (أدوات
الأمان، وعلوم الحياة، أو حتى طلب إعادة إنتاج الاستدلال الخام من النموذج).
بدون احتياطي، تموت الجولة بخطأ رغم أن
نموذج Claude آخر كان سيخدمها بسلاسة — تخبر رسالة الرفض الخاصة بـ Anthropic
مكاملي API بتكوين نموذج احتياطي.
كيف يعمل
- لكل طلب مباشر بمفتاح API إلى
anthropic/claude-fable-5، يرسل OpenClaw موافقة احتياطية من جانب خادم Anthropic: ترويسة betaserver-side-fallback-2026-06-01معfallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 هو هدف الاحتياطي الوحيد الذي تسمح به Anthropic لـ Fable 5. - لا يشغل الاحتياطي إلا رفض مصنف السلامة. تتصرف حدود المعدل والتحميل الزائد وأخطاء الخادم تماما كما كانت من قبل وتمر عبر تجاوز فشل النموذج العادي في OpenClaw.
- يحدث الإنقاذ داخل الاستدعاء نفسه. يكون الرفض قبل أي مخرجات غير مرئي باستثناء زمن الانتظار؛ تأتي الإجابة كلها من Opus 4.8. عند حدوث رفض في منتصف البث، يُحتفظ بالنص الجزئي كبادئة يتابع منها نموذج الاحتياطي، بينما يتم تجاهل استدلال النموذج الرافض واستدعاءات الأدوات حسب قواعد إعادة التشغيل الخاصة بـ Anthropic (يجب ألا تُعاد أو تُنفذ).
- إذا رفض Claude Opus 4.8 أيضا، تعرض الجولة الرفض كخطأ، تماما كما كان قبل هذه الميزة.
يحدث الاحتياطي على مستوى Anthropic API، لذلك لا يحتاج claude-opus-4-8 إلى
أن يكون ضمن قائمة نماذجك المكونة أو سلسلة الاحتياطيات — يمكن لمفتاح API
القادر على Fable أن يخدم Opus دائما.
القابلية للملاحظة والفوترة
- تسجل الجولة المخدومة بالاحتياطي تشخيص
provider_fallbackعلى رسالة المساعد مع تسميةfromModelوtoModel، ويبلغresponseModelالخاص بالرسالة عنclaude-opus-4-8. - تفوتر Anthropic لكل محاولة: الرفض قبل المخرجات مجاني، والإنقاذ يفوتر بأسعار Claude Opus 4.8 (حاليا نصف أسعار Fable 5). يسعر تقدير تكلفة كل جولة في OpenClaw الجولات المخدومة بالاحتياطي بأسعار Opus للمطابقة.
- يضيف الرفض في منتصف البث فوترة للجزء الجزئي من Fable الذي تم بثه بالفعل من جانب Anthropic؛ يتم الإبلاغ عن ذلك الجزء في استخدام كل محاولة في API لكنه لا يدمج في تقدير كل جولة في OpenClaw.
النطاق
ينطبق على anthropic/claude-fable-5 مع مصادقة مفتاح API مقابل
api.anthropic.com. تبقى طلبات OAuth (إعادة استخدام اشتراك Claude CLI)، وعناوين URL الأساسية للوكيل،
وBedrock، وVertex، وFoundry دون تغيير وما زالت تعرض
الرفض كأخطاء هناك.
تم التحقق مباشرة: يتم رفض مطالبة حميدة تطلب من Fable 5 إعادة إنتاج سلسلة
التفكير الخام الخاصة به مع category: "reasoning_extraction" عند إرسالها بدون
احتياطيات، وتعيد المطالبة نفسها عبر OpenClaw إجابة عادية يخدمها Opus
مع تشخيص provider_fallback مرفق.
راجع دليل الرفض والاحتياطي من Anthropic للسلوك الأساسي.
التخزين المؤقت للمطالبة
يدعم OpenClaw ميزة التخزين المؤقت للمطالبات من Anthropic لمصادقة مفتاح API.
| القيمة | مدة التخزين المؤقت | الوصف |
|---|---|---|
"short" (افتراضي) |
5 دقائق | يطبق تلقائيا لمصادقة مفتاح API |
"long" |
ساعة واحدة | تخزين مؤقت ممتد |
"none" |
بدون تخزين مؤقت | تعطيل التخزين المؤقت للمطالبة |
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, },}تجاوزات التخزين المؤقت لكل وكيل
استخدم معلمات مستوى النموذج كخط أساس، ثم تجاوز وكلاء محددين عبر agents.list[].params:
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" }, models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, list: [ { id: "research", default: true }, { id: "alerts", params: { cacheRetention: "none" } }, ], },}ترتيب دمج الإعدادات:
agents.defaults.models["provider/model"].paramsagents.list[].params(مطابقةid، وتتجاوز حسب المفتاح)
يتيح هذا لوكيل واحد الاحتفاظ بذاكرة تخزين مؤقت طويلة الأمد بينما يعطل وكيل آخر على النموذج نفسه التخزين المؤقت لحركة المرور المتدفقة أو قليلة إعادة الاستخدام.
ملاحظات Bedrock Claude
- تقبل نماذج Anthropic Claude على Bedrock (
amazon-bedrock/*anthropic.claude*) تمريرcacheRetentionعند تكوينها. - تُجبر نماذج Bedrock غير التابعة لـ Anthropic على
cacheRetention: "none"في وقت التشغيل. - تضع الإعدادات الافتراضية الذكية لمفاتيح API أيضًا
cacheRetention: "short"لمراجع Claude-on-Bedrock عند عدم تعيين قيمة صريحة.
الإعدادات المتقدمة
الوضع السريع
يدعم مفتاح OpenClaw المشترك /fast حركة Anthropic المباشرة (مفتاح API وOAuth إلى api.anthropic.com).
| الأمر | يُطابق |
|---|---|
/fast on |
service_tier: "auto" |
/fast off |
service_tier: "standard_only" |
{ agents: { defaults: { models: { "anthropic/claude-sonnet-4-6": { params: { fastMode: true }, }, }, }, },}فهم الوسائط (الصور وPDF)
يسجل Plugin Anthropic المضمّن فهم الصور وPDF. يحل OpenClaw إمكانات الوسائط تلقائيًا من مصادقة Anthropic المكوّنة، ولا يلزم أي إعداد إضافي.
| الخاصية | القيمة |
|---|---|
| النموذج الافتراضي | claude-opus-4-8 |
| الإدخال المدعوم | الصور، مستندات PDF |
عند إرفاق صورة أو PDF بمحادثة، يوجهه OpenClaw تلقائيًا عبر مزود فهم الوسائط من Anthropic.
نافذة سياق 1M
تتوفر نافذة سياق Anthropic بحجم 1M على نماذج Claude 4.x القادرة على GA مثل Opus 4.8 وOpus 4.7 وOpus 4.6 وSonnet 4.6. يضبط OpenClaw حجم هذه النماذج على 1M تلقائيًا:
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": {}, }, }, },}يمكن للإعدادات القديمة الاحتفاظ بـ params.context1m: true، لكن OpenClaw لم يعد يرسل
ترويسة بيتا المتقاعدة context-1m-2025-08-07. يتم تجاهل إدخالات إعدادات anthropicBeta
القديمة التي تحتوي على تلك القيمة أثناء حل ترويسات الطلب، وتبقى
نماذج Claude القديمة غير المدعومة على نافذة السياق العادية الخاصة بها.
ينطبق params.context1m: true أيضًا على خلفية Claude CLI
(claude-cli/*) لنماذج Opus وSonnet المؤهلة والقادرة على GA، مع الحفاظ
على نافذة سياق وقت التشغيل لجلسات CLI هذه لتطابق سلوك API المباشر.
سياق Claude Opus 4.8 بحجم 1M
يحتوي anthropic/claude-opus-4-8 ومتغيره claude-cli على نافذة سياق 1M
افتراضيًا، ولا حاجة إلى params.context1m: true.
استكشاف الأخطاء وإصلاحها
أخطاء 401 / الرمز أصبح غير صالح فجأة
تنتهي صلاحية مصادقة رمز Anthropic ويمكن إبطالها. للإعدادات الجديدة، استخدم مفتاح API من Anthropic بدلًا من ذلك.
لم يتم العثور على مفتاح API للمزود "anthropic"
مصادقة Anthropic تكون لكل وكيل؛ لا ترث الوكلاء الجدد مفاتيح الوكيل الرئيسي. أعد تشغيل الإعداد الأولي لذلك الوكيل (أو كوّن مفتاح API على مضيف Gateway)، ثم تحقق باستخدام openclaw models status.
لم يتم العثور على بيانات اعتماد للملف الشخصي "anthropic:default"
شغّل openclaw models status لمعرفة ملف المصادقة الشخصي النشط. أعد تشغيل الإعداد الأولي، أو كوّن مفتاح API لمسار الملف الشخصي هذا.
لا يوجد ملف مصادقة شخصي متاح (الكل في فترة تهدئة)
تحقق من auth.unusableProfiles عبر openclaw models status --json. قد تكون فترات تهدئة حدود معدل Anthropic خاصة بالنموذج، لذلك قد يظل نموذج Anthropic شقيق قابلًا للاستخدام. أضف ملف Anthropic شخصيًا آخر أو انتظر انتهاء فترة التهدئة.