OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Amazon Bedrock Mantle

OpenClaw містить вбудований провайдер Amazon Bedrock Mantle, який підключається до сумісної з OpenAI кінцевої точки Mantle. Mantle надає моделі з відкритим кодом і сторонні моделі (GPT-OSS, Qwen, Kimi, GLM та подібні) через стандартний інтерфейс /v1/chat/completions, що працює на інфраструктурі Bedrock. Mantle також надає моделі Anthropic Claude через маршрут Anthropic Messages.

Властивість Значення
Ідентифікатор провайдера amazon-bedrock-mantle
API openai-completions для виявлених моделей із відкритим кодом, anthropic-messages для моделей Claude
Автентифікація Явний AWS_BEARER_TOKEN_BEDROCK або створення токена-носія через ланцюжок облікових даних IAM
Регіон за замовчуванням us-east-1 (перевизначте за допомогою AWS_REGION або AWS_DEFAULT_REGION)

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

Виберіть бажаний метод автентифікації та виконайте кроки налаштування.

Явний токен-носій

Найкраще підходить для: середовищ, де у вас уже є токен-носій Mantle.

  • Установіть токен-носій на хості Gateway

    bash
    export AWS_BEARER_TOKEN_BEDROCK="..."

    За потреби задайте регіон (за замовчуванням — us-east-1):

    bash
    export AWS_REGION="us-west-2"

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

    bash
    openclaw models list

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

    • Облікові дані IAM

    Найкраще підходить для: використання сумісних з AWS SDK облікових даних (спільна конфігурація, SSO, вебідентифікація, ролі екземплярів або завдань).

  • Налаштуйте облікові дані AWS на хості Gateway

    Підійде будь-яке джерело автентифікації, сумісне з AWS SDK:

    bash
    export AWS_PROFILE="default"export AWS_REGION="us-west-2"

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

    bash
    openclaw models list

    OpenClaw автоматично створює токен-носій Mantle із ланцюжка облікових даних.

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

    Якщо задано AWS_BEARER_TOKEN_BEDROCK, OpenClaw використовує його безпосередньо. Інакше OpenClaw намагається створити токен-носій Mantle зі стандартного ланцюжка облікових даних AWS. Потім він виявляє доступні моделі Mantle, надсилаючи запит до кінцевої точки /v1/models відповідного регіону.

    Поведінка Докладно
    Кеш виявлення Результати кешуються на 1 годину для кожного регіону; у разі помилки отримання повертається останній кешований результат
    Оновлення токена IAM Кожні 2 години, кешується для кожного регіону

    Щоб залишити Plugin Mantle увімкненим, але вимкнути автоматичне виявлення та створення токена-носія IAM, вимкніть перемикач виявлення, що належить Plugin:

    bash
    openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false

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

    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.

    Ручне налаштування

    Якщо ви віддаєте перевагу явній конфігурації замість автоматичного виявлення:

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

    Явний непорожній список models є визначальним і замінює всі виявлені записи, включно із записами Claude нижче. Не вказуйте models, щоб зберегти автоматичний каталог Mantle, або додайте повні записи моделей Claude, які ви хочете використовувати.

    Розширене налаштування

    Підтримка міркування

    Підтримка міркування визначається за ідентифікаторами моделей, що містять такі шаблони, як thinking, reasoner, reasoning, deepseek.r, gpt-oss-120b або gpt-oss-safeguard-120b. Під час виявлення OpenClaw автоматично встановлює reasoning: true для відповідних моделей.

    Недоступність кінцевої точки

    Якщо кінцева точка Mantle недоступна, не повертає моделей або не вдається визначити токен-носій, виявлення повертає порожній результат, а неявний провайдер пропускається. OpenClaw не повертає помилку; інші налаштовані провайдери продовжують працювати у звичайному режимі.

    Claude через маршрут Anthropic Messages

    Якщо список моделей контролюється автоматичним виявленням, після успішного пошуку OpenClaw додає чотири моделі Claude незалежно від того, що повертає /v1/models: amazon-bedrock-mantle/anthropic.claude-sonnet-5 (Claude Sonnet 5), amazon-bedrock-mantle/anthropic.claude-opus-4-7 (Claude Opus 4.7) і amazon-bedrock-mantle/anthropic.claude-mythos-5 (Claude Mythos 5), а також amazon-bedrock-mantle/anthropic.claude-mythos-preview (попередня версія Claude Mythos). Вони використовують інтерфейс API anthropic-messages і передають потокові дані через ту саму сумісну з Anthropic кінцеву точку з автентифікацією токеном-носієм (<mantle-base>/anthropic), тому токен-носій AWS не розглядається як ключ API Anthropic.

    Claude Sonnet 5 завжди використовує адаптивне міркування, а стандартний рівень зусиль — high. /think off і /think minimal зіставляються з low, оскільки маршрут Mantle не дає змоги вимкнути міркування. OpenClaw також не передає власне значення температури для запитів Sonnet 5.

    Доступ до Claude Mythos 5 обмежений. Він заявляє контекстне вікно на 1 000 000 токенів і обмеження виводу на 128 000 токенів, завжди використовує адаптивне міркування, зіставляє /think off і /think minimal з low та не передає вибрані викликачем параметри семплювання.

    Claude Mythos Preview завжди запитує міркування зі стандартним рівнем зусиль high, якщо рівень /think не задано (xhigh/max знижуються до high, а minimal підвищується до low). Opus 4.7 у Mantle передає потік без наданого моделлю міркування, а OpenClaw не передає його параметр temperature, оскільки Opus 4.7 не приймає перевизначення семплювання на цьому маршруті; Mythos Preview приймає перевизначення temperature у звичайному режимі.

    Непорожній явний список models.providers["amazon-bedrock-mantle"].models замінює весь виявлений каталог. Не вказуйте цей список, якщо хочете використовувати ці вбудовані записи Claude.

    Зв’язок із провайдером Amazon Bedrock

    Bedrock Mantle — це окремий провайдер, відмінний від стандартного провайдера Amazon Bedrock. Mantle використовує сумісний з OpenAI інтерфейс /v1 для свого каталогу моделей із відкритим кодом, тоді як стандартний провайдер Bedrock використовує нативний API Bedrock Converse.

    Обидва провайдери використовують ті самі облікові дані AWS_BEARER_TOKEN_BEDROCK, якщо їх задано.

    Пов’язані матеріали

    Amazon Bedrock

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

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

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

    Поширені проблеми та способи їх вирішення.
    Was this useful?
    On this page

    On this page