오픈클로 api아끼는법 : Oauth로 로그인하기

기존에 OpenClaw를 API 키로 쓰다가 ChatGPT OAuth(Codex 구독)로 전환하는 순서를 정리한 가이드다. 이 방식은 API 키를 직접 소모하는 경로가 아니라 ChatGPT OAuth 로그인 기반으로 붙는 흐름이라, 상황에 따라 API 비용을 아끼는 데 도움이 된다.

1. OAuth 로그인 실행

먼저 OpenClaw에서 OpenAI Codex 제공자로 OAuth 로그인을 시작한다.

openclaw models auth login --provider openai-codex

터미널에 OAuth URL이 뜨면 그 주소를 브라우저에 복사해서 열고, ChatGPT 계정으로 로그인한 뒤 인증을 허용하면 된다.

오픈클로 Oauth (2)

위와 같이 창이뜨면 링크를 Ctrl+클릭한다.

계속 버튼을 누른다.

2. 콜백 URL을 터미널에 붙여넣기

오픈클로 Oauth (4)

브라우저가 localhost:1455/?code=... 형태로 리다이렉트되면서 에러 페이지가 뜨는 건 정상이다. 이때 브라우저 주소창에 보이는 전체 URL을 복사해서 터미널에 그대로 붙여넣으면 된다.

오픈클로 Oauth (5)

겉으로는 에러처럼 보여도 실제로는 인증 코드만 회수하면 되는 단계라서 당황할 필요는 없다.

(Ubuntu의 경우 붙여넣기는 Ctrl+Shift+V)

3. 기본 모델을 Codex로 변경

OAuth 로그인이 끝났으면 OpenClaw의 기본 모델을 openai-codex/gpt-5.4로 바꾼다.

openclaw config set agents.defaults.model.primary openai-codex/gpt-5.4

왜 이 단계가 필요한가

로그인만 해두고 기본 모델을 그대로 두면, 여전히 기존 API 키 기반 모델을 사용할 수 있다. 그래서 실제로 Codex 구독 경로를 쓰려면 기본 모델 설정까지 같이 바꿔야 한다.

4. 게이트웨이 재시작

모델 등록은 핫리로드가 안 되기 때문에 게이트웨이를 한 번 재시작해야 한다.

mac 기준

launchctl stop ai.openclaw.gateway && launchctl start ai.openclaw.gateway

Linux 기준

systemctl restart openclaw-gateway

5. 정상 전환 확인

마지막으로 모델 목록을 확인해서 OAuth 토큰이 제대로 붙었는지 점검한다.

openclaw models list --provider openai-codex

openai-codex/gpt-5.4가 primary로 표시되고 OAuth 토큰 상태가 valid로 나오면 전환이 완료된 것이다.

추가로 알아둘 점

ChatGPT Plus OAuth는 openai-codex/gpt-5.4로 라우팅되고, openai/gpt-5.4는 API 키 전용이라 서로 다른 경로다. 이름이 비슷해 보여도 실제 인증 방식과 과금 경로는 다르다.

한 줄 요약

OpenClaw에서 API 키 대신 Codex 구독 OAuth를 쓰려면 로컬 머신에서 OAuth 로그인 → 콜백 URL 붙여넣기 → 기본 모델 변경 → 게이트웨이 재시작 → 모델 상태 확인 순서로 진행하면 된다.

https://openclaw.ai/