Skip to main content

Amazon Bedrock

يمكن لـ OpenClaw استخدام نماذج Amazon Bedrock عبر موفّر البثّ Bedrock Converse من pi‑ai. تستخدم مصادقة Bedrock سلسلة بيانات الاعتماد الافتراضية لـ AWS SDK، وليس مفتاح API.

ما الذي يدعمه pi‑ai

  • الموفّر: amazon-bedrock
  • واجهة API: bedrock-converse-stream
  • المصادقة: بيانات اعتماد AWS (متغيرات البيئة، التهيئة المشتركة، أو دور المثيل)
  • المنطقة: AWS_REGION أو AWS_DEFAULT_REGION (الافتراضي: us-east-1)

الاكتشاف التلقائي للنماذج

إذا تم اكتشاف بيانات اعتماد AWS، يمكن لـ OpenClaw اكتشاف نماذج Bedrock تلقائيًا التي تدعم البثّ ومخرجات النص. يستخدم الاكتشاف bedrock:ListFoundationModels ويتم تخزينه مؤقتًا (الافتراضي: ساعة واحدة). توجد خيارات التهيئة ضمن models.bedrockDiscovery:
ملاحظات:
  • القيمة الافتراضية لـ enabled هي true عند توفر بيانات اعتماد AWS.
  • القيمة الافتراضية لـ region هي AWS_REGION أو AWS_DEFAULT_REGION، ثم us-east-1.
  • يطابق providerFilter أسماء موفّري Bedrock (على سبيل المثال anthropic).
  • refreshInterval بالثواني؛ اضبطه على 0 لتعطيل التخزين المؤقت.
  • يتم استخدام defaultContextWindow (الافتراضي: 32000) وdefaultMaxTokens (الافتراضي: 4096) للنماذج المكتشفة (يمكن التجاوز إذا كنت تعرف حدود نموذجك).

الإعداد (يدوي)

  1. تأكد من توفر بيانات اعتماد AWS على مضيف Gateway:
  1. أضف موفّر Bedrock ونموذجًا إلى التهيئة لديك (لا يلزم apiKey):

أدوار مثيلات EC2

عند تشغيل OpenClaw على مثيل EC2 مع إرفاق دور IAM، سيستخدم AWS SDK تلقائيًا خدمة بيانات تعريف المثيل (IMDS) للمصادقة. ومع ذلك، فإن اكتشاف بيانات الاعتماد في OpenClaw يتحقق حاليًا من متغيرات البيئة فقط، وليس من بيانات اعتماد IMDS. حل بديل: عيّن AWS_PROFILE=default للإشارة إلى أن بيانات اعتماد AWS متاحة. تستمر المصادقة الفعلية في استخدام دور المثيل عبر IMDS.
أذونات IAM المطلوبة لدور مثيل EC2:
  • bedrock:InvokeModel
  • bedrock:InvokeModelWithResponseStream
  • bedrock:ListFoundationModels (للاكتشاف التلقائي)
أو قم بإرفاق السياسة المُدارة AmazonBedrockFullAccess. إعداد سريع:

ملاحظات

  • يتطلب Bedrock تمكين الوصول إلى النماذج في حساب AWS/المنطقة لديك.
  • يحتاج الاكتشاف التلقائي إلى إذن bedrock:ListFoundationModels.
  • إذا كنت تستخدم ملفات تعريف، فاضبط AWS_PROFILE على مضيف Gateway.
  • يعرض OpenClaw مصدر بيانات الاعتماد بهذا الترتيب: AWS_BEARER_TOKEN_BEDROCK، ثم AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY، ثم AWS_PROFILE، ثم سلسلة AWS SDK الافتراضية.
  • يعتمد دعم الاستدلال المنطقي على النموذج؛ راجع بطاقة نموذج Bedrock للاطلاع على الإمكانات الحالية.
  • إذا كنت تفضّل تدفّق مفاتيح مُدارًا، يمكنك أيضًا وضع وكيل متوافق مع OpenAI أمام Bedrock وتهيئته كمزوّد OpenAI بدلًا من ذلك.