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, а результаты кэшируются (по умолчанию: 1 час).
Как включается неявный провайдер:
- Если
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 |
auto | В автоматическом режиме 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 Bedrock ListFoundationModels и GetFoundationModel не возвращают
метаданные об ограничениях токенов, а только идентификатор и имя модели, модальности и состояние
жизненного цикла. 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 |
Зарезервированная мощность для рабочих нагрузок в установившемся режиме |
Задайте serviceTier (или service_tier) через agents.defaults.params для
запросов к моделям Bedrock либо отдельно для каждой модели в
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, при этом сообщение об ошибке может
вводить в заблуждение (например, «The provided model identifier is invalid»
вместо указания уровня как причины проблемы). Если вы видите эту ошибку, проверьте,
поддерживает ли модель запрошенный уровень.
Температура Claude Opus 4.7 и 4.8
Bedrock отклоняет параметр temperature для Claude Opus 4.7 и Opus
4.8. OpenClaw автоматически исключает temperature для любой соответствующей ссылки Bedrock,
включая идентификаторы базовых моделей, именованные профили вывода, прикладные
профили вывода, базовая модель которых через
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 размером 1M, ограничение вывода 128K, постоянно включённое
адаптивное мышление и поддерживаемое сопоставление уровней усилий. /think off и
/think minimal сопоставляются с low; температура и элементы управления принудительным выбором инструмента
исключаются, как и в маршруте Opus 4.7/4.8. Потоковый вывод удерживается
до получения от Bedrock конечного статуса, чтобы отказы в середине потока не
раскрывали частичный текст.
Прежде чем Fable станет доступна, AWS требует явно согласиться на хранение данных
с помощью provider_data_share. Запросы и ответы передаются Anthropic и
хранятся до 30 дней в целях обеспечения доверия и безопасности. Ознакомьтесь с
хранением данных Bedrock
и настройте его перед включением модели.
Claude Mythos 5
Claude Mythos 5 доступна через Bedrock только для учётных записей,
получивших необходимое разрешение на ограниченный доступ. OpenClaw распознаёт базовую модель
anthropic.claude-mythos-5 и региональные или глобальные профили вывода, например
us.anthropic.claude-mythos-5.
OpenClaw применяет окно контекста на 1,000,000 токенов, ограничение вывода
на 128,000 токенов, ввод изображений, кэширование запросов, безопасную при отказах потоковую передачу
и встроенные уровни усилий. Адаптивное мышление включено всегда: /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. Он применяет окно контекста на 1,000,000 токенов,
ограничение вывода на 128,000 токенов, ввод изображений, встроенные уровни усилий,
кэширование запросов и безопасную при отказах потоковую передачу.
Bedrock сохраняет адаптивное мышление включённым для Sonnet 5. По умолчанию OpenClaw использует
high; /think off и /think minimal сопоставляются с low, поскольку этот маршрут
не позволяет отключить мышление. Пользовательские значения температуры и принудительного выбора инструмента
исключаются, пока адаптивное мышление активно.
Защитные механизмы
Вы можете применять защитные механизмы Amazon Bedrock
ко всем вызовам моделей Bedrock, добавив объект guardrail в
конфигурацию плагина amazon-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 (v1, v2), Amazon Nova Embed, Cohere Embed (v3, v4) и 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.
- Если вы предпочитаете управляемую работу с ключами, можно также разместить перед Bedrock прокси-сервер, совместимый с OpenAI, и настроить его как поставщика OpenAI.
Связанные материалы
Выбор поставщиков, ссылок на модели и поведения при переключении после сбоя.
Настройка векторных представлений Bedrock для поиска по памяти.
Полный список моделей векторных представлений Bedrock и варианты размерности.
Общие сведения об устранении неполадок и часто задаваемые вопросы.