​

Anthropic (Claude)

​

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

​

الإعداد عبر CLI

openclaw onboard
# choose: Anthropic API key

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

​

مقتطف إعداد Claude CLI

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

​

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

• تستخدم نماذج Anthropic Claude 4.6 التفكير adaptive افتراضيًا في OpenClaw عندما لا يتم ضبط مستوى تفكير صريح.
• يمكنك التجاوز لكل رسالة (/think:<level>) أو في معلمات النموذج: agents.defaults.models["anthropic/<model>"].params.thinking.
• مستندات Anthropic ذات الصلة:
  • Adaptive thinking
  • Extended thinking

​

الوضع السريع (Anthropic API)

• يربط /fast on إلى service_tier: "auto"
• يربط /fast off إلى service_tier: "standard_only"
• الإعداد الافتراضي:

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}

• لا يحقن OpenClaw مستويات خدمة Anthropic إلا للطلبات المباشرة إلى api.anthropic.com. إذا قمت بتوجيه anthropic/* عبر proxy أو بوابة، فإن /fast يترك service_tier كما هو.
• تتجاوز معلمات Anthropic الصريحة serviceTier أو service_tier الافتراضي الخاص بـ /fast عندما يتم ضبطهما معًا.
• تبلّغ Anthropic عن المستوى الفعلي في الاستجابة ضمن usage.service_tier. وفي الحسابات التي لا تملك سعة Priority Tier، قد يظل service_tier: "auto" يتحلل إلى standard.

​

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

​

الإعداد

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

​

القيم الافتراضية

​

تجاوزات cacheRetention لكل وكيل

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // baseline for most agents
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // override for this agent only
    ],
  },
}

1. agents.defaults.models["provider/model"].params
2. agents.list[].params ‏(مطابق لـ id، ويتجاوز حسب المفتاح)

​

ملاحظات Bedrock Claude

• تقبل نماذج Anthropic Claude على Bedrock ‏(amazon-bedrock/*anthropic.claude*) تمرير cacheRetention عند إعداده.
• تُجبر نماذج Bedrock غير التابعة لـ Anthropic على cacheRetention: "none" في وقت التشغيل.
• كما تُهيّئ القيم الذكية الافتراضية لمفتاح Anthropic API القيمة cacheRetention: "short" لمراجع نماذج Claude-on-Bedrock عندما لا تكون هناك قيمة صريحة مضبوطة.

​

نافذة سياق 1M ‏(Anthropic beta)

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}

​

الخيار B: Claude CLI كموفّر الرسائل

• claude-cli/claude-sonnet-4-6
• claude-cli/claude-opus-4-6

1. يشغّل OpenClaw الأمر claude -p --output-format stream-json --include-partial-messages ... على مضيف البوابة ويرسل المطالبة عبر stdin.
2. يرسل الدور الأول --session-id <uuid>.
3. تعيد الأدوار اللاحقة استخدام جلسة Claude المخزنة عبر --resume <sessionId>.
4. لا تزال رسائل الدردشة الخاصة بك تمر عبر مسار الرسائل العادي في OpenClaw، لكن الرد الفعلي للنموذج يتم إنتاجه بواسطة Claude CLI.

​

المتطلبات

• Claude CLI مثبت على مضيف البوابة ومتوفر على PATH، أو مُعدّ بمسار أمر مطلق.
• Claude CLI موثّق بالفعل على ذلك المضيف نفسه:

claude auth status

• يقوم OpenClaw بتحميل plugin Anthropic المضمّن تلقائيًا عند بدء تشغيل البوابة عندما تشير إعداداتك صراحةً إلى claude-cli/... أو إعداد خلفية claude-cli.

​

مقتطف الإعداد

{
  agents: {
    defaults: {
      model: {
        primary: "claude-cli/claude-sonnet-4-6",
      },
      models: {
        "claude-cli/claude-sonnet-4-6": {},
      },
      sandbox: { mode: "off" },
    },
  },
}

{
  agents: {
    defaults: {
      cliBackends: {
        "claude-cli": {
          command: "/opt/homebrew/bin/claude",
        },
      },
    },
  },
}

​

ما الذي تحصل عليه

• إعادة استخدام مصادقة اشتراك Claude من CLI المحلي (تُقرأ في وقت التشغيل، ولا تُخزَّن)
• توجيه الرسائل/الجلسات العادي في OpenClaw
• استمرارية جلسة Claude CLI عبر الأدوار (تُبطل عند تغيّر المصادقة)
• أدوات البوابة مكشوفة إلى Claude CLI عبر جسر MCP على loopback
• بث JSONL مع تقدم حي للرسائل الجزئية

​

الترحيل من مصادقة Anthropic إلى Claude CLI

• Claude CLI مثبت على مضيف البوابة نفسه الذي يشغّل OpenClaw
• Claude CLI مسجل الدخول هناك بالفعل: claude auth login

openclaw models auth login --provider anthropic --method cli --set-default

openclaw onboard --auth-choice anthropic-cli

• يتحقق من أن Claude CLI مسجّل الدخول بالفعل على مضيف البوابة
• يبدّل النموذج الافتراضي إلى claude-cli/...
• يعيد كتابة بدائل النموذج الافتراضي لـ Anthropic مثل anthropic/claude-opus-4-6 إلى claude-cli/claude-opus-4-6
• يضيف إدخالات claude-cli/... المطابقة إلى agents.defaults.models

openclaw models status

• حذف ملفات تعريف المصادقة الحالية الخاصة بـ Anthropic
• إزالة كل مراجع الإعداد القديمة anthropic/... خارج مسار النموذج الافتراضي/قائمة السماح الرئيسية

​

القيود المهمة

• هذا ليس موفّر Anthropic API. بل هو وقت تشغيل CLI المحلي.
• لا يحقن OpenClaw استدعاءات الأدوات مباشرة. يتلقى Claude CLI أدوات البوابة عبر جسر MCP على loopback ‏(bundleMcp: true، وهو الافتراضي).
• يبث Claude CLI الردود عبر JSONL ‏(stream-json مع --include-partial-messages). وتُرسل المطالبات عبر stdin، وليس argv.
• تُقرأ المصادقة في وقت التشغيل من بيانات اعتماد Claude CLI الحية ولا تُخزَّن في ملفات تعريف OpenClaw. كما تُخفى مطالبات Keychain في السياقات غير التفاعلية.
• يُتتبَّع إعادة استخدام الجلسات عبر بيانات وصفية cliSessionBinding. وعندما تتغير حالة تسجيل دخول Claude CLI ‏(إعادة تسجيل الدخول، تدوير الرمز)، تُبطَل الجلسات المخزنة وتبدأ جلسة جديدة.
• هذا الأنسب لمضيف بوابة شخصي، وليس لإعدادات فوترة مشتركة متعددة المستخدمين.

​

ملاحظات

• لا تزال مستندات Claude Code العامة من Anthropic توثق الاستخدام المباشر لـ CLI مثل claude -p. ونعتقد أن الرجوع المحلي الذي يديره المستخدم مسموح به على الأرجح، لكن الإشعار المنفصل من Anthropic إلى مستخدمي OpenClaw يقول إن مسار Claude-login الخاص بـ OpenClaw هو استخدام harness تابع لجهة خارجية ويتطلب Extra Usage (الدفع حسب الاستخدام مع فوترة منفصلة عن الاشتراك). وبالنسبة إلى الإنتاج، نحن نوصي باستخدام مفاتيح Anthropic API بدلًا من ذلك.
• أصبح Anthropic setup-token متاحًا مرة أخرى في OpenClaw كمسار قديم/يدوي. ولا يزال إشعار Anthropic الخاص بـ OpenClaw حول الفوترة ينطبق، لذا استخدمه مع توقع أن Anthropic تتطلب Extra Usage لهذا المسار.
• توجد تفاصيل المصادقة + قواعد إعادة الاستخدام في /concepts/oauth.

​

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

• قد تنتهي صلاحية مصادقة رموز Anthropic القديمة أو يتم إبطالها.
• بالنسبة إلى الإعداد الجديد، انتقل إلى مفتاح Anthropic API أو إلى مسار Claude CLI المحلي على مضيف البوابة.

• المصادقة تكون لكل وكيل. ولا ترث الوكلاء الجدد مفاتيح الوكيل الرئيسي.
• أعد تشغيل الإعداد الأولي لذلك الوكيل، أو اضبط مفتاح API على مضيف البوابة، ثم تحقق عبر openclaw models status.

• شغّل openclaw models status لمعرفة ملف تعريف المصادقة النشط.
• أعد تشغيل الإعداد الأولي، أو اضبط مفتاح API أو Claude CLI لذلك المسار الخاص بملف التعريف.

• تحقق من openclaw models status --json لرؤية auth.unusableProfiles.
• يمكن أن تكون فترات التهدئة الخاصة بحدود المعدل في Anthropic مرتبطة بالنموذج، لذلك قد يظل نموذج Anthropic شقيق قابلًا للاستخدام حتى عندما يكون النموذج الحالي في فترة تهدئة.
• أضف ملف تعريف Anthropic آخر أو انتظر انتهاء فترة التهدئة.