메인 콘텐츠로 건너뛰기

​
Amazon Bedrock Mantle

OpenClaw에는 Mantle OpenAI 호환 엔드포인트에 연결하는 번들 Amazon Bedrock Mantle provider가 포함되어 있습니다. Mantle은 Bedrock 인프라 기반의 표준 /v1/chat/completions 인터페이스를 통해 오픈 소스 및 서드파티 모델(GPT-OSS, Qwen, Kimi, GLM 등)을 호스팅합니다.
PropertyValue
Provider IDamazon-bedrock-mantle
APIopenai-completions (OpenAI 호환)
Auth명시적 AWS_BEARER_TOKEN_BEDROCK 또는 IAM 자격 증명 체인 기반 bearer token 생성
Default regionus-east-1 (AWS_REGION 또는 AWS_DEFAULT_REGION으로 재정의 가능)

​
시작하기

선호하는 인증 방법을 선택하고 설정 단계를 따르세요.
가장 적합한 경우: 이미 Mantle bearer token이 있는 환경.
1

Gateway 호스트에 bearer token 설정

export AWS_BEARER_TOKEN_BEDROCK="..."
선택적으로 리전도 설정할 수 있습니다(기본값은 us-east-1):
export AWS_REGION="us-west-2"
2

모델이 검색되는지 확인

openclaw models list
검색된 모델은 amazon-bedrock-mantle provider 아래에 표시됩니다. 기본값을 재정의하려는 경우가 아니라면 추가 구성은 필요하지 않습니다.

​
자동 모델 검색

AWS_BEARER_TOKEN_BEDROCK가 설정되어 있으면 OpenClaw는 이를 직접 사용합니다. 그렇지 않으면 OpenClaw는 AWS 기본 자격 증명 체인에서 Mantle bearer token 생성을 시도합니다. 그런 다음 해당 리전의 /v1/models 엔드포인트를 조회하여 사용 가능한 Mantle 모델을 검색합니다.
BehaviorDetail
Discovery cache결과는 1시간 동안 캐시됨
IAM token refresh1시간마다 갱신
bearer token은 표준 Amazon Bedrock provider에서 사용하는 AWS_BEARER_TOKEN_BEDROCK와 동일합니다.

​
지원 리전

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.

​
수동 구성

자동 검색 대신 명시적 구성을 선호한다면: 
{
  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,
          },
        ],
      },
    },
  },
}

​
고급 참고 사항

추론 지원은 thinking, reasoner, gpt-oss-120b 같은 패턴이 포함된 모델 ID를 기준으로 추론됩니다. OpenClaw는 검색 중 일치하는 모델에 대해 자동으로 reasoning: true를 설정합니다.
Mantle 엔드포인트를 사용할 수 없거나 모델을 반환하지 않으면 해당 provider는 조용히 건너뜁니다. OpenClaw는 오류를 내지 않으며, 다른 구성된 provider는 계속 정상적으로 동작합니다.
Bedrock Mantle은 표준 Amazon Bedrock provider와는 별개의 provider입니다. Mantle은 OpenAI 호환 /v1 인터페이스를 사용하고, 표준 Bedrock provider는 네이티브 Bedrock API를 사용합니다.두 provider 모두 AWS_BEARER_TOKEN_BEDROCK가 존재할 경우 동일한 자격 증명을 공유합니다.

​
관련

Amazon Bedrock

Anthropic Claude, Titan 및 기타 모델용 네이티브 Bedrock provider.

모델 선택

provider, 모델 참조 및 장애 조치 동작 선택하기.

OAuth 및 인증

인증 세부 정보 및 자격 증명 재사용 규칙.

문제 해결

일반적인 문제와 해결 방법.