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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

تُطوّر Anthropic عائلة نماذج Claude. يدعم OpenClaw مساري مصادقة:
  • مفتاح API — وصول مباشر إلى Anthropic API مع فوترة حسب الاستخدام (نماذج anthropic/*)
  • Claude CLI — إعادة استخدام تسجيل دخول Claude CLI موجود على المضيف نفسه
أخبرنا موظفو Anthropic أن استخدام Claude CLI بأسلوب OpenClaw مسموح به مرة أخرى، لذلك يتعامل OpenClaw مع إعادة استخدام Claude CLI واستخدام claude -p على أنهما مصرّح بهما ما لم تنشر Anthropic سياسة جديدة.بالنسبة إلى مضيفي Gateway طويلة الأمد، لا تزال مفاتيح Anthropic API هي مسار الإنتاج الأوضح والأكثر قابلية للتنبؤ.مستندات Anthropic العامة الحالية:

البدء

الأفضل لـ: وصول API القياسي والفوترة حسب الاستخدام.
1

احصل على مفتاح API الخاص بك

أنشئ مفتاح API في Anthropic Console.
2

شغّل الإعداد الأولي

openclaw onboard
# choose: Anthropic API key
أو مرّر المفتاح مباشرةً:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

تحقّق من أن النموذج متاح

openclaw models list --provider anthropic

مثال على الإعدادات

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

افتراضيات التفكير (Claude 4.6)

تستخدم نماذج Claude 4.6 التفكير adaptive افتراضياً في OpenClaw عند عدم تعيين مستوى تفكير صريح. تجاوز ذلك لكل رسالة باستخدام /think:<level> أو ضمن معاملات النموذج:
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { thinking: "adaptive" },
        },
      },
    },
  },
}
مستندات 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" } },
    ],
  },
}
ترتيب دمج الإعدادات:
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params (المطابقة لـ id، وتتجاوز حسب المفتاح)
يتيح هذا لوكيل واحد الاحتفاظ بذاكرة تخزين مؤقت طويلة الأمد بينما يعطّل وكيل آخر على النموذج نفسه التخزين المؤقت لحركة المرور المتقطعة/منخفضة إعادة الاستخدام.
  • تقبل نماذج Anthropic Claude على Bedrock (amazon-bedrock/*anthropic.claude*) تمرير cacheRetention عند تكوينها.
  • تُجبَر نماذج Bedrock غير التابعة لـ Anthropic على cacheRetention: "none" وقت التشغيل.
  • كما تضع الافتراضيات الذكية لمفتاح API القيمة cacheRetention: "short" لمراجع Claude-on-Bedrock عندما لا تكون هناك قيمة صريحة معيّنة.

الإعدادات المتقدمة

يدعم مفتاح التبديل المشترك /fast في OpenClaw حركة Anthropic المباشرة (مفتاح API وOAuth إلى api.anthropic.com).
الأمريُطابَق مع
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • يُحقن فقط لطلبات api.anthropic.com المباشرة. تترك مسارات الوكيل service_tier بدون تغيير.
  • معاملات serviceTier أو service_tier الصريحة تتجاوز /fast عند تعيينهما معاً.
  • في الحسابات التي لا تملك سعة Priority Tier، قد تُحلّ service_tier: "auto" إلى standard.
يسجّل Plugin Anthropic المضمّن فهم الصور وPDF. يحلّ OpenClaw إمكانات الوسائط تلقائياً من مصادقة Anthropic المكوّنة — لا حاجة إلى إعدادات إضافية.
الخاصيةالقيمة
النموذج الافتراضيclaude-opus-4-7
الإدخال المدعومالصور، مستندات PDF
عند إرفاق صورة أو PDF بمحادثة، يوجّهها OpenClaw تلقائياً عبر مزوّد فهم وسائط Anthropic.
نافذة السياق 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 المباشر.
يتطلب وصولاً طويل السياق على بيانات اعتماد Anthropic لديك. تُرفض مصادقة الرمز القديمة (sk-ant-oat-*) لطلبات سياق 1M — يسجّل OpenClaw تحذيراً ويعود إلى نافذة السياق القياسية.
يملك anthropic/claude-opus-4.7 ومتغيره claude-cli نافذة سياق 1M افتراضياً — لا حاجة إلى params.context1m: true.

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

تنتهي صلاحية مصادقة رمز Anthropic ويمكن إبطالها. للإعدادات الجديدة، استخدم مفتاح Anthropic API بدلاً من ذلك.
مصادقة Anthropic هي لكل وكيل — لا ترث الوكلاء الجدد مفاتيح الوكيل الرئيسي. أعد تشغيل الإعداد الأولي لذلك الوكيل (أو كوّن مفتاح API على مضيف Gateway)، ثم تحقّق باستخدام openclaw models status.
شغّل openclaw models status لمعرفة ملف المصادقة الشخصي النشط. أعد تشغيل الإعداد الأولي، أو كوّن مفتاح API لمسار ذلك الملف الشخصي.
افحص openclaw models status --json بحثاً عن auth.unusableProfiles. يمكن أن تكون فترات تهدئة حدود المعدل في Anthropic مقيّدة بنموذج معيّن، لذلك قد يظل نموذج Anthropic شقيق قابلاً للاستخدام. أضف ملف Anthropic شخصياً آخر أو انتظر انتهاء فترة التهدئة.

ذات صلة

اختيار النموذج

اختيار المزوّدين، ومراجع النماذج، وسلوك تجاوز الفشل.

خلفيات CLI

إعداد خلفية Claude CLI وتفاصيل التشغيل.

تخزين المطالبات مؤقتاً

كيفية عمل تخزين المطالبات مؤقتاً عبر المزوّدين.

OAuth والمصادقة

تفاصيل المصادقة وقواعد إعادة استخدام بيانات الاعتماد.