openclaw doctor

게이트웨이와 채널에 대한 상태 점검 및 빠른 수정.

관련 문서:

예시

openclaw doctor
openclaw doctor --repair
openclaw doctor --deep

참고:

  • 대화형 프롬프트(키체인/OAuth 수정 등)는 stdin이 TTY이고 --non-interactive가 설정되지 않은 경우에만 실행됩니다. 헤드리스 실행(cron, Telegram, 터미널 없음)에서는 프롬프트를 건너뜁니다.
  • --fix(--repair의 별칭)는 ~/.openclaw/openclaw.json.bak에 백업을 작성하고 알 수 없는 설정 키를 제거하며, 각 제거 항목을 나열합니다.
  • 상태 무결성 검사는 이제 세션 디렉토리에서 고아 트랜스크립트 파일을 감지하고 공간을 안전하게 회수하기 위해 .deleted.<timestamp>로 아카이브할 수 있습니다.
  • Doctor는 ~/.openclaw/cron/jobs.json(또는 cron.store)에서 레거시 cron 작업 형태를 검사하고, 스케줄러가 런타임에 자동 정규화하기 전에 제자리에서 재작성할 수 있습니다.
  • Doctor에는 메모리 검색 준비 상태 확인이 포함되어 있으며, 임베딩 자격 증명이 누락된 경우 openclaw configure --section model을 추천할 수 있습니다.
  • 샌드박스 모드가 활성화되어 있지만 Docker를 사용할 수 없는 경우, doctor는 해결 방법(install Docker 또는 openclaw config set agents.defaults.sandbox.mode off)과 함께 중요도 높은 경고를 보고합니다.

macOS: launchctl 환경 오버라이드

이전에 launchctl setenv OPENCLAW_GATEWAY_TOKEN ...(또는 ...PASSWORD)를 실행한 경우, 해당 값이 설정 파일을 오버라이드하여 지속적인 “unauthorized” 오류를 일으킬 수 있습니다.

launchctl getenv OPENCLAW_GATEWAY_TOKEN
launchctl getenv OPENCLAW_GATEWAY_PASSWORD

launchctl unsetenv OPENCLAW_GATEWAY_TOKEN
launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD