`openclaw models`

모델 검색, 스캔, 구성 (기본 모델, 폴백, 인증 프로필).

주요 명령어

openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan

openclaw models status는 확인된 기본/폴백 모델과 인증 개요를 표시합니다. 프로바이더 사용량 스냅샷을 사용할 수 있는 경우, OAuth/토큰 상태 섹션에 프로바이더 사용량 헤더가 포함됩니다. --probe를 추가하면 구성된 각 프로바이더 프로필에 대해 실시간 인증 프로브를 실행합니다. 프로브는 실제 요청이므로 토큰을 소비하고 속도 제한을 트리거할 수 있습니다. --agent <id>를 사용하면 구성된 에이전트의 모델/인증 상태를 확인할 수 있습니다. 생략 시 OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR이 설정되어 있으면 해당 값을 사용하고, 그렇지 않으면 구성된 기본 에이전트를 사용합니다.

참고사항:

models set <model-or-alias>는 provider/model 또는 별칭을 받습니다.
모델 참조는 첫 번째 /를 기준으로 분리하여 파싱합니다. 모델 ID에 /가 포함된 경우(OpenRouter 스타일) 프로바이더 접두사를 포함하세요 (예: openrouter/moonshotai/kimi-k2).
프로바이더를 생략하면 OpenClaw는 입력을 별칭 또는 기본 프로바이더의 모델로 처리합니다 (모델 ID에 /가 없는 경우에만 동작).
models status는 비밀이 아닌 플레이스홀더에 대해 인증 출력에 marker(<value>)를 표시할 수 있습니다 (예: OPENAI_API_KEY, secretref-managed, minimax-oauth, qwen-oauth, ollama-local).

`models status`

옵션:

--json
--plain
--check (종료 코드 1=만료/누락, 2=곧 만료)
--probe (구성된 인증 프로필에 대한 실시간 프로브)
--probe-provider <name> (특정 프로바이더 프로브)
--probe-profile <id> (반복 또는 쉼표 구분 프로필 ID)
--probe-timeout <ms>
--probe-concurrency <n>
--probe-max-tokens <n>
--agent <id> (구성된 에이전트 ID; OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR 재정의)

별칭 + 폴백

openclaw models aliases list
openclaw models fallbacks list

인증 프로필

openclaw models auth add
openclaw models auth login --provider <id>
openclaw models auth setup-token
openclaw models auth paste-token

models auth login은 프로바이더 플러그인의 인증 플로우(OAuth/API 키)를 실행합니다. openclaw plugins list로 설치된 프로바이더를 확인할 수 있습니다.

참고사항:

setup-token은 setup-token 값을 입력받습니다 (다른 머신에서 claude setup-token으로 생성).
paste-token은 다른 곳이나 자동화에서 생성된 토큰 문자열을 받습니다.
Anthropic 정책 참고: setup-token 지원은 기술적 호환성을 위한 것입니다. Anthropic은 과거에 Claude Code 외부에서의 일부 구독 사용을 차단한 적이 있으므로, 광범위하게 사용하기 전에 현재 약관을 확인하세요.