Providers
Anthropic
تطوّر Anthropic عائلة نماذج Claude. يدعم OpenClaw مساري مصادقة:
- مفتاح API — وصول مباشر إلى Anthropic API مع فوترة حسب الاستخدام (نماذج
anthropic/*) - Claude CLI — إعادة استخدام تسجيل دخول Claude CLI موجود على المضيف نفسه
بدء الاستخدام
مفتاح 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: "sk-ant-..." },
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
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-7" },
agentRuntime: { id: "claude-cli" },
},
},
}
ما زالت مراجع النماذج القديمة claude-cli/claude-opus-4-7 تعمل من أجل
التوافق، لكن ينبغي للتكوين الجديد أن يبقي اختيار الموفر/النموذج بصيغة
anthropic/* وأن يضع واجهة التنفيذ الخلفية في agentRuntime.id.
إعدادات التفكير الافتراضية (Claude 4.6)
تستخدم نماذج Claude 4.6 التفكير adaptive افتراضياً في OpenClaw عند عدم تعيين مستوى تفكير صريح.
تجاوز ذلك لكل رسالة باستخدام /think:<level> أو ضمن معاملات النموذج:
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { thinking: "adaptive" },
},
},
},
},
}
تخزين الموجهات مؤقتاً
يدعم 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عند تكوينها. - تُفرض قيمة
cacheRetention: "none"على نماذج Bedrock غير التابعة لـ Anthropic في وقت التشغيل. - تضبط الإعدادات الافتراضية الذكية لمفتاح API أيضاً قيمة
cacheRetention: "short"لمراجع Claude-on-Bedrock عند عدم تعيين قيمة صريحة.
التكوين المتقدم
الوضع السريع
يدعم مفتاح التبديل المشترك /fast في OpenClaw حركة 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-7 |
| الإدخال المدعوم | الصور، مستندات PDF |
عند إرفاق صورة أو PDF بمحادثة، يوجّه OpenClaw ذلك تلقائياً عبر موفر فهم الوسائط من Anthropic.
نافذة سياق 1M (تجريبية)
نافذة السياق 1M في Anthropic مقيّدة بإصدار تجريبي. مكّنها لكل نموذج:
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { context1m: true },
},
},
},
},
}
يعيّن OpenClaw هذا إلى anthropic-beta: context-1m-2025-08-07 في الطلبات.
ينطبق params.context1m: true أيضاً على الواجهة الخلفية Claude CLI
(claude-cli/*) لنماذج Opus وSonnet المؤهلة، مما يوسّع نافذة سياق وقت التشغيل
لتلك جلسات CLI كي تطابق سلوك API المباشر.
سياق 1M في Claude Opus 4.7
لدى anthropic/claude-opus-4.7 ومتغيره claude-cli نافذة سياق 1M
افتراضياً — ولا حاجة إلى params.context1m: true.
استكشاف الأخطاء وإصلاحها
أخطاء 401 / أصبح الرمز غير صالح فجأة
تنتهي صلاحية مصادقة رمز Anthropic ويمكن إبطالها. بالنسبة إلى الإعدادات الجديدة، استخدم مفتاح Anthropic API بدلاً من ذلك.
لم يُعثر على مفتاح API للموفر "anthropic"
مصادقة Anthropic تكون لكل وكيل — لا ترث الوكلاء الجديدة مفاتيح الوكيل الرئيسي. أعد تشغيل الإعداد الأولي لذلك الوكيل (أو كوّن مفتاح API على مضيف Gateway)، ثم تحقق باستخدام openclaw models status.
لم يُعثر على بيانات اعتماد لملف التعريف "anthropic:default"
شغّل openclaw models status لمعرفة ملف تعريف المصادقة النشط. أعد تشغيل الإعداد الأولي، أو كوّن مفتاح API لمسار ملف التعريف ذلك.
لا يوجد ملف تعريف مصادقة متاح (كلها في فترة تهدئة)
تحقق من openclaw models status --json للاطلاع على auth.unusableProfiles. يمكن أن تكون فترات تهدئة حدود المعدل في Anthropic مقيّدة بنموذج معين، لذلك قد يظل نموذج Anthropic شقيق قابلاً للاستخدام. أضف ملف تعريف Anthropic آخر أو انتظر انتهاء فترة التهدئة.