Providers
مانتل Amazon Bedrock
OpenClaw شامل ارائهدهندهٔ همراه Amazon Bedrock Mantle است که به نقطهٔ پایانی سازگار با OpenAI در Mantle متصل میشود. 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 listOpenClaw بهطور خودکار از زنجیرهٔ اعتبارنامه، توکن حامل Mantle تولید میکند.
کشف خودکار مدل
وقتی AWS_BEARER_TOKEN_BEDROCK تنظیم شده باشد، OpenClaw مستقیماً از آن استفاده میکند. در غیر این صورت، OpenClaw تلاش میکند از زنجیرهٔ پیشفرض اعتبارنامهٔ AWS یک توکن حامل Mantle تولید کند. سپس با درخواست از نقطهٔ پایانی /v1/models منطقه، مدلهای دردسترس Mantle را کشف میکند.
| رفتار | جزئیات |
|---|---|
| حافظهٔ نهان کشف | نتایج برای هر منطقه یک ساعت در حافظهٔ نهان میمانند؛ شکست دریافت، آخرین نتیجهٔ ذخیرهشده را برمیگرداند |
| نوسازی توکن 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 در ادامه، را جایگزین میکند. برای حفظ فهرست خودکار Mantle، models را حذف کنید؛ یا ورودیهای کامل مدلهای Claude موردنظرتان را در آن بگنجانید.
پیکربندی پیشرفته
پشتیبانی از استدلال
پشتیبانی از استدلال از روی شناسهٔ مدلهایی تشخیص داده میشود که شامل الگوهایی مانند thinking، reasoner، reasoning، deepseek.r، gpt-oss-120b یا gpt-oss-safeguard-120b هستند. OpenClaw هنگام کشف، برای مدلهای مطابق بهطور خودکار reasoning: true را تنظیم میکند.
دردسترسنبودن نقطهٔ پایانی
اگر نقطهٔ پایانی Mantle دردسترس نباشد، هیچ مدلی برنگرداند یا حل توکن حامل ناموفق باشد، کشف نتیجهای خالی برمیگرداند و ارائهدهندهٔ ضمنی نادیده گرفته میشود. OpenClaw خطا نمیدهد و سایر ارائهدهندگان پیکربندیشده بهطور عادی به کار ادامه میدهند.
Claude از طریق مسیر Anthropic Messages
وقتی کشف خودکار مالک فهرست مدلها باشد، OpenClaw پس از جستوجوی موفق و صرفنظر از نتیجهٔ /v1/models، چهار مدل Claude را اضافه میکند:
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).
آنها از رابط 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 محدود است. این مدل پنجرهٔ زمینهٔ ۱٬۰۰۰٬۰۰۰ توکنی و محدودیت خروجی ۱۲۸٬۰۰۰ توکنی ارائه میدهد، همیشه از تفکر تطبیقی استفاده میکند، /think off و /think minimal را به low نگاشت میکند و پارامترهای نمونهگیری انتخابشده توسط فراخوان را حذف میکند.
پیشنمایش Claude Mythos همیشه استدلال را درخواست میکند و وقتی سطحی برای /think تنظیم نشده باشد، تلاش پیشفرض آن high است (xhigh/max به high کاهش مییابد و minimal به low افزایش مییابد). Opus 4.7 در Mantle بدون استدلال ارائهشده توسط مدل جریان مییابد و OpenClaw پارامتر temperature آن را حذف میکند، زیرا Opus 4.7 در این مسیر بازنویسیهای نمونهگیری را نمیپذیرد؛ پیشنمایش Mythos بازنویسی temperature را بهطور عادی میپذیرد.
یک فهرست صریح و غیرخالی models.providers["amazon-bedrock-mantle"].models کل فهرست کشفشده را جایگزین میکند. اگر این ردیفهای داخلی Claude را میخواهید، آن فهرست را حذف کنید.
ارتباط با ارائهدهندهٔ Amazon Bedrock
Bedrock Mantle ارائهدهندهای جدا از ارائهدهندهٔ استاندارد Amazon Bedrock است. Mantle برای فهرست OSS خود از رابط سازگار با OpenAI در /v1 استفاده میکند، درحالیکه ارائهدهندهٔ استاندارد Bedrock از API بومی Bedrock Converse بهره میبرد.
در صورت وجود AWS_BEARER_TOKEN_BEDROCK، هر دو ارائهدهنده از همان اعتبارنامه استفاده میکنند.
