Models CLI

auth profile 회전, 쿨다운 및 fallback과의 상호 작용은 /concepts/model-failover 참조. 빠른 provider 개요 + 예제: /concepts/model-providers.

Model 선택 작동 방식

OpenClaw는 다음 순서로 model을 선택합니다:

  1. Primary model (agents.defaults.model.primary 또는 agents.defaults.model).
  2. agents.defaults.model.fallbacks의 Fallback (순서대로).
  3. Provider auth 장애 조치는 다음 model로 이동하기 전에 provider 내부에서 발생합니다.

관련:

  • agents.defaults.models는 OpenClaw가 사용할 수 있는 model의 allowlist/catalog입니다 (+ alias).
  • agents.defaults.imageModel은 primary model이 이미지를 허용할 수 없을 때만 사용됩니다.
  • Agent별 기본값은 agents.list[].model + binding을 통해 agents.defaults.model을 재정의할 수 있습니다 (/concepts/multi-agent 참조).

빠른 model 선택 (일화적)

  • GLM: 코딩/tool 호출에 약간 더 좋습니다.
  • MiniMax: 작성 및 분위기에 더 좋습니다.

설정 마법사 (권장)

config를 수동으로 편집하고 싶지 않다면 온보딩 마법사를 실행하세요:

openclaw onboard

OpenAI Code (Codex) 구독 (OAuth) 및 Anthropic (API key 권장; claude setup-token도 지원됨)을 포함한 일반 provider에 대해 model + auth를 설정할 수 있습니다.

CLI 명령

openclaw models list
openclaw models status
openclaw models set <provider/model>
openclaw models set-image <provider/model>

openclaw models aliases list
openclaw models aliases add <alias> <provider/model>
openclaw models aliases remove <alias>

openclaw models fallbacks list
openclaw models fallbacks add <provider/model>
openclaw models fallbacks remove <provider/model>
openclaw models fallbacks clear

openclaw models (하위 명령 없음)는 models status의 바로 가기입니다.

자세한 내용 및 스캔 기능은 영문 원본을 참조하세요 (Models).

← 문서로 돌아가기