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

Documentation Index

Fetch the complete documentation index at: https://docs.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 đế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ínhGiá trị
ID nhà cung cấpamazon-bedrock-mantle
APIopenai-completions (tương thích với 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 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 và làm theo các bước thiết lập.
Phù hợp nhất cho: 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="..."
Tùy chọn đặt một vùng (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 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 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 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ờ
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 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

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