OpenClaw에서 Amazon Bedrock 연결하기

Amazon Bedrock 소개

Amazon Bedrock은 AWS에서 출시한 완전 관리형 AI 서비스 플랫폼으로, Anthropic, Meta, Mistral 등 여러 공급업체의 파운데이션 모델을 제공합니다. Bedrock을 통해 AWS 인프라 내에서 다양한 대규모 모델을 안전하게 호출할 수 있으며, AWS의 보안 규정 준수 체계, VPC 네트워크 격리, IAM 권한 관리를 함께 활용할 수 있습니다.

OpenClaw은 Amazon Bedrock을 일급 제공업체로 지원하며, 표준 provider/model-name 형식으로 Bedrock의 모든 사용 가능한 모델에 접근할 수 있습니다. 이미 AWS 서비스를 깊이 사용하고 있는 팀에게 Bedrock은 자연스럽고 효율적인 선택입니다.

사전 준비

설정을 시작하기 전에 다음 준비 작업이 필요합니다:

AWS 계정: 유효한 AWS 계정을 보유해야 합니다.
Bedrock 서비스 활성화: AWS 콘솔에서 Amazon Bedrock으로 이동하여 필요한 모델 접근 권한을 신청합니다. 일부 모델(예: Claude 시리즈)은 별도 승인이 필요합니다.
IAM 자격 증명 생성: bedrock:InvokeModel 권한이 있는 IAM 사용자 또는 역할을 생성하고, Access Key ID와 Secret Access Key를 발급받습니다.

IAM 정책으로 접근 가능한 모델 범위를 정밀하게 제어하고, 최소 권한 원칙을 따르는 것을 권장합니다.

OpenClaw Onboard로 설정

가장 간단한 설정 방법은 OpenClaw의 내장 가이드 도구를 사용하는 것입니다:

openclaw onboard

Amazon Bedrock을 제공업체로 선택하고, 안내에 따라 AWS 자격 증명 정보와 리전 설정을 입력합니다. 가이드 도구가 자동으로 설정 파일을 생성합니다.

수동으로 openclaw.json 설정

openclaw.json을 수동으로 편집하여 Bedrock을 설정합니다:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0"
      }
    }
  }
}

Bedrock의 모델 명명은 AWS 자체의 모델 ID 형식을 따르며, OpenClaw에서는 bedrock/ 접두사를 추가해야 합니다.

AWS 인증 설정

Bedrock의 인증 방식은 다른 제공업체와 약간 다르며, AWS 자격 증명 정보를 제공해야 합니다:

{
  "providers": {
    "bedrock": {
      "region": "us-east-1",
      "auth": [
        {
          "accessKeyId": "AWS_ACCESS_KEY_ID",
          "secretAccessKey": "AWS_SECRET_ACCESS_KEY"
        }
      ]
    }
  }
}

여러 AWS 자격 증명을 설정하여 다중 계정 순환도 가능합니다:

{
  "providers": {
    "bedrock": {
      "region": "us-east-1",
      "auth": [
        {
          "accessKeyId": "계정A KEY",
          "secretAccessKey": "계정A SECRET",
          "profile": "주 계정"
        },
        {
          "accessKeyId": "계정B KEY",
          "secretAccessKey": "계정B SECRET",
          "profile": "보조 계정"
        }
      ]
    }
  }
}

주 계정에서 속도 제한이나 인증 실패가 발생하면 OpenClaw이 자동으로 보조 계정으로 전환하고, 주 계정에 쿨다운 추적을 시작하여 일정 시간 후 다시 시도합니다.

Bedrock에서 자주 사용되는 모델

Bedrock을 통해 접근할 수 있는 인기 모델들:

bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0: Claude 3.5 Sonnet, 가성비가 뛰어난 만능 모델.
bedrock/anthropic.claude-3-opus-20240229-v1:0: Claude 3 Opus, 복잡한 추론 작업에 최적.
bedrock/meta.llama3-1-70b-instruct-v1:0: Meta Llama 3.1 70B, 강력한 오픈소스 모델.
bedrock/mistral.mistral-large-2407-v1:0: Mistral Large, 유럽 AI 업체의 플래그십 모델.

Bedrock에서의 모델 가용성은 선택한 AWS 리전에 따라 달라지며, 리전별로 지원되는 모델 목록이 다를 수 있습니다.

리전 선택 가이드

AWS Bedrock은 여러 리전에서 서비스를 제공하며, 리전 선택 시 고려사항:

지연 시간: 사용자에게 가장 가까운 리전을 선택합니다.
모델 가용성: us-east-1과 us-west-2가 보통 가장 많은 모델을 지원합니다.
규정 준수 요구: 일부 데이터 규정은 데이터가 국외로 나가지 않도록 요구하므로 해당 리전을 선택해야 합니다.

장애 조치 설정

Bedrock에 대해 제공업체 간 장애 조치를 설정하는 것을 권장합니다:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0",
        "fallback": "anthropic/claude-3-5-sonnet-20241022"
      }
    }
  }
}

이렇게 하면 Bedrock 서비스에 문제가 생겼을 때 시스템이 자동으로 Anthropic 직접 연결 API로 전환하여 서비스 중단을 방지합니다.

Bedrock의 고유한 장점

Bedrock을 통해 모델에 접근하는 것이 각 업체 API를 직접 사용하는 것에 비해 가지는 장점:

통합 결제: 모든 모델 비용이 AWS 청구서에 통합되어 재무 관리가 간소화됩니다.
기업 보안: AWS의 보안 규정 준수 체계를 상속하며, VPC, 프라이빗 링크 등 기업급 네트워크 설정을 지원합니다.
다중 API 키 관리 불필요: 하나의 AWS 자격 증명으로 Bedrock의 모든 모델에 접근합니다.

위의 설정을 완료한 후 테스트 메시지를 보내 Bedrock 연결이 정상적으로 작동하는지 확인하세요. OpenClaw 로그에서 요청이 Bedrock 서비스로 올바르게 라우팅되었는지 확인합니다.