튜토리얼 카테고리 Skills 소개
ZH EN JA KO
모델 연결

OpenClaw 샤오미 대형 모델 및 Z.AI 연동

· 8 분 소요

샤오미 대형 모델 및 Z.AI 개요

중국 AI 산업이 활발하게 발전하면서, 점점 더 많은 기술 기업들이 자체 대규모 언어 모델을 출시하고 있습니다. 샤오미와 Z.AI는 그중 주목할 만한 두 공급자입니다.

샤오미 대형 모델: 샤오미 그룹이 자체 기술 축적과 풍부한 사용자 시나리오를 기반으로 출시한 AI 모델로, 스마트 홈 제어, 소비 전자 어시스턴트 등 수직 영역에서 독보적인 강점을 보유하고 있습니다. 샤오미 대형 모델은 샤오미 생태계의 데이터와 시나리오 이해 능력을 깊이 통합합니다.

Z.AI: 고품질 AI 추론 서비스 제공에 집중하는 플랫폼으로, 다양한 모델 선택지를 제공하며, 안정적인 서비스 품질과 합리적인 가격으로 개발자 커뮤니티에서 좋은 평판을 쌓았습니다.

OpenClaw은 이 두 공급자를 모두 지원하며, 이 글에서는 각각의 설정 방법을 소개합니다.

샤오미 대형 모델 설정

API 키 발급

  1. 샤오미 AI 개방 플랫폼에 접속하여 개발자 계정을 등록합니다.
  2. 콘솔에서 애플리케이션을 생성하고 API 키를 발급받습니다.
  3. 자격 증명 정보를 안전하게 보관합니다.

Onboard를 사용한 설정

openclaw onboard

Xiaomi(샤오미)를 모델 공급자로 선택하고, 안내에 따라 설정을 완료합니다.

수동 설정

openclaw.json에서 샤오미 대형 모델을 설정합니다:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "xiaomi/mi-llm-pro"
      }
    }
  }
}

인증 설정:

{
  "providers": {
    "xiaomi": {
      "auth": [
        {
          "key": "샤오미 AI API 키"
        }
      ]
    }
  }
}

다중 계정 로테이션:

{
  "providers": {
    "xiaomi": {
      "auth": [
        { "key": "키A", "profile": "주 계정" },
        { "key": "키B", "profile": "백업 계정" }
      ]
    }
  }
}

샤오미 모델 특징

샤오미 대형 모델의 장점은 주로 다음에서 나타납니다:

  • IoT 시나리오 이해: 스마트 홈 제어 명령에 대한 뛰어난 이해 능력으로, 사용자의 기기 제어 의도를 정확하게 파싱합니다.
  • 소비 시나리오 최적화: 상품 추천, 사용자 서비스 등 소비 시나리오에서 좋은 성능을 보입니다.
  • 중국어 구어 이해: 중국어 구어 표현에 대한 이해 능력이 뛰어납니다.

Z.AI 설정

API 키 발급

  1. Z.AI 공식 플랫폼에 접속하여 계정을 등록합니다.
  2. 개발자 콘솔에서 API 키를 생성합니다.
  3. 필요에 따라 적합한 요금제를 선택합니다.

수동 설정

openclaw.json에서 Z.AI를 설정합니다:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "zai/zai-large"
      }
    }
  }
}

인증 설정:

{
  "providers": {
    "zai": {
      "auth": [
        {
          "key": "Z.AI API 키"
        }
      ]
    }
  }
}

마찬가지로 다중 계정 설정을 지원합니다:

{
  "providers": {
    "zai": {
      "auth": [
        { "key": "키A", "profile": "주" },
        { "key": "키B", "profile": "백업" }
      ]
    }
  }
}

Z.AI 모델 선택

Z.AI 플랫폼에서 사용 가능한 모델은 다음과 같습니다:

  • zai/zai-large: 대규모 모델로, 종합 능력이 강하며 복잡한 작업에 적합합니다.
  • zai/zai-standard: 표준 버전으로, 가성비가 높습니다.

다중 계정 인증 및 냉각 추적

샤오미든 Z.AI든 OpenClaw의 다중 계정 인증 메커니즘은 완전히 적용됩니다. auth 배열에 여러 키를 설정하면:

  • 시스템은 기본적으로 첫 번째 profile을 사용하여 요청을 보냅니다.
  • 해당 profile이 속도 제한이나 서비스 오류를 만나면 자동으로 다음으로 전환합니다.
  • 실패한 profile은 냉각 상태에 들어가고, 냉각 추적 시스템이 실패 시간과 유형을 기록합니다.
  • 냉각 기간이 끝나면 profile이 자동으로 사용 가능 상태로 복귀합니다.

이 메커니즘은 단일 API 키에 문제가 발생해도 서비스가 중단되지 않도록 보장합니다.

장애 조치 설정

샤오미와 Z.AI에 대해 교차 공급자 장애 조치를 설정하는 것을 권장합니다:

샤오미의 장애 조치

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "xiaomi/mi-llm-pro",
        "fallback": "qwen/qwen-plus"
      }
    }
  }
}

Z.AI의 장애 조치

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "zai/zai-large",
        "fallback": "glm/glm-4"
      }
    }
  }
}

마찬가지로 중국어에 뛰어난 국산 모델을 서로의 백업으로 사용하여 사용자 경험의 일관성을 보장합니다.

샤오미와 Z.AI 동시 사용

서로 다른 채널에서 이 두 공급자를 각각 사용할 수도 있습니다:

{
  "agents": {
    "channels": {
      "smart-home-support": {
        "model": {
          "primary": "xiaomi/mi-llm-pro"
        }
      },
      "general-chat": {
        "model": {
          "primary": "zai/zai-large"
        }
      }
    }
  }
}

샤오미 모델로 스마트 홈 관련 상담을 처리하고, 범용 대화 시나리오에서는 Z.AI를 사용합니다.

국산 모델 생태계의 가치

국산 모델 공급자를 선택하면 몇 가지 중요한 이점이 있습니다:

  • 낮은 지연시간: 서버가 보통 중국 내에 배포되어 있어, 중국 내 사용자의 접근 지연시간이 낮습니다.
  • 중국어 최적화: 국산 모델은 일반적으로 중국어 이해 및 생성에 대해 대량의 최적화를 수행합니다.
  • 데이터 규정 준수: 데이터 저장 및 처리가 완전히 국내에서 이루어져, 데이터 국외 반출 규정 준수 요구사항을 충족합니다.
  • 가격 우위: 해외 공급자에 비해 국산 모델은 보통 더 경쟁력 있는 가격을 제공합니다.

OpenClaw은 통합된 공급자 비종속 아키텍처를 통해, 국산 모델과 해외 모델 간에 자유롭게 전환하여 자신의 요구에 가장 적합한 조합 방안을 찾을 수 있습니다.

검증 및 테스트

설정 완료 후, 각각 테스트 메시지를 보내 샤오미 대형 모델과 Z.AI가 정상적으로 응답하는지 확인합니다. OpenClaw 로그를 확인하여 요청이 해당 공급자로 올바르게 라우팅되었는지 확인합니다. 다른 모델의 성능을 비교해야 하는 경우, OpenClaw의 채널별 설정 기능을 활용하여 다른 채널에서 동시에 테스트할 수 있습니다.

OpenClaw는 무료 오픈소스 개인 AI 어시스턴트로, WhatsApp, Telegram, Discord 등 다양한 플랫폼을 지원합니다