الانتقال إلى المحتوى الرئيسي

Amazon Bedrock Mantle

يتضمن OpenClaw مزود Amazon Bedrock Mantle مدمجًا يتصل بنقطة نهاية Mantle المتوافقة مع OpenAI. يستضيف Mantle نماذج مفتوحة المصدر ونماذج من جهات خارجية (مثل GPT-OSS وQwen وKimi وGLM وغيرها) عبر واجهة قياسية /v1/chat/completions مدعومة ببنية Bedrock التحتية.

ما الذي يدعمه OpenClaw

  • المزود: amazon-bedrock-mantle
  • API: ‏openai-completions (متوافق مع OpenAI)
  • المصادقة: AWS_BEARER_TOKEN_BEDROCK صريح أو إنشاء bearer token من سلسلة بيانات اعتماد IAM
  • المنطقة: AWS_REGION أو AWS_DEFAULT_REGION (الافتراضي: us-east-1)

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

عندما يتم ضبط AWS_BEARER_TOKEN_BEDROCK، يستخدمه OpenClaw مباشرة. وإلا، يحاول OpenClaw إنشاء bearer token لـ Mantle من سلسلة بيانات الاعتماد الافتراضية لـ AWS، بما في ذلك ملفات بيانات الاعتماد/الإعدادات المشتركة، وSSO، وweb identity، وأدوار المثيل أو المهام. ثم يكتشف نماذج Mantle المتاحة عن طريق الاستعلام من نقطة النهاية /v1/models الخاصة بالمنطقة. تُخزَّن نتائج الاكتشاف مؤقتًا لمدة ساعة واحدة، ويتم تحديث bearer tokens المشتقة من 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.

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

  1. اختر مسار مصادقة واحدًا على gateway host:
Bearer token صريح:
export AWS_BEARER_TOKEN_BEDROCK="..."
# اختياري (الافتراضي هو us-east-1):
export AWS_REGION="us-west-2"
بيانات اعتماد IAM:
# أي مصدر مصادقة متوافق مع AWS SDK يعمل هنا، على سبيل المثال:
export AWS_PROFILE="default"
export AWS_REGION="us-west-2"
  1. تحقق من اكتشاف النماذج:
openclaw models list
تظهر النماذج المكتشفة تحت المزود amazon-bedrock-mantle. ولا يلزم أي إعداد إضافي إلا إذا كنت تريد تجاوز القيم الافتراضية.

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

إذا كنت تفضّل الإعداد الصريح بدلًا من الاكتشاف التلقائي:
{
  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,
          },
        ],
      },
    },
  },
}

ملاحظات

  • يمكن لـ OpenClaw إنشاء bearer token الخاص بـ Mantle نيابةً عنك من بيانات اعتماد IAM المتوافقة مع AWS SDK عندما لا يكون AWS_BEARER_TOKEN_BEDROCK مضبوطًا.
  • bearer token هو نفسه AWS_BEARER_TOKEN_BEDROCK المستخدم من قبل مزود Amazon Bedrock القياسي.
  • يتم استنتاج دعم الاستدلال من معرّفات النماذج التي تحتوي على أنماط مثل thinking أو reasoner أو gpt-oss-120b.
  • إذا كانت نقطة نهاية Mantle غير متاحة أو لم تُرجع أي نماذج، فسيتم تخطي المزود بصمت.