الانتقال إلى المحتوى الرئيسي
يمكن لـ OpenClaw استخدام نماذج Amazon Bedrock عبر مزوّد البث Bedrock Converse. تستخدم مصادقة Bedrock سلسلة بيانات اعتماد AWS SDK الافتراضية، وليس مفتاح API.
الخاصيةالقيمة
المزوّدamazon-bedrock
APIbedrock-converse-stream
المصادقةبيانات اعتماد AWS (متغيرات البيئة، أو الإعدادات المشتركة، أو دور المثيل)
المنطقةAWS_REGION أو AWS_DEFAULT_REGION (الافتراضي: us-east-1)

​
البدء

اختر طريقة المصادقة المفضلة لديك واتبع خطوات الإعداد.
الأفضل لـ: أجهزة المطورين، وCI، أو المضيفين الذين تدير عليهم بيانات اعتماد AWS مباشرة.
1

Set AWS credentials on the gateway host

export AWS_ACCESS_KEY_ID="EXAMPLE_AWS_ACCESS_KEY_ID"
export AWS_SECRET_ACCESS_KEY="..."
export AWS_REGION="us-east-1"
# Optional:
export AWS_SESSION_TOKEN="..."
export AWS_PROFILE="your-profile"
# Optional (Bedrock API key/bearer token):
export AWS_BEARER_TOKEN_BEDROCK="..."
2

Add a Bedrock provider and model to your config

