openclaw models 모델 관리 명령 튜토리얼

명령 개요

openclaw models 명령은 OpenClaw의 모든 모델 설정을 관리하는 데 사용되며, 사용 가능한 모델 조회, 성능 테스트, 파라미터 설정, 기본 모델 지정을 포함합니다.

모델 목록 조회

openclaw models list

Models:
  Name            Provider    Model ID              Status
  ──────────────────────────────────────────────────────────
  main            openai      gpt-4o                ✓ Active
  fast            openai      gpt-4o-mini           ✓ Active
  local           ollama      llama3.1:8b           ✓ Active
  claude          anthropic   claude-sonnet-4-20250514     ✗ No API key
  code            openai      gpt-4o                ✓ Active

Default model: main

사용 가능한 모델 조회

공급자가 제공하는 모든 사용 가능한 모델을 조회합니다:

# 특정 공급자 조회
openclaw models available --provider openai

# 모든 공급자 조회
openclaw models available --all

Available models from openai:
  gpt-4o              128k context    $5.00/$15.00 per 1M tokens
  gpt-4o-mini         128k context    $0.15/$0.60 per 1M tokens
  gpt-4-turbo         128k context    $10.00/$30.00 per 1M tokens
  o1                  200k context    $15.00/$60.00 per 1M tokens

모델 설정 추가

openclaw models add smart-model \
  --provider openai \
  --model gpt-4o \
  --temperature 0.7 \
  --max-tokens 4096

모델 설정 수정

openclaw models update main --temperature 0.5
openclaw models update main --max-tokens 8192
openclaw models update main --model gpt-4o-mini

기본 모델 설정

openclaw models default fast

모델 테스트

# 빠른 테스트
openclaw models test main

# 상세 테스트
openclaw models test main --verbose

Testing model: main (openai/gpt-4o)
  ✓ Connection: successful
  ✓ Response time: 1.2s
  ✓ Output quality: verified
  ✓ Streaming: working
  ✓ Token counting: accurate

  Test conversation:
    User: Hello
    AI: Hello! How can I help you today?

  Stats:
    Prompt tokens: 8
    Completion tokens: 10
    Latency: 1,200ms

성능 벤치마크 테스트

openclaw models benchmark main --rounds 10

Benchmark: main (openai/gpt-4o) - 10 rounds
  Avg latency: 1,350ms
  Min latency: 850ms
  Max latency: 2,100ms
  P95 latency: 1,900ms
  Avg tokens/sec: 45
  Success rate: 100%

비교 테스트

openclaw models compare main fast --prompt "상대성 이론을 설명해주세요"

모델 비용 조회

openclaw models cost --period 7d

Model Cost Summary (last 7 days):
  main (gpt-4o):        $12.50  (250K tokens)
  fast (gpt-4o-mini):   $0.85   (180K tokens)
  local (llama3.1):     $0.00   (local)
  ──────────────────────────────────────
  Total:                $13.35

장애 전환 설정

# 백업 모델 설정
openclaw models set-fallback main --fallback fast
openclaw models set-fallback fast --fallback local

장애 전환 체인 조회:

openclaw models fallback-chain main

Fallback chain for 'main':
  main (openai/gpt-4o)
  → fast (openai/gpt-4o-mini)
  → local (ollama/llama3.1)

모델 설정 삭제

openclaw models remove old-model

가져오기/내보내기

openclaw models export models.json
openclaw models import models.json

정리

openclaw models는 완전한 모델 라이프사이클 관리를 제공합니다. 사용 가능한 모델 발견, 파라미터 설정, 성능 테스트부터 비용 모니터링까지, 다중 모델 환경에서 최적의 선택을 할 수 있도록 도와줍니다.