OpenClaw Doctor는 언제 써야 할까｜진단과 수정 명령을 구분하는 법

OpenClaw가 기대대로 동작하지 않을 때 설정 파일부터 지우면 원인을 더 찾기 어려워집니다. 공식 Doctor 문서는 상태 점검, 마이그레이션, 복구를 구분해서 다룹니다.

먼저 읽기 전용 점검부터

openclaw doctor는 사람이 현재 상태를 확인하는 기본 진단 명령입니다. 자동화나 사전 점검처럼 변경 없이 구조화된 결과가 필요하면 openclaw doctor --lint를 사용합니다. lint는 프롬프트·재시작·설정 쓰기 없이 점검 결과만 돌려줍니다.

수정 명령은 별도입니다

openclaw doctor --fix는 권장되는 설정·상태 복구를 적용하는 명령입니다. 따라서 먼저 현재 설정 파일과 진단 결과를 보고, 어떤 변경이 일어날지 이해한 뒤 쓰는 편이 좋습니다. 더 강한 복구 옵션은 서비스와 상태에 영향을 줄 수 있으므로 자동 실행 기본값으로 두지 않는 편이 안전합니다.

짧은 운영 순서

1. 증상과 마지막 성공 시점을 기록합니다.
2. doctor 또는 lint로 읽기 전용 진단을 합니다.
3. 설정·인증·채널 중 어느 층인지 분류합니다.
4. 필요한 경우에만 fix를 실행하고 다시 상태를 확인합니다.

재시도와 실패 분류의 전체 흐름은 OpenClaw 업데이트 글도 함께 참고하세요. 이 글은 공식 문서 기반의 일반 안내입니다.