لا يلزم أي apiKey. اضبط المزوّد باستخدام auth: "aws-sdk":
{
  models: {
    providers: {
      "amazon-bedrock": {
        baseUrl: "https://bedrock-runtime.us-east-1.amazonaws.com",
        api: "bedrock-converse-stream",
        auth: "aws-sdk",
        models: [
          {
            id: "us.anthropic.claude-opus-4-6-v1:0",
            name: "Claude Opus 4.6 (Bedrock)",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
  agents: {
    defaults: {
      model: { primary: "amazon-bedrock/us.anthropic.claude-opus-4-6-v1:0" },
    },
  },
}
3

Verify models are available

openclaw models list
مع مصادقة علامة البيئة (AWS_ACCESS_KEY_ID أو AWS_PROFILE أو AWS_BEARER_TOKEN_BEDROCK)، يفعّل OpenClaw مزوّد Bedrock الضمني تلقائياً لاكتشاف النماذج من دون إعدادات إضافية.

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

يمكن لـ OpenClaw اكتشاف نماذج Bedrock التي تدعم البث وإخراج النص تلقائياً. يستخدم الاكتشاف bedrock:ListFoundationModels و bedrock:ListInferenceProfiles، ويتم تخزين النتائج مؤقتاً (الافتراضي: ساعة واحدة). كيفية تفعيل المزوّد الضمني:
  • إذا كانت plugins.entries.amazon-bedrock.config.discovery.enabled تساوي true، فسيحاول OpenClaw الاكتشاف حتى عند عدم وجود علامة بيئة لـ AWS.
  • إذا كانت plugins.entries.amazon-bedrock.config.discovery.enabled غير مضبوطة، فإن OpenClaw يضيف تلقائياً مزوّد Bedrock الضمني فقط عندما يرى إحدى علامات مصادقة AWS هذه: AWS_BEARER_TOKEN_BEDROCK، أو AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY، أو AWS_PROFILE.
  • لا يزال مسار مصادقة تشغيل Bedrock الفعلي يستخدم سلسلة AWS SDK الافتراضية، لذلك يمكن للإعدادات المشتركة، وSSO، ومصادقة دور المثيل عبر IMDS أن تعمل حتى عندما احتاج الاكتشاف إلى enabled: true للاشتراك.
بالنسبة إلى إدخالات models.providers["amazon-bedrock"] الصريحة، ما يزال بإمكان OpenClaw حل مصادقة علامة بيئة Bedrock مبكراً من علامات بيئة AWS مثل AWS_BEARER_TOKEN_BEDROCK من دون فرض تحميل مصادقة التشغيل الكاملة. لا يزال مسار مصادقة استدعاء النموذج الفعلي يستخدم سلسلة AWS SDK الافتراضية.
توجد خيارات الإعداد ضمن plugins.entries.amazon-bedrock.config.discovery:
{
  plugins: {
    entries: {
      "amazon-bedrock": {
        config: {
          discovery: {
            enabled: true,
            region: "us-east-1",
            providerFilter: ["anthropic", "amazon"],
            refreshInterval: 3600,
            defaultContextWindow: 32000,
            defaultMaxTokens: 4096,
          },
        },
      },
    },
  },
}
الخيارالافتراضيالوصف
enabledautoفي الوضع التلقائي، يفعّل OpenClaw مزوّد Bedrock الضمني فقط عندما يرى علامة بيئة AWS مدعومة. اضبطه على true لفرض الاكتشاف.
regionAWS_REGION / AWS_DEFAULT_REGION / us-east-1منطقة AWS المستخدمة لاستدعاءات API الخاصة بالاكتشاف.
providerFilter(الكل)يطابق أسماء مزوّدي Bedrock (مثلاً anthropic وamazon).
refreshInterval3600مدة التخزين المؤقت بالثواني. اضبطه على 0 لتعطيل التخزين المؤقت.
defaultContextWindow32000نافذة السياق المستخدمة للنماذج المكتشفة (تجاوزها إذا كنت تعرف حدود نموذجك).
defaultMaxTokens4096الحد الأقصى لرموز الإخراج المستخدمة للنماذج المكتشفة (تجاوزها إذا كنت تعرف حدود نموذجك).

​
الإعداد السريع (مسار AWS)

ينشئ هذا الدليل دور IAM، ويرفق أذونات Bedrock، ويربط ملف تعريف المثيل، ويفعّل اكتشاف OpenClaw على مضيف EC2. 
# 1. Create IAM role and instance profile
aws iam create-role --role-name EC2-Bedrock-Access \
  --assume-role-policy-document '{
    "Version": "2012-10-17",
    "Statement": [{
      "Effect": "Allow",
      "Principal": {"Service": "ec2.amazonaws.com"},
      "Action": "sts:AssumeRole"
    }]
  }'

aws iam attach-role-policy --role-name EC2-Bedrock-Access \
  --policy-arn arn:aws:iam::aws:policy/AmazonBedrockFullAccess

aws iam create-instance-profile --instance-profile-name EC2-Bedrock-Access
aws iam add-role-to-instance-profile \
  --instance-profile-name EC2-Bedrock-Access \
  --role-name EC2-Bedrock-Access

# 2. Attach to your EC2 instance
aws ec2 associate-iam-instance-profile \
  --instance-id i-xxxxx \
  --iam-instance-profile Name=EC2-Bedrock-Access

# 3. On the EC2 instance, enable discovery explicitly
openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled true
openclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1

# 4. Optional: add an env marker if you want auto mode without explicit enable
echo 'export AWS_PROFILE=default' >> ~/.bashrc
echo 'export AWS_REGION=us-east-1' >> ~/.bashrc
source ~/.bashrc

# 5. Verify models are discovered
openclaw models list

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

يكتشف OpenClaw ملفات تعريف الاستدلال الإقليمية والعالمية إلى جانب النماذج الأساسية. عندما يرتبط ملف تعريف بنموذج أساسي معروف، يرث ملف التعريف قدرات ذلك النموذج (نافذة السياق، والحد الأقصى للرموز، والاستدلال، والرؤية) ويتم حقن منطقة طلب Bedrock الصحيحة تلقائياً. يعني ذلك أن ملفات تعريف Claude العابرة للمناطق تعمل من دون تجاوزات يدوية للمزوّد.تبدو معرّفات ملفات تعريف الاستدلال مثل us.anthropic.claude-opus-4-6-v1:0 (إقليمي) أو anthropic.claude-opus-4-6-v1:0 (عالمي). إذا كان النموذج الداعم موجوداً بالفعل في نتائج الاكتشاف، يرث ملف التعريف مجموعة قدراته كاملة؛ وإلا فتُطبّق افتراضات آمنة.لا يلزم أي إعداد إضافي. طالما أن الاكتشاف مفعّل وأن أصل IAM يمتلك bedrock:ListInferenceProfiles، تظهر ملفات التعريف إلى جانب النماذج الأساسية في openclaw models list.
تدعم بعض نماذج Bedrock وسيط service_tier لتحسين التكلفة أو زمن الاستجابة. تتوفر المستويات التالية:
المستوىالوصف
defaultمستوى Bedrock القياسي
flexمعالجة مخفضة التكلفة لأعباء العمل التي يمكنها تحمل زمن استجابة أطول
priorityمعالجة ذات أولوية لأعباء العمل الحساسة لزمن الاستجابة
reservedسعة محجوزة لأعباء العمل المستقرة
اضبط serviceTier (أو service_tier) عبر agents.defaults.params لطلبات نماذج Bedrock، أو لكل نموذج في agents.defaults.models["<model-key>"].params:
{
  agents: {
    defaults: {
      params: {
        serviceTier: "flex", // applies to all models
      },
      models: {
        "amazon-bedrock/mistral.mistral-large-3-675b-instruct": {
          params: {
            serviceTier: "priority", // per-model override
          },
        },
      },
    },
  },
}
القيم الصالحة هي default وflex وpriority وreserved. لا تدعم كل النماذج جميع المستويات؛ إذا طُلب مستوى غير مدعوم، فسيعيد Bedrock خطأ تحقق. ملاحظة: رسالة الخطأ مضللة إلى حد ما؛ قد تقول “The provided model identifier is invalid” بدلاً من الإشارة إلى مستوى خدمة غير مدعوم. إذا رأيت هذا الخطأ، فتحقق مما إذا كان النموذج يدعم المستوى المطلوب.
يرفض Bedrock وسيط temperature لـ Claude Opus 4.7. يحذف OpenClaw temperature تلقائياً لأي مرجع Bedrock من Opus 4.7، بما في ذلك معرّفات النماذج الأساسية، وملفات تعريف الاستدلال المسماة، وملفات تعريف استدلال التطبيقات التي يُحل نموذجها الأساسي إلى Opus 4.7 عبر bedrock:GetInferenceProfile، ومتغيرات opus-4.7 المنقوطة ذات بادئات المناطق الاختيارية (us. وeu. وap. وapac. وau. وjp. و global.). لا يلزم أي خيار إعداد، وينطبق الحذف على كل من كائن خيارات الطلب وحقل حمولة inferenceConfig.
استخدم amazon-bedrock/anthropic.claude-fable-5 في us-east-1، أو معرّفات الاستدلال الإقليمية مثل us.anthropic.claude-fable-5. يطبّق OpenClaw نافذة سياق Fable البالغة 1M، وحد إخراج 128K، والتفكير التكيّفي الدائم التشغيل، وتعيين الجهد المدعوم. يتم تعيين /think off و /think minimal إلى low؛ ويتم حذف عناصر التحكم غير المدعومة في درجة الحرارة واختيار الأداة القسري. يُحتفظ بالإخراج المتدفق حتى يعيد Bedrock حالة نهائية كي لا تكشف حالات الرفض في منتصف التدفق نصا جزئيا. يدعم Fable فئة الخدمة القياسية فقط؛ يتجاهل OpenClaw فئات flex وpriority وreserved المكوّنة لهذا النموذج.تتطلب AWS اشتراكا صريحا في الاحتفاظ بالبيانات عبر provider_data_share قبل إتاحة Fable. تتم مشاركة المطالبات والإكمالات مع Anthropic والاحتفاظ بها لمدة تصل إلى 30 يوما لأغراض الثقة والسلامة. راجع واضبط الاحتفاظ ببيانات Bedrock قبل تمكين النموذج.
يمكنك تطبيق حواجز حماية Amazon Bedrock على جميع استدعاءات نماذج Bedrock بإضافة كائن guardrail إلى إعدادات Plugin amazon-bedrock. تتيح لك حواجز الحماية فرض تصفية المحتوى، ورفض الموضوعات، ومرشحات الكلمات، ومرشحات المعلومات الحساسة، وفحوصات الإسناد السياقي.
{
  plugins: {
    entries: {
      "amazon-bedrock": {
        config: {
          guardrail: {
            guardrailIdentifier: "abc123", // guardrail ID or full ARN
            guardrailVersion: "1", // version number or "DRAFT"
            streamProcessingMode: "sync", // optional: "sync" or "async"
            trace: "enabled", // optional: "enabled", "disabled", or "enabled_full"
          },
        },
      },
    },
  },
}
الخيارمطلوبالوصف
guardrailIdentifierنعممعرّف حاجز الحماية (مثل abc123) أو ARN كامل (مثل arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123).
guardrailVersionنعمرقم الإصدار المنشور، أو "DRAFT" للمسودة قيد العمل.
streamProcessingModeلا"sync" أو "async" لتقييم حاجز الحماية أثناء البث. إذا حُذف، يستخدم Bedrock القيمة الافتراضية لديه.
traceلا"enabled" أو "enabled_full" لتصحيح الأخطاء؛ احذفه أو عيّنه إلى "disabled" للإنتاج.
يجب أن يمتلك كيان IAM الأساسي الذي يستخدمه Gateway إذن bedrock:ApplyGuardrail بالإضافة إلى أذونات الاستدعاء القياسية.
يمكن أن يعمل Bedrock أيضا مزودا للتضمينات من أجل بحث الذاكرة. يتم تكوين هذا بشكل منفصل عن مزود الاستدلال — عيّن agents.defaults.memorySearch.provider إلى "bedrock":
{
  agents: {
    defaults: {
      memorySearch: {
        provider: "bedrock",
        model: "amazon.titan-embed-text-v2:0", // default
      },
    },
  },
}
تستخدم تضمينات Bedrock سلسلة بيانات اعتماد AWS SDK نفسها المستخدمة للاستدلال (أدوار المثيلات، وSSO، ومفاتيح الوصول، والإعدادات المشتركة، وهوية الويب). لا يلزم مفتاح API. عيّن memorySearch.provider: "bedrock" صراحة لاستخدام تضمينات Bedrock.تشمل نماذج التضمين المدعومة Amazon Titan Embed (v1، v2)، وAmazon Nova Embed، وCohere Embed (v3، v4)، وTwelveLabs Marengo. راجع مرجع إعدادات الذاكرة — Bedrock للحصول على قائمة النماذج الكاملة وخيارات الأبعاد.
  • يتطلب Bedrock تمكين الوصول إلى النماذج في حسابك/منطقتك على AWS.
  • يحتاج الاكتشاف التلقائي إلى إذني bedrock:ListFoundationModels و bedrock:ListInferenceProfiles.
  • إذا كنت تعتمد على الوضع التلقائي، فعيّن إحدى علامات بيئة مصادقة AWS المدعومة على مضيف Gateway. إذا كنت تفضل مصادقة IMDS/الإعدادات المشتركة دون علامات بيئة، فعيّن plugins.entries.amazon-bedrock.config.discovery.enabled: true.
  • يعرض OpenClaw مصدر بيانات الاعتماد بهذا الترتيب: AWS_BEARER_TOKEN_BEDROCK، ثم AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY، ثم AWS_PROFILE، ثم سلسلة AWS SDK الافتراضية.
  • يعتمد دعم الاستدلال على النموذج؛ تحقق من بطاقة نموذج Bedrock لمعرفة القدرات الحالية.
  • إذا كنت تفضل تدفق مفاتيح مُدارا، يمكنك أيضا وضع وكيل متوافق مع OpenAI أمام Bedrock وتكوينه بدلا من ذلك كمزود OpenAI.

​
ذات صلة

Model selection

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

Memory search

تضمينات Bedrock لإعداد بحث الذاكرة.

Memory config reference

قائمة نماذج تضمين Bedrock الكاملة وخيارات الأبعاد.

Troubleshooting

استكشاف الأخطاء وإصلاحها العام والأسئلة الشائعة.