잘 쓰던 OpenClaw에서 갑자기 OAuth 오류가 터졌다. 재인증해도 안 됐던 이유는 따로 있었다.
이런 메시지가 떴다
Agent failed before reply: OAuth token refresh failed for openai-codex:
Failed to refresh OpenAI Codex token. Please try again or re-authenticate.
재인증 명령어는 이거다
openclaw models auth login
실행하면 브라우저가 열리고 Authentication successful 확인할 수 있다.
재인증 성공했는데도 오류가 반복된다면
UI 세션 모드를 확인해야 한다. ( 오픈클로을 재 설치하기도하고, config 명령어로도 해보고 수십번 이런 저런 시도해서 재인증해 보았다ㅠ)
Heartbeat 모드는 연결 상태만 확인하는 모드다. 대화 세션이 아니다. 인증이 복구돼도 이 모드에선 대화가 열리지 않는다.
Heartbeat → Direct 로 바꾸면 바로 해결된다.
중복 프로필 문제도 확인할 것
재인증을 해도 오류가 반복되자, 혹시 프로필 자체가 꼬인 게 아닐까 의심했다.
~/.openclaw/agents/main/agent/auth-profiles.json 을 직접 열어봤더니 프로필이 두 개였다.
openai-codex:defaultbaejunchae878@gmail.com(실제 인증된 계정)
처음 로그인할 때 이메일 확인 전 상태로 저장되면서 default 프로필이 생긴다. 이후 정식 로그인하면 이메일 프로필이 별도로 추가된다. 같은 계정인데 두 개가 공존하는 상태가 되는 것이다.
default 가 문제의 원인일 수 있다고 판단해서 해당 항목을 삭제하고, 실제 인증된 이메일 프로필만 남겼다.
해결 순서 요약
openclaw models auth login재인증openclaw gateway restart- UI 세션 모드 → Direct 전환
auth-profiles.json에서default프로필 삭제 (만약의 경우)
재인증만 하고 안 된다고 멈췄다면, UI 세션 모드가 범인이다.
오늘도 자비스는 진보한다.
그리고 매 번 창을 열때 세션모드을 토글해서 변경해서 사용하다가 2026년 4월 9일 문제의 원인과 해결을 다시 알게 되었다.
즉 상황은 이렇게 정리된다.
- 웹 인터페이스만 쓰던 시기
agent:main:main세션이 정상 기본 세션이었다- 맥에서 텔레그램을 띄워서 대화하기 시작한 뒤
- 실제 주력 대화 세션이
agent:main:telegram:direct:8759881574로 생겼다 - 그런데 Safari 아이콘은 여전히 기존 main 세션 주소 감각으로 열리니
- heartbeat 세션으로 열리며 인증 에러을 보게 된것이다
즉 핵심은:
웹만 쓸 때는 main 세션이 맞았는데, 텔레그램 직결 세션이 생기면서 주사용 세션이 바뀌었고, 시작 주소는 그 변화를 반영하지 못했다는 거다.
홈페이지 업데이트 문안도 이 반영이 들어가면 더 정확하다.
수정 문안
오늘 OpenClaw 접속 문제를 점검했다. 웹 인터페이스만 사용하던 시기에는 agent:main:main 세션이 기본 진입 세션으로 자연스러웠다. 그런데 이후 Mac에서 텔레그램을 통해 자비스와 직접 대화하기 시작하면서, 실제 주사용 세션이 텔레그램 direct 세션으로 바뀌었다. 문제는 Safari의 OpenClaw 아이콘 시작 주소가 이 변화를 반영하지 못한 채 예전 방식으로 열리고 있었다는 점이다. 그 결과 창을 열면 내가 실제로 쓰는 자비스 세션이 아니라 다른 기본 세션으로 먼저 들어가 혼선이 발생했고, 텔레그램 숫자 ID 세션으로 직접 토글해야 정상 대화가 가능했다. 최종적으로 Safari 아이콘의 시작 주소를 실제 사용하는 세션 URL로 바꾸어 해결했다. 이번 점검을 통해 문제의 본질은 heartbeat가 아니라 사용 세션 변화와 기본 진입 주소 불일치였음을 확인했다.
한 줄 결론:
텔레그램 세션이 새로 주세션이 되면서, 예전 웹 기본세션 주소가 뒤늦게 문제로 드러난 것이다.
답글 남기기