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 với điểm cuối Mantle tương thích với OpenAI. Mantle lưu trữ các mô hình nguồn mở và mô hình của bên thứ ba (GPT-OSS, Qwen, Kimi, GLM và các mô hình tương tự) thông qua bề mặt /v1/chat/completions tiêu chuẩn dựa trên hạ tầng Bedrock. Mantle cũng cung cấp các mô hình Anthropic Claude thông qua tuyến Anthropic Messages.

Thuộc tính	Giá trị
ID nhà cung cấp	amazon-bedrock-mantle
API	openai-completions cho các mô hình OSS được phát hiện, anthropic-messages cho các mô hình Claude
Xác thực	AWS_BEARER_TOKEN_BEDROCK được chỉ định rõ hoặc tạo bearer token từ chuỗi thông tin xác thực IAM
Khu vực 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: các môi trường mà bạn đã có bearer token Mantle.

1. Set the bearer token on the gateway host

   export AWS_BEARER_TOKEN_BEDROCK="..."
   

   Bạn có thể tùy chọn đặt khu vực (mặc định là us-east-1):

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

   openclaw models list
   

   Các mô hình được phát hiện 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, danh tính web, vai trò phiên bản máy hoặc tác vụ).

1. 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"
   
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.

Khi AWS_BEARER_TOKEN_BEDROCK chưa được đặt, OpenClaw tạo bearer token cho bạn từ chuỗi thông tin xác thực mặc định của AWS, bao gồm thông tin xác thực/cấu hình dùng chung, SSO, danh tính web và vai trò phiên bản máy hoặc tác vụ.

​

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 sẽ 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 khu vực.

Hành vi	Chi tiết
Bộ nhớ đệm phát hiện	Kết quả được lưu vào bộ nhớ đệm trong 1 giờ cho mỗi khu vực; lỗi truy xuất trả về kết quả được lưu gần nhất
Làm mới token IAM	Mỗi 2 giờ, được lưu vào bộ nhớ đệm theo khu vực

Để tiếp tục bật Plugin Mantle nhưng vô hiệu hóa tính năng tự động phát hiện và tạo bearer token IAM, hãy tắt tùy chọn phát hiện do Plugin sở hữu:

openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false

Bearer token này chính là AWS_BEARER_TOKEN_BEDROCK được nhà cung cấp Amazon Bedrock tiêu chuẩn sử dụng.

​

Các khu vực đượ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 sử 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,
          },
        ],
      },
    },
  },
}

Danh sách models rõ ràng và không rỗng có tính quyết định, đồng thời thay thế mọi mục được phát hiện, bao gồm cả các mục Claude bên dưới. Bỏ qua models để giữ lại danh mục Mantle tự động hoặc cung cấp đầy đủ các mục mô hình Claude mà bạn muốn sử dụng.

​

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, reasoning, deepseek.r, gpt-oss-120b hoặc gpt-oss-safeguard-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, không trả về mô hình nào hoặc quá trình phân giải bearer token thất bại, việc phát hiện sẽ trả về kết quả rỗng và nhà cung cấp ngầm định sẽ bị bỏ qua. OpenClaw không báo lỗi; các nhà cung cấp đã cấu hình khác tiếp tục hoạt động bình thường.

Claude via the Anthropic Messages route

Khi tính năng tự động phát hiện quản lý danh sách mô hình, OpenClaw nối thêm bốn mô hình Claude sau khi tra cứu thành công, bất kể /v1/models trả về nội dung gì: amazon-bedrock-mantle/anthropic.claude-sonnet-5 (Claude Sonnet 5), amazon-bedrock-mantle/anthropic.claude-opus-4-7 (Claude Opus 4.7) và amazon-bedrock-mantle/anthropic.claude-mythos-5 (Claude Mythos 5), cùng với amazon-bedrock-mantle/anthropic.claude-mythos-preview (Claude Mythos Preview). Chúng sử dụng bề mặt API anthropic-messages và truyền phát qua cùng một điểm cuối tương thích với Anthropic được xác thực bằng bearer token (<mantle-base>/anthropic), vì vậy bearer token AWS không được xem như khóa API Anthropic.

Claude Sonnet 5 luôn sử dụng chế độ suy luận thích ứng và mặc định dùng mức nỗ lực high. /think off và /think minimal được ánh xạ thành low vì tuyến Mantle không thể vô hiệu hóa suy luận. OpenClaw cũng bỏ qua nhiệt độ tùy chỉnh đối với các yêu cầu Sonnet 5.

Claude Mythos 5 có quyền truy cập hạn chế. Mô hình này công bố cửa sổ ngữ cảnh 1.000.000 token và giới hạn đầu ra 128.000 token, luôn sử dụng chế độ suy luận thích ứng, ánh xạ /think off và /think minimal thành low, đồng thời bỏ qua các tham số lấy mẫu do bên gọi chọn.

Claude Mythos Preview luôn yêu cầu suy luận, mặc định dùng mức nỗ lực high khi không đặt mức /think (ánh xạ xhigh/max xuống high và minimal lên low). Opus 4.7 trên Mantle truyền phát mà không có dữ liệu suy luận do mô hình cung cấp, và OpenClaw bỏ qua tham số temperature vì Opus 4.7 không chấp nhận ghi đè việc lấy mẫu trên tuyến này; Mythos Preview vẫn chấp nhận ghi đè temperature như bình thường.

Danh sách models.providers["amazon-bedrock-mantle"].models rõ ràng và không rỗng thay thế toàn bộ danh mục được phát hiện. Bỏ qua danh sách đó khi bạn muốn sử dụng các mục Claude tích hợp sẵn này.

Relationship to Amazon Bedrock provider

Bedrock Mantle là một nhà cung cấp tách 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 cho danh mục OSS của mình, trong khi nhà cung cấp Bedrock tiêu chuẩn sử dụng API Bedrock Converse gốc.

Cả hai nhà cung cấp đều dùng chung thông tin xác thực AWS_BEARER_TOKEN_BEDROCK khi giá trị này hiện diện.

​

Nội dung liên quan

Amazon Bedrock

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

Model selection

Cách 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à các 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.