메인 콘텐츠로 건너뛰기

​
Z.AI

Z.AI는 GLM 모델용 API 플랫폼입니다. GLM용 REST API를 제공하며 인증에 API 키를 사용합니다. Z.AI 콘솔에서 API 키를 생성하세요. OpenClaw는 Z.AI API 키와 함께 zai provider를 사용합니다.
  • Provider: zai
  • 인증: ZAI_API_KEY
  • API: Z.AI Chat Completions (Bearer 인증)

​
시작하기

가장 적합한 용도: 대부분의 사용자. OpenClaw가 키에서 일치하는 Z.AI 엔드포인트를 감지하고 올바른 base URL을 자동으로 적용합니다.
1

온보딩 실행

openclaw onboard --auth-choice zai-api-key
2

기본 모델 설정

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}
3

모델 사용 가능 여부 확인

openclaw models list --provider zai

​
번들 GLM 카탈로그

OpenClaw는 현재 번들 zai provider를 다음과 같이 시드합니다.
모델 ref참고
zai/glm-5.1기본 모델
zai/glm-5
zai/glm-5-turbo
zai/glm-5v-turbo
zai/glm-4.7
zai/glm-4.7-flash
zai/glm-4.7-flashx
zai/glm-4.6
zai/glm-4.6v
zai/glm-4.5
zai/glm-4.5-air
zai/glm-4.5-flash
zai/glm-4.5v
GLM 모델은 zai/<model> 형식으로 사용할 수 있습니다(예: zai/glm-5). 기본 번들 모델 ref는 zai/glm-5.1입니다.

​
고급 구성

알 수 없는 glm-5* ID는 현재 GLM-5 계열 형태와 일치할 경우, glm-4.7 템플릿에서 provider 소유 메타데이터를 합성하여 번들 provider 경로에서 계속 전방 확인 해석됩니다.
Z.AI 도구 호출 스트리밍에서는 기본적으로 tool_stream이 활성화됩니다. 비활성화하려면:
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
번들 Z.AI Plugin은 이미지 이해를 등록합니다.
속성값
모델glm-4.6v
이미지 이해는 구성된 Z.AI 인증에서 자동으로 확인되므로 추가 구성이 필요하지 않습니다.
  • Z.AI는 API 키와 함께 Bearer 인증을 사용합니다.
  • zai-api-key 온보딩 choice는 키 접두사에서 일치하는 Z.AI 엔드포인트를 자동 감지합니다.
  • 특정 API 표면을 강제하려면 명시적 지역 choice(zai-coding-global, zai-coding-cn, zai-global, zai-cn)를 사용하세요.

​
관련 항목

GLM 모델 계열

GLM 모델 계열 개요.

모델 선택

Provider, 모델 ref, 장애 조치 동작을 선택합니다.