الانتقال إلى المحتوى الرئيسي
يتضمن OpenClaw مزود Amazon Bedrock Mantle مضمنا يتصل بنقطة نهاية Mantle المتوافقة مع OpenAI. يستضيف Mantle نماذج مفتوحة المصدر ونماذج من جهات خارجية (GPT-OSS وQwen وKimi وGLM وما شابه) عبر سطح قياسي /v1/chat/completions مدعوم ببنية Bedrock التحتية.
الخاصيةالقيمة
معرف المزودamazon-bedrock-mantle
APIopenai-completions (متوافق مع OpenAI) أو anthropic-messages (مسار Anthropic Messages)
المصادقةAWS_BEARER_TOKEN_BEDROCK صريح أو توليد رمز حامل عبر سلسلة بيانات اعتماد IAM
المنطقة الافتراضيةus-east-1 (تجاوزها باستخدام AWS_REGION أو AWS_DEFAULT_REGION)

بدء الاستخدام

اختر طريقة المصادقة المفضلة لديك واتبع خطوات الإعداد.
الأفضل لـ: البيئات التي لديك فيها مسبقا رمز Mantle حامل.
1

اضبط الرمز الحامل على مضيف Gateway

export AWS_BEARER_TOKEN_BEDROCK="..."
يمكنك اختياريا ضبط منطقة (الافتراضي هو us-east-1):
export AWS_REGION="us-west-2"
2

اشترك في مشاركة بيانات المزود لـ Claude Fable 5

تتطلب نماذج Claude Fable 5 ونماذج Bedrock من فئة Claude Mythos وضع Mantle Data Retention API ‏provider_data_share قبل الاستدعاء. يتيح هذا الاشتراك لـ Bedrock مشاركة المطالبات والإكمالات مع Anthropic والاحتفاظ بها لمدة تصل إلى 30 يوما لمراجعة الثقة والسلامة.
AWS_REGION="${AWS_REGION:-us-east-1}"
curl -X PUT "https://bedrock-mantle.${AWS_REGION}.api.aws/v1/data_retention" \
  -H "Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "provider_data_share" }'
استخدم نموذج Bedrock آخر في الإعدادات إذا لم تتمكن من قبول وضع الاحتفاظ هذا.
3

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

openclaw models list
تظهر النماذج المكتشفة تحت مزود amazon-bedrock-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
الرمز الحامل هو نفسه AWS_BEARER_TOKEN_BEDROCK المستخدم بواسطة مزود Amazon Bedrock القياسي.

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

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

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

يتم استنتاج دعم الاستدلال من معرفات النماذج التي تحتوي على أنماط مثل thinking أو reasoner أو gpt-oss-120b. يضبط OpenClaw ‏reasoning: true تلقائيا للنماذج المطابقة أثناء الاكتشاف.
إذا لم تكن نقطة نهاية Mantle متاحة أو لم تُرجع أي نماذج، يتم تخطي المزود بصمت. لا يصدر OpenClaw خطأ؛ وتواصل المزودات الأخرى المكوّنة العمل بشكل طبيعي.
يعرّض 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,
          },
        ],
      },
    },
  },
}
Bedrock Mantle هو مزود منفصل عن مزود Amazon Bedrock القياسي. يستخدم Mantle سطح /v1 متوافقا مع OpenAI، بينما يستخدم مزود Bedrock القياسي Bedrock API الأصلي.يشترك كلا المزودين في بيانات الاعتماد نفسها AWS_BEARER_TOKEN_BEDROCK عند توفرها.

ذات صلة

Amazon Bedrock

مزود Bedrock الأصلي لـ Anthropic Claude وTitan ونماذج أخرى.

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

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

OAuth والمصادقة

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

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

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