질문: “내가 쓰는 오픈클로는 현재 API로 설정되어 있는데, 뽀짝이처럼 Haiku 4.5로 기본 구동하고 필요할 때 Opus 4.7로 업그레이드하는 방식으로 바꾸려면 어떤 과정을 거치는 게 좋을까?”
덕후방 웨비나(5/6) 와중에 4명 이상이 비슷하게 던진 질문이에요. API 종량제로 쓰다 보면 Opus 4.7만 쭉 박아두기엔 청구서가 무서워지거든요. 평소엔 가벼운 Haiku로 돌리고, 무거운 작업이 들어왔을 때만 Opus로 잠깐 갈아타는 라우팅을 정리해드릴게요. 🐈⬛
🔑 짧은 답변
OpenClaw 모델은 3단계 폴백 구조예요:
- Primary — 평소에 쓰는 기본 모델 (
agents.defaults.model.primary) - Fallbacks — primary가 막히면 순서대로 시도 (
agents.defaults.model.fallbacks) - Provider auth failover — 같은 모델 내에서 인증 토큰만 갈아끼우는 단계
“평소 Haiku, 무거운 작업만 Opus”는 이 중 두 가지로 풀어요:
- Config 단: primary를 Haiku 4.5로 두고 fallback에 Opus 4.7
- 세션 단: 무거운 일 들어왔을 때 그 대화방에서만
/model anthropic/claude-opus-4-7슬래시 커맨드로 임시 전환
Claude Code의 settings.json이 아니라 OpenClaw config(openclaw config)를 건드리는 거예요. 이름이 비슷해서 헷갈리시는 분들이 많아요.
🛠️ 1단계 — Primary 모델을 Haiku 4.5로 바꾸기
가장 간단한 방법은 CLI 한 줄이에요.
openclaw models set anthropic/claude-haiku-4-5이러면 agents.defaults.model.primary가 Haiku 4.5로 바뀌어요. 새 세션부터 기본이 Haiku로 떠요.
손으로 config를 만지고 싶으면:
openclaw config set agents.defaults.model.primary anthropic/claude-haiku-4-5⚠️ allowlist 주의: agents.defaults.models(복수)가 설정돼 있으면 그게 화이트리스트 역할을 해요. Haiku가 그 목록에 없으면 “Model is not allowed” 에러가 나서 답변이 아예 안 떠요. 추가하려면:
openclaw config set agents.defaults.models '{"anthropic/claude-haiku-4-5":{}}' --strict-json --merge--merge를 꼭 붙여요. 안 붙이면 기존 모델들이 통째로 날아가요.
🚀 2단계 — Opus 4.7을 fallback으로 등록
primary가 어떤 이유로(쿼터 초과, 일시 장애 등) 실패했을 때 Opus로 자동 전환되게 하려면:
openclaw config set agents.defaults.model.fallbacks '["anthropic/claude-opus-4-7"]' --strict-json이 라우팅은 “자동 폴백”이지 “수동 업그레이드”는 아니에요. 무거운 작업을 의도적으로 Opus에게 시키고 싶다면 다음 방법이 더 나아요.
🎚️ 3단계 — 세션 단위로 임시 업그레이드
Slack/텔레그램/카톡 어느 채널이든, 진행 중인 대화방에서 한 줄만 쳐요:
/model anthropic/claude-opus-4-7그 세션에서만 Opus로 갈아타요. 무거운 코드 작업이나 깊은 추론이 필요할 때 이렇게 켜고, 끝나면:
/model anthropic/claude-haiku-4-5다시 Haiku로 돌리는 패턴이에요. 비용이 많이 발생하는 추론은 짧게 쓰고 종료하는 흐름.
/model list로 현재 사용 가능한 모델 목록을 볼 수 있어요. allowlist에 들어 있는 모델만 여기 떠요.
💡 운영 팁
어떤 작업에 어떤 모델?
뽀피터스 운영 경험을 정리해드리면:
| 작업 | 권장 모델 |
|---|---|
| 일상 대화, 짧은 안내 | Haiku 4.5 |
| 데이터 조회·요약, 단순 자동화 | Haiku 4.5 |
| 코드 작성·리팩토링, 멀티스텝 추론 | Opus 4.7 |
| 회의록 정리, 긴 문서 작성 | Sonnet 4.6 |
인증 방식 두 가지
API 종량제 외에 Claude CLI(OAuth) 로 연결하는 방법도 있어요. Claude Pro/Max 구독이 있으면 종량제 청구서 없이 정해진 사용량 내에서 무제한처럼 쓸 수 있거든요. 다만 채널/도구 조합에 따라 tool calling 동작이 달라질 수 있어서, 처음 세팅할 때는 Q&A #13 — Claude CLI tool calling을 같이 보세요.
알리아스로 짧게 부르기
자주 쓰는 모델은 알리아스로 등록하면 편해요:
openclaw config set agents.defaults.models.anthropic/claude-haiku-4-5.aliases '["haiku"]' --strict-json --merge이러면 /model haiku 한 줄로 전환돼요.
📌 정리
- 라우팅은 Primary + Fallbacks + Auth failover 3단 구조
- 평소 Haiku는
openclaw models set anthropic/claude-haiku-4-5한 줄로 끝 - 무거운 작업은 그 세션에서
/model anthropic/claude-opus-4-7슬래시 커맨드로 켰다 끄기 - Claude Code
settings.json이 아니라 OpenClaw config가 정답이에요 - allowlist(
agents.defaults.models)가 있으면 새 모델은 거기에도 추가해야 답변이 떠요
설정이 헷갈리면 openclaw onboard를 한 번 돌려보세요. 모델 + 인증 + 폴백을 대화식으로 잡아줘서 손으로 config 만지는 것보다 안전해요. 🐾
출처: 덕후방 (2026-05-06 웨비나 와중) — 4명 이상의 비슷한 질문을 모아 정리했어요.