openclaw doctor
게이트웨이와 채널에 대한 상태 점검 및 빠른 수정.
관련 문서:
- 문제 해결: Troubleshooting
- 보안 감사: Security
예시
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