메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

GLM은 Z.AI 플랫폼을 통해 사용할 수 있는 모델 패밀리(회사 아님)입니다. OpenClaw에서는 zai/glm-5.1 같은 참조를 사용해 번들 포함된 zai provider를 통해 GLM 모델에 접근합니다.
속성값
Provider IDzai
Plugin번들 포함, enabledByDefault: true
인증 환경 변수ZAI_API_KEY 또는 Z_AI_API_KEY
온보딩 선택지zai-api-key, zai-coding-global, zai-coding-cn, zai-global, zai-cn
APIOpenAI 호환
기본 base URLhttps://api.z.ai/api/paas/v4
권장 기본값zai/glm-5.1
기본 이미지 모델zai/glm-4.6v

​
시작하기

1

인증 경로를 선택하고 온보딩 실행

사용 중인 Z.AI 플랜과 지역에 맞는 온보딩 선택지를 고르세요. 일반 zai-api-key 선택지는 키 형태에서 일치하는 엔드포인트를 자동 감지합니다. 특정 Coding Plan 또는 일반 API 표면을 강제로 사용하려면 명시적 지역 선택지를 사용하세요.
인증 선택지가장 적합한 경우
zai-api-key엔드포인트 자동 감지가 필요한 일반 API 키
zai-coding-globalCoding Plan 사용자(글로벌)
zai-coding-cnCoding Plan 사용자(중국 지역)
zai-global일반 API(글로벌)
zai-cn일반 API(중국 지역)
openclaw onboard --auth-choice zai-api-key
2

GLM을 기본 모델로 설정

openclaw config set agents.defaults.model.primary "zai/glm-5.1"
3

모델 사용 가능 여부 확인

openclaw models list --provider zai

​
구성 예시

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

​
기본 제공 카탈로그

번들 포함된 zai provider는 13개의 GLM 모델 참조를 시드합니다. 별도로 표시되지 않은 한 모든 항목은 추론을 지원합니다. glm-5v-turbo와 glm-4.6v는 텍스트뿐 아니라 이미지 입력도 받습니다.
모델 참조참고 사항
zai/glm-5.1기본 모델. 추론, 텍스트 전용, 202k 컨텍스트.
zai/glm-5추론, 텍스트 전용, 202k 컨텍스트.
zai/glm-5-turbo추론, 텍스트 전용, 202k 컨텍스트.
zai/glm-5v-turbo추론, 텍스트 + 이미지, 202k 컨텍스트.
zai/glm-4.7추론, 텍스트 전용, 204k 컨텍스트.
zai/glm-4.7-flash추론, 텍스트 전용, 200k 컨텍스트.
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 버전과 사용 가능 여부는 변경될 수 있습니다. 설치된 버전이 알고 있는 카탈로그 행을 보려면 openclaw models list --provider zai를 실행하고, 새로 추가되었거나 더 이상 권장되지 않는 모델은 Z.AI 문서를 확인하세요.

​
고급 구성

zai-api-key 인증 선택지를 사용하면 OpenClaw가 키 형태를 검사해 올바른 Z.AI base URL을 결정합니다. 명시적 지역 선택지(zai-coding-global, zai-coding-cn, zai-global, zai-cn)는 자동 감지를 재정의하고 엔드포인트를 직접 고정합니다.
GLM 모델은 zai 런타임 provider에서 제공됩니다. 전체 provider 구성, 지역 엔드포인트, 추가 기능은 Z.AI provider 페이지를 참조하세요.

​
관련 항목

Z.AI provider

전체 Z.AI provider 구성과 지역 엔드포인트입니다.

모델 provider

provider, 모델 참조, 장애 조치 동작 선택입니다.

사고 모드

추론 가능한 GLM 패밀리를 위한 /think 수준입니다.

모델 FAQ

인증 프로필, 모델 전환, “no profile” 오류 해결입니다.