Providers
Amazon Bedrock Mantle
OpenClaw містить вбудований провайдер Amazon Bedrock Mantle, який підключається до
сумісного з OpenAI ендпоінта Mantle. Mantle розміщує open-source і
сторонні моделі (GPT-OSS, Qwen, Kimi, GLM та подібні) через стандартну
поверхню /v1/chat/completions, що працює на інфраструктурі Bedrock.
| Властивість | Значення |
|---|---|
| ID провайдера | amazon-bedrock-mantle |
| API | openai-completions (сумісний з OpenAI) або anthropic-messages (маршрут Anthropic Messages) |
| Auth | Явний AWS_BEARER_TOKEN_BEDROCK або генерація bearer token через IAM credential chain |
| Типовий регіон | us-east-1 (перевизначається через AWS_REGION або AWS_DEFAULT_REGION) |
Початок роботи
Виберіть бажаний метод auth і виконайте кроки налаштування.
Явний bearer token
Найкраще для: середовищ, де у вас уже є bearer token Mantle.
Задайте bearer token на хості gateway
export AWS_BEARER_TOKEN_BEDROCK="..."
За бажанням задайте регіон (типово us-east-1):
export AWS_REGION="us-west-2"
Переконайтеся, що моделі виявлено
openclaw models list
Виявлені моделі з’являться під провайдером amazon-bedrock-mantle. Додаткова
конфігурація не потрібна, якщо ви не хочете перевизначити типові значення.
IAM credentials
Найкраще для: використання credentials, сумісних з AWS SDK (shared config, SSO, web identity, ролі екземпляра або task).
Налаштуйте AWS credentials на хості gateway
Працює будь-яке джерело auth, сумісне з AWS SDK:
export AWS_PROFILE="default"
export AWS_REGION="us-west-2"
Переконайтеся, що моделі виявлено
openclaw models list
OpenClaw автоматично генерує bearer token Mantle з credential chain.
Автоматичне виявлення моделей
Коли задано AWS_BEARER_TOKEN_BEDROCK, OpenClaw використовує його напряму. Інакше
OpenClaw намагається згенерувати bearer token Mantle із типового
credential chain AWS. Потім він виявляє доступні моделі Mantle, опитуючи
ендпоінт /v1/models у відповідному регіоні.
| Поведінка | Деталі |
|---|---|
| Кеш виявлення | Результати кешуються на 1 годину |
| Оновлення IAM token | Щогодини |
Підтримувані регіони
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.
Ручна конфігурація
Якщо ви віддаєте перевагу явній config замість автоматичного виявлення:
{
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
Підтримка reasoning виводиться з ID моделей, які містять шаблони на кшталт
thinking, reasoner або gpt-oss-120b. OpenClaw автоматично встановлює reasoning: true
для відповідних моделей під час виявлення.
Недоступність ендпоінта
Якщо ендпоінт Mantle недоступний або не повертає моделей, провайдер тихо пропускається. OpenClaw не генерує помилку; інші налаштовані провайдери продовжують працювати у звичайному режимі.
Claude Opus 4.7 через маршрут Anthropic Messages
Mantle також надає маршрут Anthropic Messages, який пропускає моделі Claude через той самий bearer-authenticated streaming path. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) можна викликати через цей маршрут із потоковою передачею, якою володіє провайдер, тож AWS bearer tokens не трактуються як Anthropic API keys.
Коли ви фіксуєте модель Anthropic Messages у провайдера Mantle, OpenClaw використовує для цієї моделі поверхню API anthropic-messages замість openai-completions. Auth і далі надходить із AWS_BEARER_TOKEN_BEDROCK (або згенерованого bearer token IAM).
{
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,
},
],
},
},
},
}
Зв’язок із провайдером Amazon Bedrock
Bedrock Mantle — це окремий провайдер від стандартного
провайдера Amazon Bedrock. Mantle використовує
сумісну з OpenAI поверхню /v1, тоді як стандартний провайдер Bedrock використовує
нативний API Bedrock.
Обидва провайдери використовують ті самі credentials AWS_BEARER_TOKEN_BEDROCK, коли
вони присутні.