Przejdź do głównej treści
OpenClaw zawiera wbudowanego dostawcę Amazon Bedrock Mantle, który łączy się z punktem końcowym Mantle zgodnym z OpenAI. Mantle udostępnia modele open source i modele firm trzecich (GPT-OSS, Qwen, Kimi, GLM i podobne) przez standardową powierzchnię /v1/chat/completions opartą na infrastrukturze Bedrock.
WłaściwośćWartość
ID dostawcyamazon-bedrock-mantle
APIopenai-completions (zgodne z OpenAI) lub anthropic-messages (trasa Anthropic Messages)
UwierzytelnianieJawny AWS_BEARER_TOKEN_BEDROCK lub generowanie tokenu bearer z łańcucha poświadczeń IAM
Domyślny regionus-east-1 (nadpisz przez AWS_REGION lub AWS_DEFAULT_REGION)

Pierwsze kroki

Wybierz preferowaną metodę uwierzytelniania i wykonaj kroki konfiguracji.
Najlepsze dla: środowisk, w których masz już token bearer Mantle.
1

Ustaw token bearer na hoście Gateway

export AWS_BEARER_TOKEN_BEDROCK="..."
Opcjonalnie ustaw region (domyślnie us-east-1):
export AWS_REGION="us-west-2"
2

Włącz udostępnianie danych dostawcy dla Claude Fable 5

Claude Fable 5 i modele Bedrock klasy Claude Mythos wymagają trybu API przechowywania danych Mantle provider_data_share przed wywołaniem. To włączenie pozwala Bedrock udostępniać prompty i uzupełnienia Anthropic oraz przechowywać je do 30 dni na potrzeby przeglądu zaufania i bezpieczeństwa.
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" }'
Użyj w konfiguracji innego modelu Bedrock, jeśli nie możesz zaakceptować tego trybu przechowywania.
3

Sprawdź, czy modele zostały wykryte

openclaw models list
Wykryte modele pojawiają się pod dostawcą amazon-bedrock-mantle. Nie jest wymagana dodatkowa konfiguracja, chyba że chcesz nadpisać wartości domyślne.

Automatyczne wykrywanie modeli

Gdy AWS_BEARER_TOKEN_BEDROCK jest ustawiony, OpenClaw używa go bezpośrednio. W przeciwnym razie OpenClaw próbuje wygenerować token bearer Mantle z domyślnego łańcucha poświadczeń AWS. Następnie wykrywa dostępne modele Mantle, wysyłając zapytanie do regionalnego punktu końcowego /v1/models.
ZachowanieSzczegóły
Pamięć podręczna wykrywaniaWyniki są buforowane przez 1 godzinę
Odświeżanie tokenu IAMCo godzinę
Aby pozostawić Plugin Mantle włączony, ale wyłączyć automatyczne wykrywanie i generowanie tokenu bearer IAM, wyłącz przełącznik wykrywania należący do Plugin:
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false
Token bearer to ten sam AWS_BEARER_TOKEN_BEDROCK, którego używa standardowy dostawca Amazon Bedrock.

Obsługiwane regiony

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.

Konfiguracja ręczna

Jeśli wolisz jawną konfigurację zamiast automatycznego wykrywania:
{
  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,
          },
        ],
      },
    },
  },
}

Konfiguracja zaawansowana

Obsługa rozumowania jest wnioskowana z identyfikatorów modeli zawierających wzorce takie jak thinking, reasoner lub gpt-oss-120b. OpenClaw ustawia reasoning: true automatycznie dla pasujących modeli podczas wykrywania.
Jeśli punkt końcowy Mantle jest niedostępny lub nie zwraca żadnych modeli, dostawca jest pomijany po cichu. OpenClaw nie zgłasza błędu; inni skonfigurowani dostawcy nadal działają normalnie.
Mantle udostępnia także trasę Anthropic Messages, która przenosi modele Claude przez tę samą ścieżkę strumieniowania uwierzytelnianą tokenem bearer. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) można wywoływać przez tę trasę ze strumieniowaniem należącym do dostawcy, więc tokeny bearer AWS nie są traktowane jak klucze API Anthropic.Gdy przypniesz model Anthropic Messages u dostawcy Mantle, OpenClaw używa dla tego modelu powierzchni API anthropic-messages zamiast openai-completions. Uwierzytelnianie nadal pochodzi z AWS_BEARER_TOKEN_BEDROCK (lub utworzonego tokenu bearer IAM).
{
  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 jest osobnym dostawcą względem standardowego dostawcy Amazon Bedrock. Mantle używa powierzchni /v1 zgodnej z OpenAI, natomiast standardowy dostawca Bedrock używa natywnego API Bedrock.Obaj dostawcy współdzielą te same poświadczenie AWS_BEARER_TOKEN_BEDROCK, gdy jest dostępne.

Powiązane

Amazon Bedrock

Natywny dostawca Bedrock dla Anthropic Claude, Titan i innych modeli.

Wybór modelu

Wybieranie dostawców, odwołań do modeli i zachowania przełączania awaryjnego.

OAuth i uwierzytelnianie

Szczegóły uwierzytelniania i reguły ponownego używania poświadczeń.

Rozwiązywanie problemów

Typowe problemy i sposoby ich rozwiązywania.