OpenClaw 오류 문제: context overflow부터 Gemini 전환 과정

OpenClaw(오픈클로)를 쓰다 보면 갑자기 context overflow(컨텍스트 초과) 오류가 뜨면서 작동이 멈출 때가 있습니다. 저도 Anthropic API를 쓰다가 이 문제를 만났는데요. 세션 초기화도 해보고, 쿨다운 초기화도 시도했지만 계속 실패했습니다.

결국 설정을 완전히 초기화하고 Gemini로 전환하는 방법으로 해결했습니다. 오늘은 문제 원인부터 해결까지 전체 과정을 정리합니다.

다만 이게 claude에서 물어보고 한 것이기 때문에, 완전한 방법은 아닐 수 있습니다.

저도 어떻게 하다보니 된 거긴 한데 혹시 몰라서 노트에 정리해둡니다.

이런 증상이 있다면 이 글이 도움됩니다

context overflow 오류가 반복해서 발생함
rate_limit 오류로 쿨다운이 계속 누적됨
세션 초기화, 쿨다운 초기화를 해도 문제가 해결되지 않음
API 인증(auth) 실패가 반복됨

왜 이런 문제가 생겼을까요?

제가 겪은 문제의 원인은 크게 세 가지였습니다.

참고로 아래 내용은 클로드가 분석한 것으로, 제가 가끔 brave api key를 실수로 넣고 그런 과정이 있었습니다.

그리고 대화 누적이나 스킬 과다 설치는 이해가 안 가는 부분이긴 합니다. 대화가 많지도, 스킬은 고작 3개만 설치했거든요...ㅠ

원인	설명
대화 누적	세션에 대화가 쌓이면서 처리할 텍스트가 너무 많아짐
스킬 과다 설치	워크스페이스 파일(스킬 포함)이 시스템 프롬프트에 포함되어 용량 초과
API 키 오류	잘못된 API 키로 인증 실패가 누적되면서 쿨다운 발생

부분적인 초기화로는 이 문제들이 완전히 해결되지 않았습니다. 설정 폴더 전체를 백업하고 처음부터 다시 설정하는 것이 가장 확실한 해결책이었습니다.

해결 과정: 6단계

1단계: 게이트웨이 중지 + 기존 설정 백업

터미널을 열고 아래 명령어를 차례로 입력합니다.

openclaw gateway stop
mv ~/.openclaw ~/.openclaw-backup

이 과정이 핵심입니다. mv 명령어로 설정 폴더를 통째로 옮기면 세션, 스킬, 쿨다운 상태가 모두 제거됩니다. 나중에 문제가 생기면 백업 폴더에서 복구할 수 있으니 안심하세요.

2단계: 새로 설정하기 (Gemini로 전환)

깨끗한 상태에서 새로 설정을 시작합니다.

openclaw configure

설정 화면에서 아래처럼 입력하세요.

항목	입력 내용
Model	`gemini-2.0-flash` 또는 `gemini-3-pro-preview`
API Key	Google API 키 붙여넣기
Channels	Telegram 활성화 후 봇 토큰 입력
DM 접근 정책	`pairing` (그냥 Enter 누르면 기본값 적용)

Google API 키가 없다면 https://aistudio.google.com/apikey 에서 발급받을 수 있습니다.

왜 Gemini인가요? Gemini(제미나이)는 컨텍스트 윈도우가 100만 토큰으로 매우 넉넉합니다. 같은 작업을 해도 overflow가 발생할 위험이 훨씬 낮습니다.

3단계: 게이트웨이 시작

설정이 끝났으면 게이트웨이를 실행합니다.

openclaw gateway start

4단계: 연결 상태 확인

제대로 연결됐는지 확인합니다.

openclaw health

결과에서 Telegram: ok가 보이면 성공입니다.

5단계: 텔레그램 페어링 승인

텔레그램과의 연결을 승인합니다.

openclaw pairing list --channel telegram
openclaw pairing approve --channel telegram [코드]

[코드] 부분에 실제로 나온 페어링 코드를 입력하세요.

pairing 모드란? 이전의 open 모드와 기능은 동일하지만 보안이 강화된 방식입니다. 승인된 사용자만 봇을 사용할 수 있습니다.

6단계: 테스트

텔레그램 앱을 열고 봇에게 "안녕"이라고 메시지를 보내보세요. AI가 정상적으로 답장하면 모든 설정이 완료된 것입니다.

정리

문제	해결책
context overflow 반복	`mv ~/.openclaw ~/.openclaw-backup`으로 완전 초기화
쿨다운 누적	설정 폴더 백업으로 쿨다운 상태도 함께 제거
overflow 재발 방지	Gemini 사용 (100만 토큰) + 스킬 최소화

부분적인 초기화로 해결이 안 될 때는 처음부터 다시 시작하는 것이 가장 빠른 방법입니다. 저도 여러 번 시도 끝에 이 방법으로 해결이 되긴 했습니다, 같은 문제로 고생하시는 분들께 도움이 되길 바랍니다.