Providers
Amazon Bedrock Mantle
يتضمن OpenClaw موفر Amazon Bedrock Mantle مضمّنًا يتصل بنقطة نهاية Mantle المتوافقة مع OpenAI. يستضيف Mantle نماذج مفتوحة المصدر ونماذج تابعة لجهات خارجية (GPT-OSS وQwen وKimi وGLM وما شابهها) من خلال واجهة قياسية
/v1/chat/completions مدعومة ببنية Bedrock التحتية. كما يتيح Mantle نماذج Anthropic Claude عبر مسار Anthropic Messages.
| الخاصية | القيمة |
|---|---|
| معرّف الموفر | amazon-bedrock-mantle |
| API | openai-completions لنماذج OSS المكتشفة، وanthropic-messages لنماذج Claude |
| المصادقة | AWS_BEARER_TOKEN_BEDROCK صريح أو إنشاء رمز حامل عبر سلسلة بيانات اعتماد IAM |
| المنطقة الافتراضية | us-east-1 (يمكن تجاوزها باستخدام AWS_REGION أو AWS_DEFAULT_REGION) |
بدء الاستخدام
اختر طريقة المصادقة المفضلة لديك واتبع خطوات الإعداد.
رمز حامل صريح
الأنسب لـ: البيئات التي يتوفر لديك فيها بالفعل رمز حامل لـMantle.
تعيين الرمز الحامل على مضيف Gateway
export AWS_BEARER_TOKEN_BEDROCK="..."يمكنك اختياريًا تعيين منطقة (الافتراضي هو us-east-1):
export AWS_REGION="us-west-2"التحقق من اكتشاف النماذج
openclaw models listتظهر النماذج المكتشفة ضمن الموفر amazon-bedrock-mantle. لا يلزم
أي إعداد إضافي ما لم ترغب في تجاوز القيم الافتراضية.
بيانات اعتماد IAM
الأنسب لـ: استخدام بيانات اعتماد متوافقة مع AWS SDK (الإعداد المشترك وSSO وهوية الويب وأدوار المثيل أو المهمة).
إعداد بيانات اعتماد AWS على مضيف Gateway
يمكن استخدام أي مصدر مصادقة متوافق مع AWS SDK:
export AWS_PROFILE="default"export AWS_REGION="us-west-2"التحقق من اكتشاف النماذج
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, }, ], }, }, },}تكون قائمة models الصريحة وغير الفارغة هي المرجع المعتمد، وتستبدل كل
صف مكتشف، بما في ذلك صفوف Claude أدناه. احذف models للاحتفاظ بدليل
Mantle التلقائي، أو أدرج إدخالات نماذج Claude الكاملة التي تريد استخدامها.
الإعداد المتقدم
دعم الاستدلال
يُستدل على دعم الاستدلال من معرّفات النماذج التي تحتوي على أنماط مثل
thinking أو reasoner أو reasoning أو deepseek.r أو gpt-oss-120b أو
gpt-oss-safeguard-120b. يعيّن OpenClaw القيمة reasoning: true تلقائيًا
للنماذج المطابقة أثناء الاكتشاف.
عدم توفر نقطة النهاية
إذا كانت نقطة نهاية Mantle غير متاحة، أو لم تُرجع أي نماذج، أو فشل حل الرمز الحامل، فسيعيد الاكتشاف نتيجة فارغة ويُتخطى الموفر الضمني. لا يصدر OpenClaw خطأً؛ وتستمر الموفرات الأخرى المعدّة في العمل بصورة طبيعية.
Claude عبر مسار Anthropic Messages
عندما يتولى الاكتشاف التلقائي إدارة قائمة النماذج، يضيف OpenClaw أربعة
نماذج Claude بعد نجاح البحث، بغض النظر عما تعيده /v1/models:
amazon-bedrock-mantle/anthropic.claude-sonnet-5 (Claude Sonnet 5)،
وamazon-bedrock-mantle/anthropic.claude-opus-4-7 (Claude Opus 4.7)، و
amazon-bedrock-mantle/anthropic.claude-mythos-5 (Claude Mythos 5)، بالإضافة إلى
amazon-bedrock-mantle/anthropic.claude-mythos-preview (Claude Mythos
Preview). تستخدم هذه النماذج واجهة API anthropic-messages وتبث عبر
نقطة النهاية نفسها المتوافقة مع Anthropic والمصادق عليها بالرمز الحامل
(<mantle-base>/anthropic)، ولذلك لا يُعامل رمز AWS الحامل كمفتاح
API تابع لـAnthropic.
يستخدم Claude Sonnet 5 دائمًا التفكير التكيّفي، ويكون مستوى الجهد الافتراضي high.
يُعيّن /think off و/think minimal إلى low لأن مسار Mantle
لا يمكنه تعطيل التفكير. كما يحذف OpenClaw درجة الحرارة المخصصة من
طلبات Sonnet 5.
يتوفر Claude Mythos 5 بوصول محدود. ويوفر نافذة سياق بسعة 1,000,000 رمز
وحدًا أقصى للمخرجات يبلغ 128,000 رمز، ويستخدم دائمًا التفكير التكيّفي، ويعيّن
/think off و/think minimal إلى low، ويحذف معاملات
أخذ العينات التي يحددها المستدعي.
يطلب Claude Mythos Preview الاستدلال دائمًا، ويكون مستوى الجهد الافتراضي high
عند عدم تعيين مستوى /think (حيث تُخفّض xhigh/max إلى
high، وتُرفع minimal إلى low). يبث Opus 4.7 على Mantle دون
استدلال يوفره النموذج، ويحذف OpenClaw معامل temperature
الخاص به لأن Opus 4.7 لا يقبل تجاوزات أخذ العينات عبر هذا المسار؛ بينما
يقبل Mythos Preview تجاوز temperature بصورة طبيعية.
تستبدل قائمة models.providers["amazon-bedrock-mantle"].models
الصريحة وغير الفارغة دليل النماذج المكتشف بالكامل. احذف تلك القائمة عندما
تريد صفوف Claude المضمّنة هذه.
العلاقة بموفر Amazon Bedrock
يُعد Bedrock Mantle موفرًا منفصلًا عن موفر
Amazon Bedrock القياسي. يستخدم Mantle
واجهة /v1 متوافقة مع OpenAI لدليل OSS الخاص به، بينما يستخدم موفر
Bedrock القياسي واجهة Bedrock Converse API الأصلية.
يشترك كلا الموفرين في بيانات الاعتماد AWS_BEARER_TOKEN_BEDROCK نفسها عند
توفرها.
