"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."
얼마 전 카카오 선물하기 대란 당시, ChatGPT Pro를 90% 할인가 29,000원에 다섯 개를 꽉 채워서 샀다. 그리고 Codex OAuth 인증 방식으로 OpenClaw에 GPT-5.4를 비롯한 GPT 모델들을 등록하는 데 성공했다.
배경
ChatGPT Pro 월 구독 요금은 원래 200달러다. 그런데 카카오가 한국 시장 프로모션(추측)으로 90% 할인된 월 29,000원(약 $20)에 잠깐 풀었다. 정확한 상품 이름은 'ChatGPT Pro 1개월 이용권'이다. 망설임 없이 구매했고 "이걸로 OpenClaw에도 쓸 수 있으면 대박인데"가 출발점이었다.

https://www.news1.kr/it-science/internet-platform/6072799
"29만원짜리 챗GPT프로가 2.9만원? 이건 사야해!"…카카오 단독 할인
선물하기, 챗GPT 프로 이용권 프로모션…최대 5개까지 플러스 이용권은 1+1로…카카오 "챗GPT 포 카카오 경험 확대" 카카오(035720)가 선물하기에서 챗GPT 프로·플러스 이용권 프로모션을 단독으로
www.news1.kr
※ (2026.03.09 추가 작성) 2026.3.7 버전 이상의 최신 OpenClaw를 설치(또는 업데이트)하면 GPT 5.4 모델까지 사용할 수 있다.
OpenClaw에서 OpenAI 모델을 쓰려면 API 키(일명 종량제)가 필요하다..고 생각했다. ChatGPT 구독과 OpenAI API는 별개 상품이고, 구독료를 내도 API 접근은 안 된다. 그게 상식이었다. 그런데 Codex CLI가 나오면서 상황이 바뀌었다. Codex CLI의 OAuth 토큰을 OpenClaw에 등록하면, ChatGPT 구독만으로 5.3-Codex, 5.4 등의 최신 모델을 쓸 수 있다. API 키 없이.
우연히 레딧(Reddit)에서 이런 글을 발견했다
"You can link your chatgpt subscription through codex and get an oauth link. Works great, just as well as if it were from an API." — u/sheitmar
반신반의하면서 시도했는데, 진짜 됐다. 본격적인 설명에 들어가기 전에 잠깐 짚고 갈 것이 있다. 메모리(MEMORY.md)를 파일로 계속 쌓아 가는 OpenClaw의 특성 상 저장공간이 모자랄 수 있다. 또한 당장 모자라지 않더라도 정기적인 백업을 위해 외장 하드는 거의 필수다.
https://link.coupang.com/a/ebQUTJ
WD Elements Portable 휴대용 외장하드 + 파우치 - 외장하드 | 쿠팡
현재 별점 4.8점, 리뷰 10061개를 가진 WD Elements Portable 휴대용 외장하드 + 파우치! 지금 쿠팡에서 더 저렴하고 다양한 외장하드 제품들을 확인해보세요.
www.coupang.com
OAuth 인증 진행 순서
아래 조건들을 만족한다는 전제 하에 OAuth 인증 과정을 단계별로 설명한다.
- ChatGPT Pro 또는 Plus 구독 (Plus도 가능하다)
- OpenClaw 최신 버전 (2026.2.x 이상 권장) 설치 완료
- Node.js 설치 완료
1단계: Codex CLI 설치
npm install -g @openai/codex
설치 확인:
codex --version
에러 없이 'codex-cli 0.107.0'와 같이 버전 값이 출력되면 설치 성공이다.
2단계: Codex 로그인
codex login
브라우저가 열리면서 ChatGPT 계정 인증 화면이 뜬다.


(당연히) 카카오 'ChatGPT Pro 1개월 이용권'에 연동된 ChatGPT 계정으로 로그인해야 한다. 로그인하면 터미널에 Successfully logged in이 출력된다.

