OpenClaw에서 즈푸 GLM(ChatGLM) 모델 연결하기

즈푸AI와 GLM 시리즈 모델

즈푸AI는 칭화대학교 기술팀이 인큐베이팅한 AI 회사로, GLM(General Language Model) 시리즈 모델은 학계와 산업계 모두에서 높은 평가를 받고 있습니다. GLM 모델은 자체 개발한 기술 노선을 기반으로 하며, 중영문 이중 언어 이해, 논리 추론, 지식 질의응답 분야에서 뛰어난 성능을 보여줍니다. ChatGLM은 대화 최적화 버전으로, 중국 내에서 가장 인기 있는 오픈소스 대규모 언어 모델 중 하나입니다.

OpenClaw은 즈푸AI를 모델 제공자로 네이티브 지원하며, 간단한 설정만으로 GLM 시리즈의 다양한 모델을 연결할 수 있습니다.

즈푸AI API 키 발급

즈푸AI 개방 플랫폼(open.bigmodel.cn)에 접속하여 계정을 등록합니다.
개발자 인증을 완료합니다.
콘솔의 API 키 관리 페이지에서 새 키를 생성합니다.
API 키를 안전하게 보관합니다.

즈푸AI는 신규 사용자에게 무료 Token 할당량을 제공하므로, 테스트와 초기 평가에 활용할 수 있습니다.

빠른 설정

OpenClaw 가이드 도구를 통해 빠르게 설정을 완료합니다:

openclaw onboard

GLM(즈푸AI)을 제공자로 선택하고, API 키를 입력한 후, 기본 사용 모델을 선택합니다.

수동 설정

openclaw.json에서 GLM을 기본 모델로 설정합니다:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "glm/glm-4"
      }
    }
  }
}

인증 설정

{
  "providers": {
    "glm": {
      "auth": [
        {
          "key": "즈푸AI API 키"
        }
      ]
    }
  }
}

다중 계정 설정:

{
  "providers": {
    "glm": {
      "auth": [
        { "key": "키A", "profile": "기본 계정" },
        { "key": "키B", "profile": "백업 계정" },
        { "key": "키C", "profile": "피크 시간 백업" }
      ]
    }
  }
}

OpenClaw의 다중 계정 인증 시스템은 자동으로 profile을 순환합니다. 특정 키가 속도 제한이나 비정상 응답을 만나면, 시스템이 자동으로 다음 사용 가능한 profile로 전환하고 실패한 키에 대해 쿨다운 타이머를 시작합니다. 쿨다운 기간이 끝나면 해당 키가 자동으로 사용 가능 상태로 복구됩니다.

GLM 모델 선택 가이드

즈푸AI는 서로 다른 용도의 여러 모델을 제공합니다:

glm/glm-4: 최신 플래그십 모델, 종합 능력이 가장 강력하며 128K 컨텍스트를 지원합니다. 복잡한 작업에 적합합니다.
glm/glm-4-plus: 향상 버전으로, 추론 및 창작 능력이 더욱 개선되었습니다.
glm/glm-4-air: 경량 고속 버전으로, 지연이 낮고 비용이 적어 빠른 응답이 필요한 시나리오에 적합합니다.
glm/glm-4-flash: 초고속 버전으로, 비용이 가장 낮아 간단한 대화와 높은 동시 호출에 적합합니다.
glm/glm-4v: 멀티모달 버전으로, 이미지 이해를 지원합니다.

구체적인 필요에 따라 적절한 모델을 선택하세요. 일상 대화 시나리오에서는 glm-4-air가 좋은 가성비를 제공합니다.

GLM의 기술적 특징

GLM 모델에는 몇 가지 주목할 만한 기술적 특징이 있습니다:

이중 언어 능력: GLM은 중영문 이중 언어 작업 모두에서 우수한 성능을 보여, 빈번한 중영문 전환이 필요한 시나리오에 적합합니다.
도구 호출: GLM-4는 Function Calling 기능을 지원하여 외부 도구 및 API와 상호작용할 수 있습니다.
긴 컨텍스트: GLM-4는 128K 컨텍스트 윈도우를 지원하여 긴 문서와 복잡한 다중 턴 대화를 처리할 수 있습니다.
지식 시의성: 즈푸AI는 모델의 지식 베이스를 정기적으로 업데이트하여 정보의 시의성을 유지합니다.

장애 조치 설정

GLM에 장애 조치 체인을 설정합니다:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "glm/glm-4",
        "fallback": "qwen/qwen-max"
      }
    }
  }
}

GLM과 Qwen은 모두 중국어 능력이 뛰어난 중국산 모델로, 상호 백업으로 사용하면 서비스 중단 시에도 사용자에게 유사한 경험을 제공할 수 있습니다.

OpenClaw 생태계와의 통합

GLM을 OpenClaw에 통합하면, OpenClaw의 풍부한 기능을 활용하여 GLM 사용 경험을 향상시킬 수 있습니다:

멀티 플랫폼 배포: OpenClaw을 통해 GLM 모델을 Discord, Telegram, Slack 등 여러 채팅 플랫폼에 연결합니다.
채널별 모델 전환: 특정 채널에서는 GLM을, 다른 채널에서는 다른 모델을 사용합니다.
통합 관리: OpenClaw의 통합 대시보드에서 GLM과 다른 모든 제공자의 설정을 관리합니다.

주의사항

API 속도 제한: 즈푸AI는 무료 및 유료 할당량에 따라 동시 요청 제한이 다르므로, 고빈도 사용 시나리오에서는 여러 키를 설정하는 것을 권장합니다.
콘텐츠 심사: GLM 모델은 중국 내 콘텐츠 규정 기준을 따릅니다.
모델 업데이트: 즈푸AI는 정기적으로 모델 버전을 업데이트하므로, 공식 공지를 확인하고 적시에 설정을 조정하는 것이 좋습니다.

테스트 및 검증

설정 완료 후 테스트 메시지를 보내보세요. 중영문 이중 언어 작업을 시도하여 GLM의 이중 언어 능력을 경험해 보는 것을 권장합니다. OpenClaw 로그를 확인하여 요청이 올바르게 즈푸AI로 라우팅되었는지 확인하세요.