> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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` для обнаруженных OSS-моделей, `anthropic-messages` для моделей Claude |
| Аутентификация | Явный `AWS_BEARER_TOKEN_BEDROCK` или создание токена-носителя через цепочку учётных данных IAM |
| Регион по умолчанию | `us-east-1` (переопределяется с помощью `AWS_REGION` или `AWS_DEFAULT_REGION`) |

## Начало работы

Выберите предпочтительный метод аутентификации и выполните шаги настройки.

> [tab] Явный токен-носитель
>
> **Лучше всего подходит для:** сред, где у вас уже есть токен-носитель Mantle.
>
> **1. Задайте токен-носитель на хосте Gateway**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> export AWS_BEARER_TOKEN_BEDROCK="..."
> ```
>
> При необходимости задайте регион (по умолчанию — `us-east-1`):
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> export AWS_REGION="us-west-2"
> ```
>
> **2. Убедитесь, что модели обнаружены**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw models list
> ```
>
> Обнаруженные модели отображаются у провайдера `amazon-bedrock-mantle`. Дополнительная
> конфигурация не требуется, если вы не хотите переопределить значения по умолчанию.

> [tab] Учётные данные IAM
>
> **Лучше всего подходит для:** использования учётных данных, совместимых с AWS SDK (общая конфигурация, SSO, веб-идентификация, роли экземпляров или задач).
>
> **1. Настройте учётные данные AWS на хосте Gateway**
>
> Подойдёт любой источник аутентификации, совместимый с AWS SDK:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> export AWS_PROFILE="default"
> export AWS_REGION="us-west-2"
> ```
>
> **2. Убедитесь, что модели обнаружены**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw models list
> ```
>
> OpenClaw автоматически создаёт токен-носитель Mantle из цепочки учётных данных.
>
> > [!TIP]
> >
> > Если `AWS_BEARER_TOKEN_BEDROCK` не задан, OpenClaw создаёт для вас токен-носитель из стандартной цепочки учётных данных AWS, включая общие учётные данные и профили конфигурации, SSO, веб-идентификацию, а также роли экземпляров или задач.

## Автоматическое обнаружение моделей

Если `AWS_BEARER_TOKEN_BEDROCK` задан, OpenClaw использует его напрямую. В противном случае
OpenClaw пытается создать токен-носитель Mantle из стандартной цепочки
учётных данных AWS. Затем он обнаруживает доступные модели Mantle, обращаясь к
региональной конечной точке `/v1/models`.

| Поведение | Подробности |
| - | - |
| Кэш обнаружения | Результаты кэшируются на 1 час для каждого региона; при сбое запроса возвращается последний кэшированный результат |
| Обновление токена IAM | Каждые 2 часа, кэшируется отдельно для каждого региона |

Чтобы оставить плагин Mantle включённым, но отключить автоматическое обнаружение и
создание токена-носителя IAM, отключите принадлежащий плагину переключатель обнаружения:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false
```

> [!NOTE]
>
> Используется тот же токен-носитель `AWS_BEARER_TOKEN_BEDROCK`, что и стандартным провайдером [Amazon Bedrock](https://docs2.openclaw.ai/ru/providers/bedrock.md).

### Поддерживаемые регионы

`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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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, которые
хотите использовать.

## Расширенная настройка

> [accordion] Поддержка рассуждений
>
> Поддержка рассуждений определяется по наличию в идентификаторах моделей таких шаблонов, как
> `thinking`, `reasoner`, `reasoning`, `deepseek.r`, `gpt-oss-120b` или
> `gpt-oss-safeguard-120b`. Во время обнаружения OpenClaw автоматически задаёт
> `reasoning: true` для соответствующих моделей.

> [accordion] Недоступность конечной точки
>
> Если конечная точка Mantle недоступна, не возвращает моделей либо не удаётся
> получить токен-носитель, обнаружение возвращает пустой результат, а неявный
> провайдер пропускается. OpenClaw не сообщает об ошибке; другие настроенные провайдеры
> продолжают работать в обычном режиме.

> [accordion] 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.

> [accordion] Связь с провайдером Amazon Bedrock
>
> Bedrock Mantle — отдельный провайдер, отличный от стандартного
> провайдера [Amazon Bedrock](https://docs2.openclaw.ai/ru/providers/bedrock.md). Mantle использует совместимый с
> OpenAI интерфейс `/v1` для своего каталога OSS, тогда как стандартный
> провайдер Bedrock использует нативный API Bedrock Converse.
>
> Оба провайдера совместно используют одни и те же учётные данные `AWS_BEARER_TOKEN_BEDROCK`, если
> они доступны.

## Связанные материалы

> [card] [Amazon Bedrock](https://docs2.openclaw.ai/ru/providers/bedrock.md)
>
> Нативный провайдер Bedrock для Anthropic Claude, Titan и других моделей.

> [card] [Выбор модели](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

> [card] [OAuth и аутентификация](https://docs2.openclaw.ai/ru/gateway/authentication.md)
>
> Сведения об аутентификации и правила повторного использования учётных данных.

> [card] [Устранение неполадок](https://docs2.openclaw.ai/ru/help/troubleshooting.md)
>
> Распространённые проблемы и способы их устранения.
