Providers
طبقة Amazon Bedrock
يتضمن OpenClaw موفر Amazon Bedrock Mantle المضمّن الذي يتصل
بنقطة نهاية Mantle المتوافقة مع OpenAI. يستضيف Mantle نماذج مفتوحة المصدر
ونماذج جهات خارجية (GPT-OSS وQwen وKimi وGLM وما شابهها) عبر سطح قياسي
/v1/chat/completions مدعوم ببنية Bedrock التحتية.
| الخاصية | القيمة |
|---|---|
| معرف الموفر | amazon-bedrock-mantle |
| API | openai-completions (متوافق مع OpenAI) أو anthropic-messages (مسار Anthropic Messages) |
| المصادقة | AWS_BEARER_TOKEN_BEDROCK صريح أو إنشاء رمز حامل عبر سلسلة بيانات اعتماد IAM |
| المنطقة الافتراضية | us-east-1 (تجاوزها باستخدام AWS_REGION أو AWS_DEFAULT_REGION) |
البدء
اختر طريقة المصادقة المفضلة لديك واتبع خطوات الإعداد.
Explicit bearer token
الأفضل لـ: البيئات التي لديك فيها بالفعل رمز حامل Mantle.
Set the bearer token on the gateway host
export AWS_BEARER_TOKEN_BEDROCK="..."يمكنك اختياريًا تعيين منطقة (الافتراضي هو us-east-1):
export AWS_REGION="us-west-2"Verify models are discovered
openclaw models listتظهر النماذج المكتشفة ضمن موفر amazon-bedrock-mantle. لا يلزم
إعداد إضافي ما لم تكن تريد تجاوز الإعدادات الافتراضية.
IAM credentials
الأفضل لـ: استخدام بيانات اعتماد متوافقة مع AWS SDK (إعداد مشترك، SSO، هوية ويب، أدوار مثيل أو مهمة).
Configure AWS credentials on the gateway host
يعمل أي مصدر مصادقة متوافق مع AWS SDK:
export AWS_PROFILE="default"export AWS_REGION="us-west-2"Verify models are discovered
openclaw models listينشئ OpenClaw رمز حامل Mantle من سلسلة بيانات الاعتماد تلقائيًا.
الاكتشاف التلقائي للنماذج
عند تعيين AWS_BEARER_TOKEN_BEDROCK، يستخدمه OpenClaw مباشرة. بخلاف ذلك،
يحاول OpenClaw إنشاء رمز حامل Mantle من سلسلة بيانات اعتماد AWS الافتراضية.
ثم يكتشف نماذج Mantle المتاحة عبر الاستعلام عن نقطة نهاية
/v1/models الخاصة بالمنطقة.
| السلوك | التفاصيل |
|---|---|
| ذاكرة التخزين المؤقت للاكتشاف | تُخزّن النتائج مؤقتًا لمدة ساعة واحدة |
| تحديث رمز IAM | كل ساعة |
لإبقاء Plugin Mantle مفعّلًا مع تعطيل الاكتشاف التلقائي وإنشاء رمز الحامل عبر IAM، عطّل مفتاح الاكتشاف المملوك للـ Plugin:
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled falseالمناطق المدعومة
us-east-1, us-east-2, us-west-2, ap-northeast-1,
ap-south-1, ap-southeast-3, eu-central-1, eu-west-1, eu-west-2,
eu-south-1, eu-north-1, sa-east-1.
الإعداد اليدوي
إذا كنت تفضل إعدادًا صريحًا بدلًا من الاكتشاف التلقائي:
{ models: { providers: { "amazon-bedrock-mantle": { baseUrl: "https://bedrock-mantle.us-east-1.api.aws/v1", api: "openai-completions", auth: "api-key", apiKey: "env:AWS_BEARER_TOKEN_BEDROCK", models: [ { id: "gpt-oss-120b", name: "GPT-OSS 120B", reasoning: true, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 32000, maxTokens: 4096, }, ], }, }, },}الإعداد المتقدم
Reasoning support
يُستنتج دعم الاستدلال من معرفات النماذج التي تحتوي على أنماط مثل
thinking أو reasoner أو gpt-oss-120b. يعيّن OpenClaw القيمة reasoning: true
تلقائيًا للنماذج المطابقة أثناء الاكتشاف.
Endpoint unavailability
إذا كانت نقطة نهاية Mantle غير متاحة أو لم تُرجع أي نماذج، فيتم تخطي الموفر بصمت. لا يُظهر OpenClaw خطأ؛ وتواصل الموفرات الأخرى المعدّة العمل بشكل طبيعي.
Claude Opus 4.7 via the Anthropic Messages route
يوفّر Mantle أيضًا مسار Anthropic Messages الذي ينقل نماذج Claude عبر مسار البث نفسه المصادق عليه برمز حامل. يمكن استدعاء Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) عبر هذا المسار باستخدام بث مملوك للموفر، لذلك لا تُعامل رموز AWS الحاملة مثل مفاتيح Anthropic API.
عند تثبيت نموذج Anthropic Messages على موفر Mantle، يستخدم OpenClaw سطح API anthropic-messages بدلًا من openai-completions لذلك النموذج. لا تزال المصادقة تأتي من AWS_BEARER_TOKEN_BEDROCK (أو رمز حامل IAM المُصدر).
{ models: { providers: { "amazon-bedrock-mantle": { models: [ { id: "claude-opus-4.7", name: "Claude Opus 4.7", api: "anthropic-messages", reasoning: true, input: ["text", "image"], contextWindow: 1000000, maxTokens: 32000, }, ], }, }, },}Relationship to Amazon Bedrock provider
Bedrock Mantle موفر منفصل عن موفر
Amazon Bedrock القياسي. يستخدم Mantle سطح
/v1 متوافقًا مع OpenAI، بينما يستخدم موفر Bedrock القياسي
Bedrock API الأصلي.
يشترك كلا الموفرين في بيانات اعتماد AWS_BEARER_TOKEN_BEDROCK نفسها عند
وجودها.