Перейти до основного вмісту
OpenClaw містить вбудований провайдер Amazon Bedrock Mantle, який підключається до OpenAI-сумісної кінцевої точки Mantle. Mantle розміщує open-source і сторонні моделі (GPT-OSS, Qwen, Kimi, GLM тощо) через стандартну поверхню /v1/chat/completions, що працює на інфраструктурі Bedrock.
ВластивістьЗначення
ID провайдераamazon-bedrock-mantle
APIopenai-completions (OpenAI-сумісний) або anthropic-messages (маршрут Anthropic Messages)
АвтентифікаціяЯвний AWS_BEARER_TOKEN_BEDROCK або генерація bearer-токена через ланцюжок облікових даних IAM
Регіон за замовчуваннямus-east-1 (перевизначте через AWS_REGION або AWS_DEFAULT_REGION)

Початок роботи

Виберіть бажаний метод автентифікації та виконайте кроки налаштування.
Найкраще для: середовищ, де у вас уже є bearer-токен Mantle.
1

Установіть bearer-токен на хості gateway

export AWS_BEARER_TOKEN_BEDROCK="..."
За потреби встановіть регіон (за замовчуванням us-east-1):
export AWS_REGION="us-west-2"
2

Увімкніть обмін даними провайдера для Claude Fable 5

Claude Fable 5 і моделі Bedrock класу Claude Mythos перед викликом потребують режиму Mantle Data Retention API provider_data_share. Це явне ввімкнення дозволяє Bedrock передавати запити й завершення Anthropic і зберігати їх до 30 днів для перевірки довіри та безпеки.
AWS_REGION="${AWS_REGION:-us-east-1}"
curl -X PUT "https://bedrock-mantle.${AWS_REGION}.api.aws/v1/data_retention" \
  -H "Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "provider_data_share" }'
Використайте іншу модель Bedrock у конфігурації, якщо ви не можете прийняти цей режим зберігання.
3

Перевірте, що моделі виявлено

openclaw models list
Виявлені моделі з’являться під провайдером amazon-bedrock-mantle. Додаткова конфігурація не потрібна, якщо ви не хочете перевизначити значення за замовчуванням.

Автоматичне виявлення моделей

Коли AWS_BEARER_TOKEN_BEDROCK встановлено, OpenClaw використовує його напряму. Інакше OpenClaw намагається згенерувати bearer-токен Mantle зі стандартного ланцюжка облікових даних AWS. Потім він виявляє доступні моделі Mantle, запитуючи кінцеву точку регіону /v1/models.
ПоведінкаДеталі
Кеш виявленняРезультати кешуються на 1 годину
Оновлення IAM-токенаЩогодини
Щоб залишити Plugin Mantle увімкненим, але вимкнути автоматичне виявлення та генерацію IAM bearer-токена, вимкніть перемикач виявлення, яким володіє Plugin:
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false
Bearer-токен збігається з AWS_BEARER_TOKEN_BEDROCK, який використовує стандартний провайдер Amazon Bedrock.

Підтримувані регіони

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,
          },
        ],
      },
    },
  },
}

Розширена конфігурація

Підтримка reasoning визначається з ID моделей, що містять шаблони на кшталт thinking, reasoner або gpt-oss-120b. OpenClaw автоматично встановлює reasoning: true для відповідних моделей під час виявлення.
Якщо кінцева точка Mantle недоступна або не повертає моделей, провайдер безшумно пропускається. OpenClaw не видає помилку; інші налаштовані провайдери продовжують працювати нормально.
Mantle також надає маршрут Anthropic Messages, який проводить моделі Claude через той самий streaming-шлях із bearer-автентифікацією. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) можна викликати через цей маршрут зі streaming, яким володіє провайдер, тому bearer-токени AWS не трактуються як API-ключі Anthropic.Коли ви закріплюєте модель Anthropic Messages за провайдером Mantle, OpenClaw використовує поверхню API anthropic-messages замість openai-completions для цієї моделі. Автентифікація все одно надходить із AWS_BEARER_TOKEN_BEDROCK (або згенерованого IAM bearer-токена).
{
  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,
          },
        ],
      },
    },
  },
}
Bedrock Mantle є окремим провайдером від стандартного провайдера Amazon Bedrock. Mantle використовує OpenAI-сумісну поверхню /v1, тоді як стандартний провайдер Bedrock використовує нативний Bedrock API.Обидва провайдери використовують ті самі облікові дані AWS_BEARER_TOKEN_BEDROCK, коли вони наявні.

Пов’язане

Amazon Bedrock

Нативний провайдер Bedrock для Anthropic Claude, Titan та інших моделей.

Вибір моделі

Вибір провайдерів, посилань на моделі та поведінки failover.

OAuth і автентифікація

Деталі автентифікації та правила повторного використання облікових даних.

Усунення несправностей

Поширені проблеми та способи їх розв’язання.