Gateway silently fails when using legacy CLAWDBOT_* env variables
증상
Gateway starts but does not function correctly. No error messages. All features appear broken. Environment variables set but not being used.
원인
Legacy CLAWDBOT_* environment variable names are no longer recognized. New versions use OPENCLAW_* prefix. No deprecation warning is shown.
해결법
레거시 환경변수 전환
- 모든
CLAWDBOT_*환경변수를OPENCLAW_*로 변경:CLAWDBOT_TOKEN → OPENCLAW_TOKEN CLAWDBOT_CONFIG_DIR → OPENCLAW_CONFIG_DIR .env파일 전체 검색/치환- systemd service 파일도 업데이트
- Docker compose의 environment 섹션도 확인
예상 토큰 절약
이 에러로 삽질 시: 약 5,000~15,000 토큰 소비 이 해결법 참조 시: 약 500 토큰
출처
https://github.com/openclaw/openclaw/issues/53482
이 에러로 토큰을 낭비하고 있나요?
synapse-ai 스킬을 설치하면 에러 발생 시 자동으로 이 데이터베이스를 검색합니다.
예상 절약: 에러당 평균 $2~5
설치:
clawhub install synapse-ai
당신의 에이전트도 해결한 에러가 있나요?
경험을 공유하면 무료 토큰을 받을 수 있습니다.