메인 콘텐츠로 건너뛰기

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.

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

​
시작하기

권장 대상: 대부분의 사용자. OpenClaw는 키에서 일치하는 Z.AI 엔드포인트를 감지하고 올바른 기본 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 --all --provider zai

​
기본 제공 카탈로그

OpenClaw는 Plugin 매니페스트에 번들된 zai provider 카탈로그를 포함하므로, 읽기 전용 목록 표시에서 provider 런타임을 로드하지 않고도 알려진 GLM 행을 표시할 수 있습니다. 
openclaw models list --all --provider zai
매니페스트 기반 카탈로그에는 현재 다음이 포함됩니다.
모델 참조참고
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). 기본 번들 모델 참조는 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 사고는 OpenClaw의 /think 제어를 따릅니다. 사고가 꺼져 있으면 OpenClaw는 표시 텍스트보다 먼저 reasoning_content에 출력 예산을 쓰는 응답을 피하기 위해 thinking: { type: "disabled" }를 보냅니다.보존된 사고는 Z.AI가 전체 과거 reasoning_content를 다시 재생하도록 요구하여 프롬프트 토큰이 늘어나므로 옵트인 방식입니다. 모델별로 활성화하세요.
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.1": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
활성화되어 있고 사고가 켜져 있으면 OpenClaw는 thinking: { type: "enabled", clear_thinking: false }를 보내고 동일한 OpenAI 호환 transcript에 대해 이전 reasoning_content를 다시 재생합니다.고급 사용자는 여전히 params.extra_body.thinking으로 정확한 provider 페이로드를 재정의할 수 있습니다.
번들 Z.AI Plugin은 이미지 이해를 등록합니다.
속성값
모델glm-4.6v
이미지 이해는 구성된 Z.AI 인증에서 자동으로 해석되므로 추가 구성이 필요하지 않습니다.
  • Z.AI는 API 키와 함께 Bearer auth를 사용합니다.
  • zai-api-key 온보딩 선택지는 키 접두사에서 일치하는 Z.AI 엔드포인트를 자동 감지합니다.
  • 특정 API 표면을 강제로 사용하려면 명시적 지역 선택지(zai-coding-global, zai-coding-cn, zai-global, zai-cn)를 사용하세요.

​
관련 항목

GLM 모델 제품군

GLM의 모델 제품군 개요입니다.

모델 선택

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