Providers

Amazon Bedrock Mantle

OpenClaw bao gồm nhà cung cấp Amazon Bedrock Mantle được tích hợp sẵn, kết nối đến điểm cuối Mantle tương thích với OpenAI. Mantle lưu trữ các mô hình mã nguồn mở và mô hình bên thứ ba (GPT-OSS, Qwen, Kimi, GLM, và tương tự) thông qua bề mặt /v1/chat/completions tiêu chuẩn được hỗ trợ bởi hạ tầng Bedrock.

Thuộc tính	Giá trị
ID nhà cung cấp	`amazon-bedrock-mantle`
API	`openai-completions` (tương thích với OpenAI) hoặc `anthropic-messages` (tuyến Anthropic Messages)
Xác thực	`AWS_BEARER_TOKEN_BEDROCK` rõ ràng hoặc tạo bearer token bằng chuỗi thông tin xác thực IAM
Vùng mặc định	`us-east-1` (ghi đè bằng `AWS_REGION` hoặc `AWS_DEFAULT_REGION`)

Bắt đầu

Chọn phương thức xác thực bạn muốn và làm theo các bước thiết lập.

Explicit bearer token

Phù hợp nhất cho: môi trường mà bạn đã có bearer token Mantle.

Set the bearer token on the gateway host

export AWS_BEARER_TOKEN_BEDROCK="..."

Tùy chọn đặt một vùng (mặc định là us-east-1):

export AWS_REGION="us-west-2"

Verify models are discovered

openclaw models list

Các mô hình được phát hiện sẽ xuất hiện dưới nhà cung cấp amazon-bedrock-mantle. Không cần cấu hình bổ sung trừ khi bạn muốn ghi đè các giá trị mặc định.

IAM credentials

Phù hợp nhất cho: sử dụng thông tin xác thực tương thích với AWS SDK (cấu hình dùng chung, SSO, web identity, vai trò instance hoặc task).

Configure AWS credentials on the gateway host

Mọi nguồn xác thực tương thích với AWS SDK đều hoạt động:

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

Verify models are discovered

openclaw models list

OpenClaw tự động tạo bearer token Mantle từ chuỗi thông tin xác thực.

Tự động phát hiện mô hình

Khi AWS_BEARER_TOKEN_BEDROCK được đặt, OpenClaw sử dụng trực tiếp giá trị đó. Nếu không, OpenClaw cố gắng tạo bearer token Mantle từ chuỗi thông tin xác thực mặc định của AWS. Sau đó, OpenClaw phát hiện các mô hình Mantle khả dụng bằng cách truy vấn điểm cuối /v1/models của vùng.

Hành vi	Chi tiết
Bộ nhớ đệm phát hiện	Kết quả được lưu đệm trong 1 giờ
Làm mới token IAM	Hàng giờ

Vùng được hỗ trợ

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.

Cấu hình thủ công

Nếu bạn muốn dùng cấu hình rõ ràng thay vì tự động phát hiện:

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

Cấu hình nâng cao

Reasoning support

Khả năng hỗ trợ suy luận được suy ra từ các ID mô hình chứa những mẫu như thinking, reasoner, hoặc gpt-oss-120b. OpenClaw tự động đặt reasoning: true cho các mô hình khớp trong quá trình phát hiện.

Endpoint unavailability

Nếu điểm cuối Mantle không khả dụng hoặc không trả về mô hình nào, nhà cung cấp sẽ được bỏ qua một cách im lặng. OpenClaw không báo lỗi; các nhà cung cấp đã cấu hình khác vẫn tiếp tục hoạt động bình thường.

Claude Opus 4.7 via the Anthropic Messages route

Mantle cũng cung cấp một tuyến Anthropic Messages để truyền các mô hình Claude qua cùng đường truyền phát trực tuyến được xác thực bằng bearer token. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) có thể được gọi qua tuyến này với cơ chế phát trực tuyến do nhà cung cấp sở hữu, nên bearer token AWS không được xem như khóa API Anthropic.

Khi bạn ghim một mô hình Anthropic Messages trên nhà cung cấp Mantle, OpenClaw sử dụng bề mặt API anthropic-messages thay vì openai-completions cho mô hình đó. Xác thực vẫn đến từ AWS_BEARER_TOKEN_BEDROCK (hoặc bearer token IAM được cấp).

{
  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 là một nhà cung cấp riêng biệt với nhà cung cấp Amazon Bedrock tiêu chuẩn. Mantle sử dụng bề mặt /v1 tương thích với OpenAI, trong khi nhà cung cấp Bedrock tiêu chuẩn sử dụng API Bedrock gốc.

Cả hai nhà cung cấp dùng chung cùng thông tin xác thực AWS_BEARER_TOKEN_BEDROCK khi có mặt.

Liên quan

Amazon Bedrock

Nhà cung cấp Bedrock gốc cho Anthropic Claude, Titan, và các mô hình khác.

Model selection

Chọn nhà cung cấp, tham chiếu mô hình, và hành vi chuyển đổi dự phòng.

OAuth and auth

Chi tiết xác thực và quy tắc tái sử dụng thông tin xác thực.

Troubleshooting

Các sự cố thường gặp và cách giải quyết.

# Bắt đầu

Explicit bearer token

Set the bearer token on the gateway host

Verify models are discovered

IAM credentials

Configure AWS credentials on the gateway host

Verify models are discovered

# Tự động phát hiện mô hình

# Vùng được hỗ trợ

# Cấu hình thủ công

# Cấu hình nâng cao

# Liên quan

Bắt đầu

Tự động phát hiện mô hình

Vùng được hỗ trợ

Cấu hình thủ công

Cấu hình nâng cao

Liên quan