메인 콘텐츠로 건너뛰기

​
Z.AI

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

​
CLI 설정

# 엔드포인트 자동 감지가 포함된 일반 API 키 설정
openclaw onboard --auth-choice zai-api-key

# Coding Plan Global, Coding Plan 사용자에게 권장
openclaw onboard --auth-choice zai-coding-global

# Coding Plan CN(중국 리전), Coding Plan 사용자에게 권장
openclaw onboard --auth-choice zai-coding-cn

# 일반 API
openclaw onboard --auth-choice zai-global

# 일반 API CN(중국 리전)
openclaw onboard --auth-choice zai-cn

​
구성 스니펫

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "zai/glm-5" } } },
}
zai-api-key를 사용하면 OpenClaw가 키에서 일치하는 Z.AI 엔드포인트를 감지하고 올바른 기본 URL을 자동으로 적용할 수 있습니다. 특정 Coding Plan 또는 일반 API 표면을 강제로 사용하려는 경우에는 명시적인 리전 선택을 사용하세요.

​
번들된 GLM 카탈로그

OpenClaw는 현재 번들된 zai provider에 다음 모델을 시드합니다:
  • glm-5.1
  • glm-5
  • glm-5-turbo
  • glm-5v-turbo
  • glm-4.7
  • glm-4.7-flash
  • glm-4.7-flashx
  • glm-4.6
  • glm-4.6v
  • glm-4.5
  • glm-4.5-air
  • glm-4.5-flash
  • glm-4.5v

​
참고

  • GLM 모델은 zai/<model>로 제공됩니다(예: zai/glm-5).
  • 기본 번들 모델 참조: zai/glm-5
  • 알 수 없는 glm-5* id도 현재 GLM-5 제품군 형태와 일치하는 경우 glm-4.7 템플릿에서 provider 소유 메타데이터를 합성하여 번들 provider 경로에서 계속 정방향 해석됩니다.
  • Z.AI tool-call 스트리밍에는 기본적으로 tool_stream이 활성화되어 있습니다. 비활성화하려면 agents.defaults.models["zai/<model>"].params.tool_stream을 false로 설정하세요.
  • 모델 제품군 개요는 /providers/glm을 참조하세요.
  • Z.AI는 API 키와 함께 Bearer 인증을 사용합니다.