토큰은 ~/.codex/auth.json에 자동으로 저장된다.
cat ~/.codex/auth.json
{
"auth_mode": "chatgpt",
"tokens": {
"id_token": "eyJhbGci...",
"access_token": "eyJhbGci...",
"refresh_token": "rt_...",
"account_id": "a833d290-..."
},
"last_refresh": "2026-03-04T08:14:16.344786Z"
}
access_token 값을 복사해 둔다. 사실 여기부터는 에이전트에게 토큰이 저장된 위치만 알려주고 알아서 해달라고 하는 게 편하다.
3단계: OpenClaw에 등록
다시 한번 말하지만 여기부터는 OpenClaw 에이전트한테 'Codex CLI OAuth 인증'을 해달라고 요청하는 것을 권한다. 그래도 알고 있으면 나쁠 건 없으니 수동으로 등록하는 방법을 쭉 설명한다. 터미널에서 아래의 OpenClaw CLI 명령어를 실행한다.
openclaw models auth add
아래와 같은 인터랙티브 프롬프트가 뜬다.
◆ Token provider
│ ○ anthropic
│ ● custom (type provider id)
custom을 선택하고 openai-codex를 직접 입력한다.
◆ Token method
│ ● paste token
paste token 선택.
◆ Profile id
│ openai-codex:manual
그대로 엔터.
◆ Does this token expire?
│ ● Yes
OAuth 토큰은 일정 기간 후 만료된다. 하지만 Codex CLI가 사용 중 자동으로 갱신하므로 대부분의 경우 재로그인 없이 계속 사용할 수 있다. 혹시나 나중에 인증 만료 오류가 뜨면 codex login으로 재발급하면 된다. 여기서는 Yes를 선택하고 만료 기간은 대략적(30d 정도)으로 넣는다.
마지막으로 아까 복사한 access_token을 붙여 넣는다.
Updated ~/.openclaw/openclaw.json
Auth profile: openai-codex:manual (openai-codex/token)
이것으로 Codex CLI OAuth 인증 과정이 모두 끝났다.
4단계: 등록 확인
openclaw models
출력에서 이 부분을 확인한다:
Providers w/ OAuth/tokens (2): anthropic (1), openai-codex (1)
- openai-codex effective=profiles:~/.openclaw/agents/main/agent/auth-profiles.json
| profiles=1 (oauth=0, token=1, api_key=0)
| openai-codex:manual=token:eyJhbGci...
openai-codex 프로바이더가 잡혔으면 성공이다. 사용량 현황도 보인다:
- openai-codex usage: 5h 100% left ⏱4h 55m · Day 100% left ⏱6d 23h
5단계: 모델 설정
에이전트의 기본 모델을 바꾸거나, 대화에서 /model openai-codex/gpt-5.4로 전환하면 된다. config(openclaw.json 파일)에서 에이전트 기본 모델을 바꾸려면 아래와 같이 수정한다.
{
"agents": {
"list": [
{
"id": "my-agent",
"model": "openai-codex/gpt-5.4"
}
]
}
}
하지만 파일을 직접 수정하는 것은 권하지 않는다. 사용하는 채널(텔레그램, 디스코드 등)에서 에이전트에게 기본 모델을 'gpt-5.4'로 변경'해 달라고 말하는 게 쉽고 안전하다.
사용 가능한 모델
OpenClaw에서 지원하는 OpenAI provider는 openai와 openai-codex가 있는데 Codex CLI OAuth 인증으로는 openai-codex만 사용할 수 있다. openai-codex에서 사용 가능한 주요 모델은 아래와 같다.
| 모델 | 용도 및 특징 |
| openai-codex/gpt-5.2 | 범용, 안정적 |
| openai-codex/gpt-5.3-codex | 코딩 특화 |
| openai-codex/gpt-5.4 | 5.3-code의 코딩 기능이 포함된 최신 버전 |
다시 말하지만 셋 다 ChatGPT 구독에 포함된다. 추가 과금이 없다.
주의 사항
주간 사용량 한도
구독이라고 무제한이 아니다. 주간 단위로 사용량 한도가 있다. 레딧에서 "며칠 만에 일주일치를 다 썼다"는 사례가 있었다. openclaw models 출력에서 잔여량을 확인할 수 있다. 한도를 초과하면 해당 모델이 비활성화되고, 리셋까지 기다려야 한다. Pro(200달러) 플랜이 Plus(20달러)보다 한도가 넉넉하다.
토큰 만료
혹시나 자동 갱신이 안 돼서 OAuth access_token이 만료되면 앞에서 했던 과정을 반복하면 된다.
codex login
openclaw models auth add
다시 로그인하고 새 토큰을 등록하면 된다. 1분이면 끝난다.
API가 아니다
Codex OAuth는 ChatGPT 구독 기반 인증이다. OpenAI API 키가 아니다. API 전용 기능(fine-tuning, batch 등)은 사용할 수 없다. 하지만 OpenClaw에서 대화 모델로 쓰는 데는 아무 문제없다.
응용: 에이전트별 모델 분배
멀티 에이전트 환경이라면 프로바이더를 에이전트별로 나눌 수 있다.
| 에이전트 | 모델 | 인증 방식 |
| 에이전트 A | anthropic/claude-opus-4-6 | Claude OAuth (구독) |
| 에이전트 B | google/gemini-3-pro-preview | Google API 키 |
| 에이전트 C | openai-codex/gpt-5.4 | Codex OAuth (구독) |
세 프로바이더 모두 구독 또는 무료 크레딧 기반이면, 사실상 API 과금 없이 멀티 모델 환경을 운영할 수 있다. 물론 운영이 가능할 뿐이지 24/7 돌리는 데에 쾌적한 수준이라고 말하기는 힘들다.
요약 및 마무리
ChatGPT 구독 플랜에 이미 가입했다면 대략 5분이면 끝나는 작업이다. 아래는 지금까지 설명했던 과정의 핵심에 해당하는 CLI 명령어다.
npm install -g @openai/codex
codex login
openclaw models auth add
# → custom → openai-codex → paste token → 완료
"ChatGPT 구독 플랜으로는 OpenClaw를 쓸 수 없다"는 말은 틀린 말이었다. Codex OAuth 덕분에 구독 모델로 OpenClaw에 GPT-5.4 모델을 올릴 수 있다. 하지만 API 호출(종량제) 방식이 기본이라 언제 막힐지는 알 수 없다. 그래도 최근 OpenClaw 창시자가 OpenAI에 합류한 만큼 갑자기 막아버릴 일은 당분간 없을 듯하다. 끝.
'AI-Agent > OpenClaw-Guide' 카테고리의 다른 글
| OpenClaw ACP로 Discord에서 Claude Code 실행하기 - 개념부터 iOS 앱 개발 사례까지 (14) | 2026.03.15 |
|---|---|
| 공모주 청약 일정을 OpenClaw로 구글 캘린더에 자동 등록하기 (0) | 2026.03.08 |
| OpenClaw 운영 가이드 - 멀티봇 환경에서 에이전트별 모델 fallback 설정으로 Rate Limit 방지하기 (0) | 2026.02.25 |
| OpenClaw 운영 가이드 - OpenClaw 버전 업데이트 중 오류 발생 시 복구(rollback) 방법 정리 (0) | 2026.02.17 |
| OpenClaw 활용 가이드 - 한 지붕 두 에이전트, 서브 에이전트 생성부터 디스코드 채널 입장까지 (3) | 2026.02.09 |