Chuyển đến nội dung chính
OpenClaw bao gồm nhà cung cấp Amazon Bedrock Mantle được tích hợp sẵn để kết nối tới endpoint tương thích OpenAI của Mantle. Mantle lưu trữ các mô hình mã nguồn mở và 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ínhGiá trị
ID nhà cung cấpamazon-bedrock-mantle
APIopenai-completions (tương thích OpenAI) hoặc anthropic-messages (tuyến Anthropic Messages)
Xác thựcAWS_BEARER_TOKEN_BEDROCK tường minh hoặc tạo bearer token bằng chuỗi thông tin xác thực IAM
Vùng mặc địnhus-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 dùng và làm theo các bước thiết lập.
Phù hợp nhất cho: các môi trường mà bạn đã có bearer token của Mantle.
1

Set the bearer token on the gateway host

export AWS_BEARER_TOKEN_BEDROCK="..."
Tùy chọn đặt vùng (mặc định là us-east-1):
export AWS_REGION="us-west-2"
2

Opt in to provider data sharing for Claude Fable 5

Claude Fable 5 và các mô hình Bedrock lớp Claude Mythos yêu cầu chế độ Mantle Data Retention API provider_data_share trước khi gọi. Việc chọn tham gia này cho phép Bedrock chia sẻ prompt và completion với Anthropic, đồng thời lưu giữ chúng tối đa 30 ngày để đánh giá độ tin cậy và an toàn.
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" }'
Hãy dùng một mô hình Bedrock khác trong cấu hình nếu bạn không thể chấp nhận chế độ lưu giữ đó.
3

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.

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

Khi AWS_BEARER_TOKEN_BEDROCK được đặt, OpenClaw 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 endpoint /v1/models của vùng.
Hành viChi tiết
Bộ nhớ đệm phát hiệnKết quả được lưu đệm trong 1 giờ
Làm mới token IAMHàng giờ
Để giữ plugin Mantle được bật nhưng chặn tự động phát hiện và tạo bearer token IAM, hãy tắt công tắc phát hiện do plugin sở hữu: 
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false
Bearer token là cùng AWS_BEARER_TOKEN_BEDROCK được nhà cung cấp Amazon Bedrock tiêu chuẩn sử dụng.

​
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 cấu hình tường minh 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

Hỗ trợ reasoning được suy luận từ ID mô hình có chứa các 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.
Nếu endpoint 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 im lặng. 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.
Mantle cũng cung cấp một tuyến Anthropic Messages đưa các mô hình Claude qua cùng đường streaming đượ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 streaming do nhà cung cấp sở hữu, vì vậy bearer token của AWS không bị xử lý như khóa API Anthropic.Khi bạn ghim một mô hình Anthropic Messages trên nhà cung cấp Mantle, OpenClaw 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 tạo).
{
  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 là một nhà cung cấp riêng biệt với nhà cung cấp Amazon Bedrock tiêu chuẩn. Mantle dùng bề mặt /v1 tương thích OpenAI, trong khi nhà cung cấp Bedrock tiêu chuẩn dùng API Bedrock gốc.Cả hai nhà cung cấp dùng chung 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 vấn đề thường gặp và cách giải quyết.