Providers

لایهٔ Amazon Bedrock

OpenClaw شامل ارائه‌دهنده داخلی Amazon Bedrock Mantle است که به نقطه پایانی سازگار با OpenAI مربوط به Mantle متصل می‌شود. 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

bash

export AWS_BEARER_TOKEN_BEDROCK="..."

در صورت تمایل یک منطقه تنظیم کنید (پیش‌فرض us-east-1 است):

bash

export AWS_REGION="us-west-2"

Verify models are discovered

bash

openclaw models list

مدل‌های کشف‌شده زیر ارائه‌دهنده amazon-bedrock-mantle نمایش داده می‌شوند. هیچ پیکربندی اضافی لازم نیست مگر اینکه بخواهید پیش‌فرض‌ها را بازنویسی کنید.

IAM credentials

بهترین برای: استفاده از اعتبارنامه‌های سازگار با AWS SDK (پیکربندی مشترک، SSO، هویت وب، نقش‌های نمونه یا وظیفه).

Configure AWS credentials on the gateway host

هر منبع احراز هویت سازگار با AWS SDK کار می‌کند:

bash

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

Verify models are discovered

bash

openclaw models list

OpenClaw به‌طور خودکار از زنجیره اعتبارنامه یک توکن حامل Mantle تولید می‌کند.

کشف خودکار مدل

وقتی AWS_BEARER_TOKEN_BEDROCK تنظیم شده باشد، OpenClaw مستقیماً از آن استفاده می‌کند. در غیر این صورت، OpenClaw تلاش می‌کند از زنجیره اعتبارنامه پیش‌فرض AWS یک توکن حامل Mantle تولید کند. سپس با پرس‌وجو از نقطه پایانی /v1/models منطقه، مدل‌های Mantle در دسترس را کشف می‌کند.

رفتار	جزئیات
کش کشف	نتایج برای ۱ ساعت کش می‌شوند
نوسازی توکن IAM	ساعتی

برای فعال نگه داشتن Plugin مربوط به Mantle اما غیرفعال کردن کشف خودکار و تولید توکن حامل IAM، گزینه کشف متعلق به Plugin را غیرفعال کنید:

bash

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.

پیکربندی دستی

اگر به‌جای کشف خودکار، پیکربندی صریح را ترجیح می‌دهید:

json5

{  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 مانند کلیدهای API Anthropic در نظر گرفته نمی‌شوند.

وقتی یک مدل Anthropic Messages را روی ارائه‌دهنده Mantle پین می‌کنید، OpenClaw برای آن مدل به‌جای openai-completions از سطح API با نام anthropic-messages استفاده می‌کند. احراز هویت همچنان از AWS_BEARER_TOKEN_BEDROCK (یا توکن حامل IAM ایجادشده) می‌آید.

json5

{  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 از API بومی Bedrock استفاده می‌کند.

هر دو ارائه‌دهنده در صورت وجود، از اعتبارنامه AWS_BEARER_TOKEN_BEDROCK مشترک استفاده می‌کنند.

مرتبط

Amazon Bedrock

ارائه‌دهنده بومی Bedrock برای Anthropic Claude، Titan و مدل‌های دیگر.

Model selection

انتخاب ارائه‌دهندگان، ارجاع‌های مدل، و رفتار جایگزینی در زمان خرابی.

OAuth and auth

جزئیات احراز هویت و قواعد استفاده دوباره از اعتبارنامه.

Troubleshooting

مشکلات رایج و روش رفع آن‌ها.

Was this useful?