> ## 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.

# 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 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ính      | Giá trị                                                                                        |
| --------------- | ---------------------------------------------------------------------------------------------- |
| ID nhà cung cấp | `amazon-bedrock-mantle`                                                                        |
| API             | `openai-completions` (tương thích OpenAI) hoặc `anthropic-messages` (tuyến Anthropic Messages) |
| Xác thực        | `AWS_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 đị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 dùng và làm theo các bước thiết lập.

<Tabs>
  <Tab title="Explicit bearer token">
    **Phù hợp nhất cho:** các môi trường mà bạn đã có bearer token của Mantle.

    <Steps>
      <Step title="Set the bearer token on the gateway host">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        export AWS_BEARER_TOKEN_BEDROCK="..."
        ```

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

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        export AWS_REGION="us-west-2"
        ```
      </Step>

      <Step title="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.

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        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ữ đó.
      </Step>

      <Step title="Verify models are discovered">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        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.
      </Step>
    </Steps>
  </Tab>

  <Tab title="IAM credentials">
    **Phù hợp nhất cho:** dùng thông tin xác thực tương thích AWS SDK (cấu hình dùng chung, SSO, danh tính web, vai trò instance hoặc task).

    <Steps>
      <Step title="Configure AWS credentials on the gateway host">
        Mọi nguồn xác thực tương thích AWS SDK đều hoạt động:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        export AWS_PROFILE="default"
        export AWS_REGION="us-west-2"
        ```
      </Step>

      <Step title="Verify models are discovered">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list
        ```

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

    <Tip>
      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 dùng chung/hồ sơ cấu hình, SSO, danh tính web, và vai trò instance hoặc task.
    </Tip>
  </Tab>
</Tabs>

## 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 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ờ                         |

Để 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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false
```

<Note>
  Bearer token là cùng `AWS_BEARER_TOKEN_BEDROCK` được nhà cung cấp [Amazon Bedrock](/vi/providers/bedrock) tiêu chuẩn sử dụng.
</Note>

### 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:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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

<AccordionGroup>
  <Accordion title="Reasoning support">
    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.
  </Accordion>

  <Accordion title="Endpoint unavailability">
    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.
  </Accordion>

  <Accordion title="Claude Opus 4.7 via the Anthropic Messages route">
    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).

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      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,
              },
            ],
          },
        },
      },
    }
    ```
  </Accordion>

  <Accordion title="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](/vi/providers/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.
  </Accordion>
</AccordionGroup>

## Liên quan

<CardGroup cols={2}>
  <Card title="Amazon Bedrock" href="/vi/providers/bedrock" icon="cloud">
    Nhà cung cấp Bedrock gốc cho Anthropic Claude, Titan và các mô hình khác.
  </Card>

  <Card title="Model selection" href="/vi/concepts/model-providers" icon="layers">
    Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.
  </Card>

  <Card title="OAuth and auth" href="/vi/gateway/authentication" icon="key">
    Chi tiết xác thực và quy tắc tái sử dụng thông tin xác thực.
  </Card>

  <Card title="Troubleshooting" href="/vi/help/troubleshooting" icon="wrench">
    Các vấn đề thường gặp và cách giải quyết.
  </Card>
</CardGroup>