Providers

Amazon Bedrock Mantle

OpenClaw menyertakan provider bawaan Amazon Bedrock Mantle yang terhubung ke endpoint Mantle yang kompatibel dengan OpenAI. Mantle meng-host model open-source dan pihak ketiga (GPT-OSS, Qwen, Kimi, GLM, dan sejenisnya) melalui permukaan standar /v1/chat/completions yang didukung oleh infrastruktur Bedrock.

Properti Nilai
ID Provider amazon-bedrock-mantle
API openai-completions (kompatibel dengan OpenAI) atau anthropic-messages (rute Anthropic Messages)
Auth AWS_BEARER_TOKEN_BEDROCK eksplisit atau pembuatan bearer-token dari rantai kredensial IAM
Region default us-east-1 (override dengan AWS_REGION atau AWS_DEFAULT_REGION)

Mulai

Pilih metode auth yang Anda sukai dan ikuti langkah penyiapannya.

Explicit bearer token

Paling cocok untuk: lingkungan tempat Anda sudah memiliki bearer token Mantle.

  • Set the bearer token on the gateway host

    export AWS_BEARER_TOKEN_BEDROCK="..."
    

    Secara opsional setel region (default ke us-east-1):

    export AWS_REGION="us-west-2"
    
  • Verify models are discovered

    openclaw models list
    

    Model yang ditemukan muncul di bawah provider amazon-bedrock-mantle. Tidak diperlukan config tambahan kecuali Anda ingin meng-override default.

  • IAM credentials

    Paling cocok untuk: menggunakan kredensial yang kompatibel dengan AWS SDK (shared config, SSO, web identity, instance atau task role).

  • Configure AWS credentials on the gateway host

    Sumber auth apa pun yang kompatibel dengan AWS SDK dapat digunakan:

    export AWS_PROFILE="default"
    export AWS_REGION="us-west-2"
    
  • Verify models are discovered

    openclaw models list
    

    OpenClaw otomatis menghasilkan bearer token Mantle dari rantai kredensial.

  • Penemuan model otomatis

    Saat AWS_BEARER_TOKEN_BEDROCK disetel, OpenClaw langsung menggunakannya. Jika tidak, OpenClaw mencoba menghasilkan bearer token Mantle dari rantai kredensial default AWS. Lalu OpenClaw menemukan model Mantle yang tersedia dengan melakukan query ke endpoint /v1/models region tersebut.

    Perilaku Detail
    Cache discovery Hasil di-cache selama 1 jam
    Refresh token IAM Per jam

    Region yang didukung

    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.

    Konfigurasi manual

    Jika Anda lebih memilih config eksplisit daripada auto-discovery:

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

    Konfigurasi lanjutan

    Reasoning support

    Dukungan reasoning disimpulkan dari ID model yang mengandung pola seperti thinking, reasoner, atau gpt-oss-120b. OpenClaw menyetel reasoning: true secara otomatis untuk model yang cocok saat discovery.

    Endpoint unavailability

    Jika endpoint Mantle tidak tersedia atau tidak mengembalikan model, provider akan dilewati secara diam-diam. OpenClaw tidak menghasilkan error; provider lain yang dikonfigurasi tetap bekerja seperti biasa.

    Claude Opus 4.7 via the Anthropic Messages route

    Mantle juga mengekspos rute Anthropic Messages yang membawa model Claude melalui jalur streaming terautentikasi bearer yang sama. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) dapat dipanggil melalui rute ini dengan streaming milik provider, sehingga bearer token AWS tidak diperlakukan seperti API key Anthropic.

    Saat Anda menyematkan model Anthropic Messages pada provider Mantle, OpenClaw menggunakan permukaan API anthropic-messages alih-alih openai-completions untuk model tersebut. Auth tetap berasal dari AWS_BEARER_TOKEN_BEDROCK (atau bearer token IAM yang dibuat).

    {
      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,
              },
            ],
          },
        },
      },
    }
    
    Relationship to Amazon Bedrock provider

    Bedrock Mantle adalah provider yang terpisah dari provider Amazon Bedrock standar. Mantle menggunakan permukaan /v1 yang kompatibel dengan OpenAI, sementara provider Bedrock standar menggunakan API Bedrock native.

    Kedua provider berbagi kredensial AWS_BEARER_TOKEN_BEDROCK yang sama saat tersedia.

    Terkait