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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw містить вбудований провайдер Amazon Bedrock Mantle, який підключається до OpenAI-сумісної кінцевої точки Mantle. Mantle розміщує моделі з відкритим кодом і сторонні моделі (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

Set the bearer token on the gateway host

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

Verify models are discovered

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

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

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

Пов’язане

Amazon Bedrock

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

Model selection

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

OAuth and auth

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

Troubleshooting

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