Providers
Amazon Bedrock
OpenClaw میتواند از مدلهای Amazon Bedrock از طریق ارائهدهندهٔ جریانی Bedrock Converse استفاده کند. احراز هویت Bedrock از زنجیرهٔ پیشفرض اعتبارنامههای AWS SDK استفاده میکند، نه از کلید API.
| ویژگی | مقدار |
|---|---|
| ارائهدهنده | amazon-bedrock |
| API | bedrock-converse-stream |
| احراز هویت | اعتبارنامههای AWS (متغیرهای محیطی، پیکربندی مشترک یا نقش نمونه) |
| منطقه | AWS_REGION یا AWS_DEFAULT_REGION (پیشفرض: us-east-1) |
شروع به کار
روش احراز هویت ترجیحی خود را انتخاب کنید و مراحل راهاندازی را دنبال کنید.
کلیدهای دسترسی / متغیرهای محیطی
مناسب برای: دستگاههای توسعهدهندگان، CI یا میزبانهایی که اعتبارنامههای AWS را مستقیماً در آنها مدیریت میکنید.
تنظیم اعتبارنامههای AWS روی میزبان Gateway
export AWS_ACCESS_KEY_ID="EXAMPLE_AWS_ACCESS_KEY_ID"export AWS_SECRET_ACCESS_KEY="..."export AWS_REGION="us-east-1"# Optional:export AWS_SESSION_TOKEN="..."export AWS_PROFILE="your-profile"# Optional (Bedrock API key/bearer token):export AWS_BEARER_TOKEN_BEDROCK="..."افزودن ارائهدهنده و مدل Bedrock به پیکربندی
نیازی به apiKey نیست. ارائهدهنده را با auth: "aws-sdk" پیکربندی کنید:
{ models: { providers: { "amazon-bedrock": { baseUrl: "https://bedrock-runtime.us-east-1.amazonaws.com", api: "bedrock-converse-stream", auth: "aws-sdk", models: [ { id: "us.anthropic.claude-opus-4-6-v1:0", name: "Claude Opus 4.6 (Bedrock)", reasoning: true, input: ["text", "image"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 200000, maxTokens: 8192, }, ], }, }, }, agents: { defaults: { model: { primary: "amazon-bedrock/us.anthropic.claude-opus-4-6-v1:0" }, }, },}بررسی در دسترس بودن مدلها
openclaw models listنقشهای نمونهٔ EC2 (IMDS)
مناسب برای: نمونههای EC2 دارای نقش IAM متصل که از سرویس فرادادهٔ نمونه برای احراز هویت استفاده میکنند.
فعالسازی صریح کشف
هنگام استفاده از IMDS، OpenClaw نمیتواند احراز هویت AWS را صرفاً از نشانگرهای محیطی تشخیص دهد؛ بنابراین باید صریحاً آن را فعال کنید:
openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1افزودن اختیاری نشانگر محیطی برای حالت خودکار
اگر میخواهید مسیر تشخیص خودکار نشانگر محیطی نیز کار کند (برای مثال، در نماهای openclaw status):
export AWS_PROFILE=defaultexport AWS_REGION=us-east-1به کلید API جعلی نیازی ندارید.
بررسی کشف شدن مدلها
openclaw models listکشف خودکار مدلها
OpenClaw میتواند مدلهای Bedrock را که از جریاندهی
و خروجی متنی پشتیبانی میکنند، بهطور خودکار کشف کند. کشف از bedrock:ListFoundationModels و
bedrock:ListInferenceProfiles استفاده میکند و نتایج در حافظهٔ نهان ذخیره میشوند (پیشفرض: ۱ ساعت).
نحوهٔ فعال شدن ارائهدهندهٔ ضمنی:
- اگر
plugins.entries.amazon-bedrock.config.discovery.enabledبرابرtrueباشد، OpenClaw حتی در نبود نشانگر محیطی AWS نیز کشف را امتحان میکند. - اگر
plugins.entries.amazon-bedrock.config.discovery.enabledتنظیم نشده باشد، OpenClaw فقط زمانی ارائهدهندهٔ ضمنی Bedrock را بهطور خودکار اضافه میکند که یکی از این نشانگرهای احراز هویت AWS را ببیند:AWS_BEARER_TOKEN_BEDROCK، ترکیبAWS_ACCESS_KEY_IDوAWS_SECRET_ACCESS_KEY، یاAWS_PROFILE. - مسیر واقعی احراز هویت زمان اجرای Bedrock همچنان از زنجیرهٔ پیشفرض AWS SDK استفاده میکند؛ بنابراین
پیکربندی مشترک، SSO و احراز هویت نقش نمونه از طریق IMDS میتوانند حتی زمانی کار کنند که برای فعالسازی
کشف، تنظیم
enabled: trueلازم بوده است.
گزینههای پیکربندی کشف
گزینههای پیکربندی در plugins.entries.amazon-bedrock.config.discovery قرار دارند:
{ plugins: { entries: { "amazon-bedrock": { config: { discovery: { enabled: true, region: "us-east-1", providerFilter: ["anthropic", "amazon"], refreshInterval: 3600, defaultContextWindow: 32000, defaultMaxTokens: 4096, }, }, }, }, },}| گزینه | پیشفرض | توضیح |
|---|---|---|
enabled |
خودکار | در حالت خودکار، OpenClaw فقط زمانی ارائهدهندهٔ ضمنی Bedrock را فعال میکند که یک نشانگر محیطی پشتیبانیشدهٔ AWS را ببیند. برای اجبار به کشف، آن را روی true تنظیم کنید. |
region |
AWS_REGION / AWS_DEFAULT_REGION / us-east-1 |
منطقهٔ AWS مورداستفاده برای فراخوانیهای API کشف. |
providerFilter |
(همه) | با نام ارائهدهندگان Bedrock مطابقت میدهد (برای مثال anthropic و amazon). |
refreshInterval |
3600 |
مدت نگهداری حافظهٔ نهان برحسب ثانیه. برای غیرفعال کردن ذخیرهسازی در حافظهٔ نهان، روی 0 تنظیم کنید. |
defaultContextWindow |
32000 |
پنجرهٔ زمینهٔ مورداستفاده برای مدلهای کشفشدهای که محدودیت توکن شناختهشدهای ندارند (اگر محدودیتهای مدل خود را میدانید، آن را بازنویسی کنید). |
defaultMaxTokens |
4096 |
حداکثر توکنهای خروجی مورداستفاده برای مدلهای کشفشدهای که محدودیت توکن شناختهشدهای ندارند (اگر محدودیتهای مدل خود را میدانید، آن را بازنویسی کنید). |
محدودیتهای پنجرهٔ زمینه و حداکثر توکن
APIهای ListFoundationModels و GetFoundationModel در Bedrock هیچ
فرادادهای دربارهٔ محدودیت توکن برنمیگردانند و فقط شناسهٔ مدل، نام، شیوهها و وضعیت
چرخهٔ عمر را ارائه میکنند. OpenClaw همراه با یک جدول جستوجو برای پنجرههای زمینه و محدودیتهای
خروجی شناختهشدهٔ مدلهای محبوب Bedrock (Claude، Nova، Llama، Mistral، DeepSeek
و مدلهای دیگر) عرضه میشود تا مدیریت نشست، آستانههای Compaction و
تشخیص سرریز زمینه برای این مدلها بهدرستی کار کنند.
مدلهای کشفشدهای که در جدول نیستند، از defaultContextWindow
و defaultMaxTokens استفاده میکنند. اگر مدل مورداستفادهٔ شما محدودیتهای دقیقی ندارد،
آن را با یک ورودی صریح در
models.providers["amazon-bedrock"].models بازنویسی کنید.
راهاندازی سریع (مسیر AWS)
این راهنما یک نقش IAM ایجاد میکند، مجوزهای Bedrock را به آن متصل میکند، نمایهٔ نمونه را مرتبط میسازد و کشف OpenClaw را روی میزبان EC2 فعال میکند.
# 1. Create IAM role and instance profileaws iam create-role --role-name EC2-Bedrock-Access \ --assume-role-policy-document '{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Principal": {"Service": "ec2.amazonaws.com"}, "Action": "sts:AssumeRole" }] }' aws iam attach-role-policy --role-name EC2-Bedrock-Access \ --policy-arn arn:aws:iam::aws:policy/AmazonBedrockFullAccess aws iam create-instance-profile --instance-profile-name EC2-Bedrock-Accessaws iam add-role-to-instance-profile \ --instance-profile-name EC2-Bedrock-Access \ --role-name EC2-Bedrock-Access # 2. Attach to your EC2 instanceaws ec2 associate-iam-instance-profile \ --instance-id i-xxxxx \ --iam-instance-profile Name=EC2-Bedrock-Access # 3. On the EC2 instance, enable discovery explicitlyopenclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1 # 4. Optional: add an env marker if you want auto mode without explicit enableecho 'export AWS_PROFILE=default' >> ~/.bashrcecho 'export AWS_REGION=us-east-1' >> ~/.bashrcsource ~/.bashrc # 5. Verify models are discoveredopenclaw models listپیکربندی پیشرفته
نمایههای استنتاج
OpenClaw در کنار مدلهای پایه، نمایههای استنتاج منطقهای و سراسری را نیز
کشف میکند. هنگامی که یک نمایه به مدل پایهای شناختهشده نگاشت شود،
قابلیتهای آن مدل (پنجرهٔ زمینه، حداکثر توکنها، استدلال و بینایی) را به ارث میبرد
و منطقهٔ صحیح درخواست Bedrock بهطور خودکار
اعمال میشود. این یعنی نمایههای میانمنطقهای Claude بدون بازنویسی دستی
ارائهدهنده کار میکنند. نمایههای میانمنطقهای سراسری (global.*) در
openclaw models list ابتدا نمایش داده میشوند، زیرا معمولاً ظرفیت بهتر
و جایگزینی خودکار هنگام خرابی را فراهم میکنند.
شناسههای نمایهٔ استنتاج بهشکل us.anthropic.claude-opus-4-6-v1:0 (منطقهای)
یا anthropic.claude-opus-4-6-v1:0 (سراسری) هستند. اگر مدل زیربنایی از قبل
در نتایج کشف موجود باشد، نمایه مجموعهٔ کامل قابلیتهای آن را به ارث میبرد؛
در غیر این صورت، پیشفرضهای امن اعمال میشوند.
به پیکربندی اضافی نیازی نیست. تا زمانی که کشف فعال باشد و هویت IAM
دارای مجوز bedrock:ListInferenceProfiles باشد، نمایهها در کنار
مدلهای پایه در openclaw models list ظاهر میشوند.
ردهٔ سرویس
برخی مدلهای Bedrock از پارامتر service_tier برای بهینهسازی هزینه
یا تأخیر پشتیبانی میکنند. ردههای زیر در دسترس هستند:
| رده | توضیح |
|---|---|
default |
ردهٔ استاندارد Bedrock |
flex |
پردازش با تخفیف برای بارهای کاری که میتوانند تأخیر بیشتر را تحمل کنند |
priority |
پردازش اولویتدار برای بارهای کاری حساس به تأخیر |
reserved |
ظرفیت رزروشده برای بارهای کاری پایدار |
برای درخواستهای مدل Bedrock، serviceTier (یا service_tier) را از طریق
agents.defaults.params یا برای هر مدل در
agents.defaults.models["<model-key>"].params تنظیم کنید:
{ agents: { defaults: { params: { serviceTier: "flex", // applies to all models }, models: { "amazon-bedrock/mistral.mistral-large-3-675b-instruct": { params: { serviceTier: "priority", // per-model override }, }, }, }, },}مقادیر معتبر عبارتاند از default، flex، priority و reserved. Claude
Fable 5 و Sonnet 5 فقط از سطح default پشتیبانی میکنند؛ OpenClaw در صورت
درخواست flex، priority یا reserved برای این مدلها هشدار میدهد و
آن را نادیده میگیرد. برای مدلهای دیگر نیز همهٔ مدلها از همهٔ سطوح
پشتیبانی نمیکنند -- یک سطح پشتیبانینشده خطای اعتبارسنجی Bedrock برمیگرداند
و پیام خطا ممکن است گمراهکننده باشد (برای مثال، بهجای اشاره به سطح بهعنوان
مشکل، میگوید «شناسهٔ مدل ارائهشده نامعتبر است»). اگر این خطا را مشاهده
کردید، بررسی کنید که آیا مدل از سطح درخواستی پشتیبانی میکند.
دمای Claude Opus 4.7 و 4.8
Bedrock پارامتر temperature را برای Claude Opus 4.7 و Opus 4.8 رد
میکند. OpenClaw برای هر ارجاع منطبق Bedrock، temperature را بهطور
خودکار حذف میکند؛ از جمله شناسههای مدل پایه، پروفایلهای استنتاج نامگذاریشده،
پروفایلهای استنتاج برنامه که مدل زیربنایی آنها از طریق
bedrock:GetInferenceProfile به Opus 4.7/4.8 تفکیک میشود، و گونههای
نقطهدار opus-4.7/opus-4.8 با پیشوندهای اختیاری منطقه (us.، eu.،
ap.، apac.، au.، jp.، global.). هیچ گزینهٔ پیکربندیای لازم نیست
و این حذف هم روی شیء گزینههای درخواست و هم روی فیلد بارِ inferenceConfig
اعمال میشود.
Claude Fable 5
از amazon-bedrock/anthropic.claude-fable-5 در us-east-1 یا شناسههای
استنتاج منطقهای مانند us.anthropic.claude-fable-5 استفاده کنید.
OpenClaw پنجرهٔ زمینهٔ ۱ میلیونی Fable، محدودیت خروجی ۱۲۸ هزار توکنی،
تفکر تطبیقی هموارهفعال و نگاشت تلاش پشتیبانیشدهٔ آن را اعمال میکند.
/think off و /think minimal به low نگاشت میشوند؛ کنترلهای دما و
انتخاب اجباری ابزار نیز، مطابق مسیر Opus 4.7/4.8، حذف میشوند. خروجی
جریانی تا زمانی که Bedrock یک وضعیت پایانی برگرداند نگه داشته میشود تا
رد درخواست در میانهٔ جریان، متن ناقص را آشکار نکند.
پیش از در دسترس قرار گرفتن Fable، AWS به اعلام رضایت صریح
provider_data_share برای نگهداری داده نیاز دارد. درخواستها و پاسخهای
تکمیلشده با Anthropic به اشتراک گذاشته میشوند و برای اعتماد و ایمنی تا
۳۰ روز نگهداری میشوند. پیش از فعالسازی مدل، نگهداری داده در Bedrock
را بررسی و پیکربندی کنید.
Claude Mythos 5
Claude Mythos 5 از طریق Bedrock فقط برای حسابهایی در دسترس است که تأییدیهٔ
دسترسی محدود لازم را دارند. OpenClaw مدل پایهٔ anthropic.claude-mythos-5
و پروفایلهای استنتاج منطقهای یا سراسری مانند
us.anthropic.claude-mythos-5 را شناسایی میکند.
OpenClaw پنجرهٔ زمینهٔ ۱٬۰۰۰٬۰۰۰ توکنی، محدودیت خروجی ۱۲۸٬۰۰۰ توکنی،
ورودی تصویر، ذخیرهسازی موقت درخواست، جریان ایمن در برابر رد درخواست و
سطوح تلاش بومی را اعمال میکند. تفکر تطبیقی همیشه فعال است: /think off
و /think minimal به low نگاشت میشوند، درحالیکه xhigh و max
همچنان در دسترساند. مقادیر نمونهبرداری سفارشی و انتخاب اجباری ابزار حذف
میشوند.
Claude Sonnet 5
AWS استفاده از Sonnet 5 را برای هر دو نقطهٔ پایانی
bedrock-runtime و bedrock-mantle
مستند کرده است. OpenClaw مدل پایهٔ Bedrock با شناسهٔ
anthropic.claude-sonnet-5 و پروفایلهای استنتاج منطقهای یا سراسری مانند
us.anthropic.claude-sonnet-5 را شناسایی میکند. این سامانه پنجرهٔ زمینهٔ
۱٬۰۰۰٬۰۰۰ توکنی، محدودیت خروجی ۱۲۸٬۰۰۰ توکنی، ورودی تصویر، سطوح تلاش
بومی، ذخیرهسازی موقت درخواست و جریان ایمن در برابر رد درخواست را اعمال
میکند.
Bedrock تفکر تطبیقی را برای Sonnet 5 فعال نگه میدارد. مقدار پیشفرض
OpenClaw برابر high است؛ /think off و /think minimal به low نگاشت
میشوند، زیرا این مسیر نمیتواند تفکر را غیرفعال کند. هنگام فعال بودن
تفکر تطبیقی، مقادیر دمای سفارشی و انتخاب اجباری ابزار حذف میشوند.
محافظها
میتوانید با افزودن یک شیء guardrail به پیکربندی Plugin مربوط به
amazon-bedrock، محافظهای Amazon Bedrock
را روی همهٔ فراخوانیهای مدل Bedrock اعمال کنید. محافظها به شما امکان
میدهند پالایش محتوا، رد موضوع، پالایش واژهها، پالایش اطلاعات حساس و
بررسیهای اتکای زمینهای را اعمال کنید.
{ plugins: { entries: { "amazon-bedrock": { config: { guardrail: { guardrailIdentifier: "abc123", // شناسهٔ محافظ یا ARN کامل guardrailVersion: "1", // شمارهٔ نسخه یا "DRAFT" streamProcessingMode: "sync", // اختیاری: "sync" یا "async" trace: "enabled", // اختیاری: "enabled"، "disabled" یا "enabled_full" }, }, }, }, },}guardrailIdentifier و guardrailVersion الزامی هستند.
| گزینه | توضیح |
|---|---|
guardrailIdentifier |
شناسهٔ محافظ (برای مثال abc123) یا ARN کامل (برای مثال arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123). |
guardrailVersion |
شمارهٔ نسخهٔ منتشرشده یا "DRAFT" برای پیشنویس در حال کار. |
streamProcessingMode |
"sync" یا "async" برای ارزیابی محافظ هنگام جریان. اگر حذف شود، Bedrock از مقدار پیشفرض خود استفاده میکند. |
trace |
"enabled" یا "enabled_full" برای اشکالزدایی؛ برای محیط عملیاتی آن را حذف کنید یا روی "disabled" تنظیم کنید. |
تعبیهها برای جستوجوی حافظه
Bedrock همچنین میتواند بهعنوان ارائهدهندهٔ تعبیه برای
جستوجوی حافظه استفاده شود. این مورد جدا از
ارائهدهندهٔ استنتاج پیکربندی میشود -- مقدار
agents.defaults.memorySearch.provider را روی "bedrock" تنظیم کنید:
{ agents: { defaults: { memorySearch: { provider: "bedrock", model: "amazon.titan-embed-text-v2:0", // پیشفرض }, }, },}تعبیههای Bedrock از همان زنجیرهٔ اعتبارنامهٔ AWS SDK مورداستفاده برای استنتاج بهره میبرند (نقشهای نمونه، SSO، کلیدهای دسترسی، پیکربندی مشترک و هویت وب). به کلید API نیازی نیست.
مدلهای تعبیهٔ پشتیبانیشده شامل Amazon Titan Embed (نسخههای ۱ و ۲)، Amazon Nova Embed، Cohere Embed (نسخههای ۳ و ۴) و TwelveLabs Marengo هستند. برای فهرست کامل مدلها و گزینههای ابعاد، به مرجع پیکربندی حافظه -- Bedrock مراجعه کنید.
نکتهها و ملاحظات
- Bedrock به فعال بودن دسترسی مدل در حساب/منطقهٔ AWS شما نیاز دارد.
- کشف خودکار به مجوزهای
bedrock:ListFoundationModelsوbedrock:ListInferenceProfilesنیاز دارد. - اگر به حالت خودکار متکی هستید، یکی از نشانگرهای محیطی پشتیبانیشدهٔ
احراز هویت AWS را روی میزبان Gateway تنظیم کنید. اگر احراز هویت
IMDS/پیکربندی مشترک را بدون نشانگرهای محیطی ترجیح میدهید، مقدار
plugins.entries.amazon-bedrock.config.discovery.enabled: trueرا تنظیم کنید. - OpenClaw منبع اعتبارنامه را به این ترتیب نمایش میدهد:
AWS_BEARER_TOKEN_BEDROCK، سپسAWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEY، سپسAWS_PROFILEو در پایان زنجیرهٔ پیشفرض AWS SDK. - پشتیبانی از استدلال به مدل بستگی دارد؛ برای قابلیتهای فعلی، کارت مدل Bedrock را بررسی کنید.
- اگر جریان کلید مدیریتشده را ترجیح میدهید، میتوانید یک پروکسی سازگار با OpenAI را نیز جلوی Bedrock قرار دهید و آن را بهجای Bedrock بهعنوان ارائهدهندهٔ OpenAI پیکربندی کنید.
