OpenClaw Claude API 연결

OpenClaw에서 1折AI Claude API 중계 주소, 키, 모델을 구성하는 튜토리얼로, 프로토콜 선택, 구성 예제, 검증 단계 및 일반적인 오류를 포함합니다.

OpenClaw의 사용자 지정 공급자 기능을 사용하여 1折AI에 연결합니다. 먼저 API 키 생성을 하고 현재 사용 가능한 모델을 확인하세요. 아래 모델 ID는 예제이므로 키 권한에 맞게 조정하세요.

공식 구성 확인 날짜: 2026-10-15. 다음 구성은 공식 문서에 따라 정리되었으며, 이 사이트의 엔드투엔드 검증은 아직 완료되지 않았습니다. 짧은 Q&A와 도구 호출 검증을 먼저 완료한 후 장기 작업에 사용하세요. OpenAI / GPT 모델이 출시되었으며, 모델 목록과 가격은 모델 설명을 참조하세요.

사용자 지정 공급자와 구성 예제에 따라 ~/.openclaw/openclaw.json에 병합합니다:

1
{
2
  "agents": {
3
    "defaults": {
4
      "model": { "primary": "onezhe/claude-sonnet-4-6" },
5
      "models": { "onezhe/claude-sonnet-4-6": { "alias": "1折AI Claude" } }
6
    }
7
  },
8
  "models": {
9
    "mode": "merge",
10
    "providers": {
11
      "onezhe": {
12
        "baseUrl": "https://1zheai.com",
13
        "apiKey": "${ONEZHE_API_KEY}",
14
        "api": "anthropic-messages",
15
        "models": [
16
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
17
        ]
18
      }
19
    }
20
  }
21
}

실제로 Gateway를 실행하는 프로세스가 ONEZHE_API_KEY을 읽을 수 있는지 확인하세요. 터미널의 환경 변수는 기존 백그라운드 서비스에 전달되지 않을 수 있습니다. 공식 Synthetic 문서에 따르면 Anthropic 클라이언트는 자동으로 /v1을 추가하므로, 여기에는 /v1을 포함하지 않고 전체 /v1/messages도 입력하지 않습니다.

Chat Completions로 전환할 때는 baseUrl: "https://1zheai.com/v1"과 api: "openai-completions"로 쌍을 교체합니다. 이름에 completions가 포함되어 있지만 이 어댑터는 /v1/chat/completions에 해당합니다. openai-responses을 잘못 선택하지 마세요. 기존 모델 허용 목록은 다른 항목을 유지하면서 새 모델을 추가해야 합니다. 예제는 비용이나 컨텍스트 매개변수를 지어내지 않았습니다. 현재 설치된 버전의 검증에 추가 메타데이터가 필요하다면, 실제 모델 기능을 먼저 확인한 후 보완하세요.

연결 검증 및 문제 해결

구성을 저장하고 다시 로드하여 현재 선택된 공급자가 onezhe 공급자 또는 추가한 사용자 지정 모델인지 확인합니다.
짧은 질문을 하나 보내 응답이 반환되는지 확인한 후, 되돌릴 수 있는 작은 작업을 하나 시도하여 도구 호출과 다중 턴 대화를 별도로 확인합니다.
호출 로그를 열어 요청 시간, 모델, 상태 및 사용량을 확인합니다. 한 번의 텍스트 응답이 성공했다고 해서 모든 Agent 기능이 호환된 것은 아닙니다.
404가 발생하면 이 문서의 주소와 프로토콜이 맞는지 확인하고, 401이 발생하면 키의 출처와 프로세스가 환경 변수를 읽었는지 확인하며, 429가 발생하면 속도 제한 정보를 확인한 후 재시도합니다. 자세한 내용은 오류 코드 및 문제 해결을 참조하세요.

키는 로컬 환경 또는 도구의 자격 증명 저장소에만 저장하고, 코드 저장소, 스크린샷 또는 공개 로그에 커밋하지 마세요. 백그라운드 서비스는 터미널 환경 변수를 상속하지 않을 수 있습니다. 보조 모델, 검색 및 기타 도구에도 별도의 공급자 설정이 있을 수 있으므로 각각 확인해야 합니다.

비용 및 기타 연결 방법

Claude API 실시간 가격과 과금 규칙을 확인하세요. 다른 클라이언트가 필요하면 도구 연결 디렉터리로 돌아가세요. 직접 프로그램을 작성하려면 SDK 및 개발 가이드를 사용하세요.