Z.AI와 GLM 모델 설정하기

새로운 AI 모델을 프로젝트에 통합할 때마다 복잡한 설정 과정 때문에 흐름이 끊기는 경험을 해보셨을 거예요. API 키를 관리하고 환경 설정을 맞추는 반복적인 작업은 개발자의 집중력을 흩트리곤 하죠.

필요한 것

• Z.AI API key (Z.AI console에서 생성)

빠른 시작

Z.AI는 GLM 모델을 위한 API 플랫폼이에요. OpenClaw에서 zai provider를 사용해 설정을 빠르게 끝낼 수 있습니다.

먼저 CLI를 통해 인증을 진행하세요:

openclaw onboard --auth-choice zai-api-key
# 또는 비대화형 방식
openclaw onboard --zai-api-key "$ZAI_API_KEY"

그다음 설정 파일에 아래 코드를 추가하면 됩니다:

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

문제 해결

• Z.AI는 API key를 사용한 Bearer auth 방식을 사용해요. 인증 문제가 생긴다면 API key가 올바른지 확인이 필요합니다.
• 모델 명칭은 반드시 zai/glm-4.7과 같이 zai/<model> 형식을 따라야 합니다.

설정 과정에서 도움이 필요하다면 AI Setup Assistant에게 질문해 보세요.

다음 단계

• /providers/glm: GLM 모델 패밀리 개요 확인