Providers
Amazon Bedrock Mantle
OpenClaw에는 Mantle OpenAI 호환 엔드포인트에 연결하는 번들 Amazon Bedrock Mantle Provider가 포함되어 있습니다. Mantle은 Bedrock 인프라를 기반으로 한 표준 /v1/chat/completions 표면을 통해 오픈소스 및 서드파티 모델(GPT-OSS, Qwen, Kimi, GLM 등)을 호스팅합니다.
| 속성 | 값 |
|---|---|
| Provider ID | amazon-bedrock-mantle |
| API | openai-completions (OpenAI 호환) 또는 anthropic-messages (Anthropic Messages 경로) |
| 인증 | 명시적 AWS_BEARER_TOKEN_BEDROCK 또는 IAM 자격 증명 체인 기반 bearer-token 생성 |
| 기본 리전 | us-east-1 (AWS_REGION 또는 AWS_DEFAULT_REGION으로 재정의 가능) |
시작하기
선호하는 인증 방법을 선택하고 설정 단계를 따르세요.
명시적 bearer token
적합한 경우: 이미 Mantle bearer token이 있는 환경.
Gateway 호스트에 bearer token 설정
export AWS_BEARER_TOKEN_BEDROCK="..."
필요하면 리전을 설정하세요(기본값 us-east-1):
export AWS_REGION="us-west-2"
모델이 검색되는지 확인
openclaw models list
검색된 모델은 amazon-bedrock-mantle Provider 아래에 표시됩니다. 기본값을 재정의하고 싶지 않다면 추가 구성은 필요하지 않습니다.
IAM 자격 증명
적합한 경우: AWS SDK 호환 자격 증명(shared config, SSO, web identity, 인스턴스 또는 태스크 역할)을 사용하는 경우.
Gateway 호스트에 AWS 자격 증명 구성
모든 AWS SDK 호환 인증 소스를 사용할 수 있습니다:
export AWS_PROFILE="default"
export AWS_REGION="us-west-2"
모델이 검색되는지 확인
openclaw models list
OpenClaw는 자격 증명 체인에서 자동으로 Mantle bearer token을 생성합니다.
자동 모델 검색
AWS_BEARER_TOKEN_BEDROCK가 설정되어 있으면 OpenClaw는 이를 직접 사용합니다. 그렇지 않으면 OpenClaw는 AWS 기본 자격 증명 체인에서 Mantle bearer token을 생성하려고 시도합니다. 그런 다음 리전의 /v1/models 엔드포인트를 조회해 사용 가능한 Mantle 모델을 검색합니다.
| 동작 | 세부 정보 |
|---|---|
| 검색 캐시 | 결과를 1시간 동안 캐시 |
| IAM 토큰 새로고침 | 1시간마다 |
지원 리전
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는 정상적으로 계속 동작합니다.
Anthropic Messages 경로를 통한 Claude Opus 4.7
Mantle은 동일한 bearer 인증 스트리밍 경로를 통해 Claude 모델을 전달하는 Anthropic Messages 경로도 노출합니다. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7)은 Provider 소유 스트리밍을 통해 이 경로에서 호출할 수 있으므로, AWS bearer token은 Anthropic API 키처럼 취급되지 않습니다.
Mantle Provider에 Anthropic Messages 모델을 고정하면, OpenClaw는 해당 모델에 대해 openai-completions 대신 anthropic-messages API 표면을 사용합니다. 인증은 여전히 AWS_BEARER_TOKEN_BEDROCK(또는 발급된 IAM bearer token)에서 옵니다.
{
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 Provider와의 관계
Bedrock Mantle은 표준 Amazon Bedrock Provider와는 별개의 Provider입니다. Mantle은 OpenAI 호환 /v1 표면을 사용하고, 표준 Bedrock Provider는 네이티브 Bedrock API를 사용합니다.
두 Provider는 존재할 경우 동일한 AWS_BEARER_TOKEN_BEDROCK 자격 증명을 공유합니다.