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

Amazon Bedrock Mantle

OpenClaw містить вбудований провайдер Amazon Bedrock Mantle, який підключається до сумісного з OpenAI ендпоінта Mantle. Mantle розміщує моделі з відкритим кодом і сторонні моделі (GPT-OSS, Qwen, Kimi, GLM та подібні) через стандартну поверхню /v1/chat/completions, що працює на інфраструктурі Bedrock.
ВластивістьЗначення
ID провайдераamazon-bedrock-mantle
APIopenai-completions (сумісний з OpenAI)
АвтентифікаціяЯвний 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

Переконайтеся, що моделі виявлено

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

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

Коли задано AWS_BEARER_TOKEN_BEDROCK, OpenClaw використовує його напряму. В іншому разі OpenClaw намагається згенерувати bearer-токен Mantle з типового ланцюжка облікових даних AWS. Потім він виявляє доступні моделі Mantle, опитуючи ендпоінт /v1/models для відповідного регіону.
ПоведінкаДеталі
Кеш виявленняРезультати кешуються на 1 годину
Оновлення IAM-токенаЩогодини
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,
          },
        ],
      },
    },
  },
}

Додаткові примітки

Підтримка міркування визначається за ID моделі, які містять шаблони на кшталт thinking, reasoner або gpt-oss-120b. OpenClaw автоматично встановлює reasoning: true для відповідних моделей під час виявлення.
Якщо ендпоінт Mantle недоступний або не повертає жодної моделі, провайдер тихо пропускається. OpenClaw не повертає помилку; інші налаштовані провайдери продовжують працювати як звичайно.
Bedrock Mantle є окремим провайдером від стандартного провайдера Amazon Bedrock. Mantle використовує сумісну з OpenAI поверхню /v1, тоді як стандартний провайдер Bedrock використовує нативний API Bedrock.Обидва провайдери використовують ті самі облікові дані AWS_BEARER_TOKEN_BEDROCK, якщо вони задані.

Пов’язане

Amazon Bedrock

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

Вибір моделі

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

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

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

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

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