Providers

Amazon Bedrock Mantle

يتضمن 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` صريح أو توليد bearer token من سلسلة بيانات اعتماد IAM
المنطقة الافتراضية	`us-east-1` (يمكن تجاوزها عبر `AWS_REGION` أو `AWS_DEFAULT_REGION`)

البدء

اختر طريقة المصادقة المفضلة لديك واتبع خطوات الإعداد.

Bearer token صريح

الأفضل لـ: البيئات التي لديك فيها بالفعل Mantle bearer token.

اضبط bearer token على مضيف 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، أو web identity، أو أدوار instance أو task).

اضبط بيانات اعتماد AWS على مضيف gateway

يعمل أي مصدر مصادقة متوافق مع AWS SDK:

export AWS_PROFILE="default"
export AWS_REGION="us-west-2"

تحقّق من اكتشاف النماذج

openclaw models list

يقوم OpenClaw بتوليد Mantle bearer token من سلسلة بيانات الاعتماد تلقائيًا.

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

عندما يكون AWS_BEARER_TOKEN_BEDROCK مضبوطًا، يستخدمه OpenClaw مباشرة. وبخلاف ذلك، يحاول OpenClaw توليد Mantle bearer token من سلسلة بيانات اعتماد AWS الافتراضية. ثم يكتشف نماذج Mantle المتاحة عبر الاستعلام عن نقطة النهاية /v1/models الخاصة بالمنطقة.

السلوك	التفاصيل
ذاكرة مؤقتة للاكتشاف	يتم تخزين النتائج مؤقتًا لمدة ساعة واحدة
تحديث رمز IAM	كل ساعة

المناطق المدعومة

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

يتم استنتاج دعم reasoning من معرّفات النماذج التي تحتوي على أنماط مثل thinking أو reasoner أو gpt-oss-120b. ويضبط OpenClaw القيمة reasoning: true تلقائيًا للنماذج المطابقة أثناء الاكتشاف.

عدم توفر نقطة النهاية

إذا كانت نقطة نهاية Mantle غير متاحة أو لم تُرجع أي نماذج، فسيتم تخطي المزوّد بصمت. ولا يصدر OpenClaw خطأً؛ وتستمر المزوّدات المهيأة الأخرى في العمل بشكل طبيعي.

Claude Opus 4.7 عبر مسار Anthropic Messages

تعرض Mantle أيضًا مسار Anthropic Messages الذي ينقل نماذج Claude عبر نفس مسار البث المصادق عليه بواسطة bearer. ويمكن استدعاء Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) عبر هذا المسار مع بث مملوك للمزوّد، لذلك لا يتم التعامل مع AWS bearer tokens على أنها مفاتيح Anthropic API.

عندما تثبّت نموذج Anthropic Messages على مزوّد Mantle، يستخدم OpenClaw سطح API من نوع anthropic-messages بدلًا من openai-completions لذلك النموذج. ولا تزال المصادقة تأتي من AWS_BEARER_TOKEN_BEDROCK (أو من IAM bearer token المُنشأ).

{
  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,
          },
        ],
      },
    },
  },
}

العلاقة مع مزود Amazon Bedrock

يُعد Bedrock Mantle مزودًا منفصلًا عن مزود Amazon Bedrock القياسي. يستخدم Mantle سطح /v1 المتوافق مع OpenAI، بينما يستخدم مزود Bedrock القياسي Bedrock API الأصلية.

يشترك كلا المزوّدين في بيانات الاعتماد AWS_BEARER_TOKEN_BEDROCK نفسها عندما تكون موجودة.

ذو صلة

Amazon Bedrock

مزوّد Bedrock الأصلي لنماذج Anthropic Claude وTitan وغيرها.

اختيار النموذج

اختيار المزوّدين، ومراجع النماذج، وسلوك الرجوع الاحتياطي.

OAuth والمصادقة

تفاصيل المصادقة وقواعد إعادة استخدام بيانات الاعتماد.

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

المشكلات الشائعة وكيفية حلها.

# البدء

Bearer token صريح

اضبط bearer token على مضيف gateway

تحقّق من اكتشاف النماذج

بيانات اعتماد IAM

اضبط بيانات اعتماد AWS على مضيف gateway

تحقّق من اكتشاف النماذج

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

# المناطق المدعومة

# الإعداد اليدوي

# إعداد متقدم

# ذو صلة

البدء

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

المناطق المدعومة

الإعداد اليدوي

إعداد متقدم

ذو صلة