Providers
Amazon Bedrock Mantle
OpenClaw에는 Mantle OpenAI 호환 엔드포인트에 연결하는 번들 Amazon Bedrock Mantle 제공자가 포함되어 있습니다. Mantle은 Bedrock 인프라를 기반으로 하는 표준 /v1/chat/completions 표면을 통해 오픈 소스 및 타사 모델(GPT-OSS, Qwen, Kimi, GLM 등)을 호스팅합니다.
| 속성 | 값 |
|---|---|
| 제공자 ID | amazon-bedrock-mantle |
| API | openai-completions(OpenAI 호환) 또는 anthropic-messages(Anthropic Messages 경로) |
| 인증 | 명시적 AWS_BEARER_TOKEN_BEDROCK 또는 IAM 자격 증명 체인 베어러 토큰 생성 |
| 기본 리전 | us-east-1(AWS_REGION 또는 AWS_DEFAULT_REGION으로 재정의) |
시작하기
선호하는 인증 방식을 선택하고 설정 단계를 따르세요.
명시적 베어러 토큰
적합한 경우: 이미 Mantle 베어러 토큰이 있는 환경.
Gateway 호스트에 베어러 토큰 설정
export AWS_BEARER_TOKEN_BEDROCK="..."선택적으로 리전을 설정합니다(기본값은 us-east-1).
export AWS_REGION="us-west-2"Claude Fable 5용 제공자 데이터 공유 옵트인
Claude Fable 5 및 Claude Mythos급 Bedrock 모델은 호출 전에 Mantle Data Retention API 모드 provider_data_share가 필요합니다. 이 옵트인은 Bedrock이 프롬프트와 완성을 Anthropic과 공유하고, 신뢰 및 안전성 검토를 위해 최대 30일 동안 보관하도록 허용합니다.
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" }'해당 보관 모드를 수용할 수 없다면 구성에서 다른 Bedrock 모델을 사용하세요.
모델 검색 확인
openclaw models list검색된 모델은 amazon-bedrock-mantle 제공자 아래에 표시됩니다. 기본값을 재정의하려는 경우가 아니면 추가 구성이 필요하지 않습니다.
IAM 자격 증명
적합한 경우: AWS SDK 호환 자격 증명(공유 구성, SSO, 웹 ID, 인스턴스 또는 작업 역할)을 사용하는 경우.
Gateway 호스트에 AWS 자격 증명 구성
모든 AWS SDK 호환 인증 소스를 사용할 수 있습니다.
export AWS_PROFILE="default"export AWS_REGION="us-west-2"모델 검색 확인
openclaw models listOpenClaw는 자격 증명 체인에서 Mantle 베어러 토큰을 자동으로 생성합니다.
자동 모델 검색
AWS_BEARER_TOKEN_BEDROCK이 설정되어 있으면 OpenClaw는 이를 직접 사용합니다. 그렇지 않으면 OpenClaw는 AWS 기본 자격 증명 체인에서 Mantle 베어러 토큰 생성을 시도합니다. 그런 다음 해당 리전의 /v1/models 엔드포인트를 쿼리하여 사용 가능한 Mantle 모델을 검색합니다.
| 동작 | 세부 정보 |
|---|---|
| 검색 캐시 | 결과를 1시간 동안 캐시 |
| IAM 토큰 갱신 | 매시간 |
Mantle Plugin을 활성화한 상태로 유지하되 자동 검색 및 IAM 베어러 토큰 생성을 억제하려면 Plugin 소유 검색 토글을 비활성화하세요.
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false지원되는 리전
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 엔드포인트를 사용할 수 없거나 모델을 반환하지 않으면 해당 제공자는 조용히 건너뜁니다. OpenClaw는 오류를 발생시키지 않으며, 구성된 다른 제공자는 정상적으로 계속 작동합니다.
Anthropic Messages 경로를 통한 Claude Opus 4.7
Mantle은 동일한 베어러 인증 스트리밍 경로를 통해 Claude 모델을 전달하는 Anthropic Messages 경로도 노출합니다. Claude Opus 4.7(amazon-bedrock-mantle/claude-opus-4.7)은 제공자 소유 스트리밍으로 이 경로를 통해 호출할 수 있으므로, AWS 베어러 토큰은 Anthropic API 키처럼 처리되지 않습니다.
Mantle 제공자에서 Anthropic Messages 모델을 고정하면 OpenClaw는 해당 모델에 대해 openai-completions 대신 anthropic-messages API 표면을 사용합니다. 인증은 여전히 AWS_BEARER_TOKEN_BEDROCK(또는 생성된 IAM 베어러 토큰)에서 가져옵니다.
{ 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, }, ], }, }, },}Amazon Bedrock 제공자와의 관계
Bedrock Mantle은 표준 Amazon Bedrock 제공자와 별도의 제공자입니다. Mantle은 OpenAI 호환 /v1 표면을 사용하는 반면, 표준 Bedrock 제공자는 네이티브 Bedrock API를 사용합니다.
두 제공자는 AWS_BEARER_TOKEN_BEDROCK 자격 증명이 있을 때 이를 공유합니다.
