Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw bao gồm nhà cung cấp Amazon Bedrock Mantle được tích hợp sẵn, kết nối tới điểm cuối 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 rõ ràng hoặc tạo bearer-token từ 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 và làm theo các bước thiết lập.
Phù hợp nhất cho: các môi trường nơi bạn đã có bearer token Mantle.
1

Đặt bearer token trên máy chủ gateway

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"
2

Xác minh các mô hình đã được phát hiện

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 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 token đó. 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 viChi tiết
Bộ nhớ đệm phát hiệnKết quả được lưu trong bộ nhớ đệm trong 1 giờ
Làm mới token IAMHằng giờ
Để giữ Plugin Mantle được bật nhưng chặn việc 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.

​
Các 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

Hỗ trợ reasoning được suy ra từ ID mô hình 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 đ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 thầm. 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 để truyền các mô hình Claude qua cùng đường dẫn phát trực tuyến được xác thực bằng bearer. 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 AWS không được 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 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 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 sử dụng một bề mặt /v1 tương thích 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.

Chọn mô hình

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

OAuth và xác thực

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

Khắc phục sự cố

Các vấn đề thường gặp và cách giải quyết.