【긴급】OpenClaw에 Claude Opus 4.6 설정하기

왜 「긴급」인가

2026년 2월 5일, Anthropic이 Claude Opus 4.6을 출시했습니다. 100만 토큰 컨텍스트, 128K 토큰 출력, 강화된 계획 능력과 자기 수정 능력.

OpenClaw 사용자라면 지금 바로 설정해서 쓰고 싶을 겁니다. Claude Opus 4.6의 도구 호출 기능을 최대한 활용하는 방법은 Claude Agent SDK 툴 유즈 완전 가이드에서 다룹니다.

이 글에서는 설정 파일을 그대로 복붙해서 바로 실행할 수 있는 최단 경로를 소개합니다.

사전 조건

• OpenClaw 설치 완료 (npm install -g openclaw@latest)
• Anthropic API 키 설정 완료 (claude setup-token)

아직이라면 공식 문서를 참고하세요. Claude Code와 병행해서 사용 중이라면 Claude Code 베스트 프랙티스도 워크플로우 설계에 도움이 됩니다.

설정 파일 편집

~/.openclaw/openclaw.json 파일을 열고, 다음 2개 섹션을 추가/수정합니다.

1. models — Opus 4.6 모델 정의

"models": {
  "mode": "merge",
  "providers": {
    "anthropic": {
      "baseUrl": "https://api.anthropic.com",
      "api": "anthropic-messages",
      "models": [
        {
          "id": "claude-opus-4-6",
          "name": "Claude Opus 4.6",
          "reasoning": true,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        }
      ]
    }
  }
}

포인트:

• mode: "merge" — OpenClaw 내장 모델 카탈로그에 추가하는 방식 (덮어쓰기 아님)
• reasoning: true — Opus 4.6의 추론 모드 활성화
• contextWindow: 1000000 — 100만 토큰 풀 컨텍스트
• maxTokens: 128000 — 128K 토큰 롱 출력

2. agents — 기본 모델 지정

"agents": {
  "defaults": {
    "model": {
      "primary": "anthropic/claude-opus-4-6",
      "fallbacks": [
        "anthropic/claude-opus-4-5"
      ]
    },
    "contextTokens": 1000000
  }
}

포인트:

• primary — 모든 세션에서 Opus 4.6을 기본 사용
• fallbacks — Opus 4.6 사용 불가 시 Opus 4.5로 폴백
• contextTokens: 1000000 — 에이전트가 100만 토큰 컨텍스트를 풀 활용

설정 적용

설정을 저장한 후, 2단계가 필요합니다.

Step 1: Gateway 재시작

openclaw gateway restart

설정 파일이 다시 로드됩니다.

Step 2: 새 세션 시작

기존 세션에는 이전 모델 설정이 남아 있습니다. 채팅에서 다음을 입력하세요:

/new

/reset도 가능합니다. 새 세션을 시작하지 않으면 새 모델이 적용되지 않습니다.

설정 확인

올바르게 설정됐는지 확인합니다:

openclaw models status

anthropic/claude-opus-4-6이 primary 모델로 표시되면 성공입니다.

채팅에서도 확인 가능합니다:

/model status

정리

1. openclaw.json의 models와 agents 섹션 편집
2. openclaw gateway restart로 재시작
3. /new로 새 세션 시작
4. openclaw models status로 확인

끝. 100만 토큰 컨텍스트의 세계에 오신 것을 환영합니다. 사용량과 비용을 지속적으로 추적하고 싶다면 Claude Code 사용량 인사이트 분석을 참고하세요.

참고 자료

• OpenClaw 공식 문서 — Models
• OpenClaw 공식 문서 — Model Providers
• OpenClaw GitHub
• Anthropic 공식 — Claude Opus 4.6