> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openclaw.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# doctor

# `openclaw doctor`

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

관련 항목:

* 문제 해결: [문제 해결](/gateway/troubleshooting)
* 보안 감사: [보안](/gateway/security)

## 예제

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw doctor
openclaw doctor --repair
openclaw doctor --deep
```

참고 사항:

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

## macOS: `launchctl` 환경 변수 오버라이드

이전에 `launchctl setenv OPENCLAW_GATEWAY_TOKEN ...` (또는 `...PASSWORD`)를 실행한 경우, 해당 값이 설정 파일을 오버라이드하여 지속적인 "인증되지 않음" 오류를 유발할 수 있습니다.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
launchctl getenv OPENCLAW_GATEWAY_TOKEN
launchctl getenv OPENCLAW_GATEWAY_PASSWORD

launchctl unsetenv OPENCLAW_GATEWAY_TOKEN
launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD
```