📝 한줄 요약
혹시 저만 몰랐을 수도 있겠지만... (뒷북이면 죄송합니다)
OpenClaw에서 Anthropic API 키 대신 OAuth(setup-token) 방식으로 전환하면 Claude Pro/Max 구독 크레딧을 사용할 수 있어서 API 토큰 비용이 나가지 않는 것을 발견하여 공유드려요.
🎯 이런 분들께 도움돼요
OpenClaw을 API 키로 쓰고 있는데 매달 토큰 비용이 나가는 분
Claude Pro/Max 구독 중인데 OpenClaw에서도 구독 크레딧을 쓰고 싶은 분
OpenClaw 처음 설정하는데 어떤 인증 방식을 써야 할지 고민인 분
😫 문제 상황 (Before)
OpenClaw을 세팅하고 Slack이나 Telegram 봇으로 Claude를 사용하고 있었습니다. 그런데 어느 날 갑자기 봇이 응답을 안 합니다.
⚠️ API provider returned a billing error — your API key has run out of credits or has an insufficient balance.
Anthropic API 크레딧을 다 써버린 거였습니다. 충전하고 나면 다시 되지만, 매번 API 사용량을 신경 쓰는 게 은근히 스트레스였습니다. 특히 Claude Pro 구독을 이미 하고 있는 상황에서, API 비용을 따로 내는 게 뭔가 이중 지출 같은 느낌이었습니다.
"구독 크레딧으로 OpenClaw을 쓸 수는 없나?" 찾아보니, OAuth 방식으로 전환하면 가능했습니다.
🛠️ 사용한 도구
OpenClaw: AI 에이전트 게이트웨이
Claude Code: 원격 PC에서 설정 변경 작업 지원
🔧 설정 방법
1단계: setup-token 발급
먼저 터미널에서 Claude Code의 setup-token을 발급합니다.
claude setup-token
이 명령을 실행하면 sk-ant-oat01-... 형태의 토큰이 생성됩니다. 이 토큰을 복사해두세요.
2단계: OpenClaw configure 실행
OpenClaw 프로젝트 디렉토리에서 설정 위저드를 실행합니다.
cd [OpenClaw 프로젝트 경로] pnpm openclaw configure --section model
위저드가 시작되면 다음과 같이 선택합니다:
Where will the Gateway run? →
Local (this machine)Model/auth provider →
AnthropicAnthropic auth method →
Anthropic token (paste setup-token)Paste Anthropic setup-token → 1단계에서 복사한 토큰 붙여넣기
Token name → 원하는 이름 (예: "nuri openclaw")
Anthropic OAuth models → 사용할 모델 선택
"Configure complete." 메시지가 나오면 성공입니다.
3단계: OAuth를 기본 인증으로 설정
설정 후 auth-profiles.json을 확인해보면 기존 API 키와 새 OAuth 토큰이 함께 등록되어 있습니다. 하지만 기존 API 키가 여전히 우선순위일 수 있습니다.
~/.openclaw/agents/main/agent/auth-profiles.json 파일의 order 부분을 확인하세요:
"order": {
"anthropic": [
"anthropic:nuri-openclaw",
"anthropic:manual"
]
}
OAuth 프로필(nuri-openclaw)이 첫 번째에 오도록 하면, OAuth를 우선 사용하고 만료 시 API 키로 fallback합니다.
4단계: Gateway 재시작
설정 변경 후 Gateway를 재시작해야 적용됩니다.
pnpm openclaw gateway stop pnpm openclaw gateway install
✅ 결과 (After)
Before vs After
항목
Before (API 키)
After (OAuth)
비용
API 사용량만큼 과금
구독 크레딧 사용 (추가 비용 없음)
크레딧 소진 시
봇 응답 중단 + 수동 충전
구독 한도 내 자동 관리
토큰 관리
직접 크레딧 잔액 확인 필요
refresh token으로 자동 갱신
안정성
잔액 없으면 즉시 중단
API 키를 fallback으로 설정 가능
핵심 포인트
OAuth 방식은 refresh token이 있어서 한 번 설정하면 자동으로 갱신됩니다
다만 Anthropic이 세션을 강제로 끊거나 비밀번호를 변경하면 재인증이 필요합니다
OAuth + API 키 병행 설정이 가장 안정적 — OAuth를 우선으로, API 키를 보험으로
