> ## 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. # 문제 해결 # 문제 해결 단 2분만 있다면, 이 페이지를 초기 진단의 출입구로 사용하세요. ## 처음 60초 다음 절차를 정확하게 순서대로 실행하세요: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw status openclaw status --all openclaw gateway probe openclaw gateway status openclaw doctor openclaw channels status --probe openclaw logs --follow ``` 한 줄로 좋은 출력 결과: * `openclaw status` → 구성된 채널이 보이고 명확한 인증 오류가 없음. * `openclaw status --all` → 전체 보고서가 존재하고 공유 가능함. * `openclaw gateway probe` → 예상한 게이트웨이 대상에 도달 가능 (`Reachable: yes`). `RPC: limited - missing scope: operator.read`는 degraded diagnostics이며 연결 실패는 아닙니다. * `openclaw gateway status` → `Runtime: running` 및 `RPC probe: ok`. * `openclaw doctor` → 차단되는 설정/서비스 오류 없음. * `openclaw channels status --probe` → 채널이 `connected` 또는 `ready` 상태 보고. * `openclaw logs --follow` → 지속적인 활동, 반복되는 치명적 오류 없음. ## 의사 결정 트리 ```mermaid theme={"theme":{"light":"min-light","dark":"min-dark"}} flowchart TD A[OpenClaw is not working] --> B{What breaks first} B --> C[No replies] B --> D[Dashboard or Control UI will not connect] B --> E[Gateway will not start or service not running] B --> F[Channel connects but messages do not flow] B --> G[Cron or heartbeat did not fire or did not deliver] B --> H[Node is paired but camera canvas screen exec fails] B --> I[Browser tool fails] C --> C1[/No replies section/] D --> D1[/Control UI section/] E --> E1[/Gateway section/] F --> F1[/Channel flow section/] G --> G1[/Automation section/] H --> H1[/Node tools section/] I --> I1[/Browser section/] ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw status openclaw gateway status openclaw channels status --probe openclaw pairing list --channel [--account ] openclaw logs --follow ``` 좋은 출력 결과는 다음과 같습니다: * `Runtime: running` * `RPC probe: ok` * `channels status --probe`에서 채널이 연결/준비 상태로 표시됨 * 발신자가 승인된 것처럼 보임 (또는 다이렉트 메시지 정책이 오픈/허용 목록) 일반적인 로그 서명: * `drop guild message (mention required` → Discord에서 멘션 게이팅으로 메시지가 차단됨. * `pairing request` → 발신자가 승인되지 않았고 다이렉트 메시지 쌍으로 승인 대기 중. * `blocked` / `allowlist` in channel logs → 발신자, 방 또는 그룹이 필터링됨. 심층 페이지: * [/gateway/troubleshooting#no-replies](/ko-KR/gateway/troubleshooting#no-replies) * [/channels/troubleshooting](/ko-KR/channels/troubleshooting) * [/channels/pairing](/ko-KR/channels/pairing) ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw status openclaw gateway status openclaw logs --follow openclaw doctor openclaw channels status --probe ``` 좋은 출력 결과는 다음과 같습니다: * `Dashboard: http://...`가 `openclaw gateway status`에 표시됨 * `RPC probe: ok` * 로그에 인증 루프 없음 일반적인 로그 서명: * `device identity required` → HTTPS/비보안 컨텍스트에서 장치 인증 완료 불가. * `AUTH_TOKEN_MISMATCH` 와 재시도 힌트(`canRetryWithDeviceToken=true`) → 신뢰된 device token 재시도 1회가 자동으로 발생할 수 있습니다. * 그 재시도 이후에도 반복되는 `unauthorized` → 잘못된 token/password, auth mode 불일치, 또는 오래된 paired device token. * `gateway connect failed:` → UI가 잘못된 URL/포트 또는 도달 불가능한 게이트웨이를 대상으로 설정됨. 심층 페이지: * [/gateway/troubleshooting#dashboard-control-ui-connectivity](/ko-KR/gateway/troubleshooting#dashboard-control-ui-connectivity) * [/web/control-ui](/ko-KR/web/control-ui) * [/gateway/authentication](/ko-KR/gateway/authentication) ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw status openclaw gateway status openclaw logs --follow openclaw doctor openclaw channels status --probe ``` 좋은 출력 결과는 다음과 같습니다: * `Service: ... (loaded)` * `Runtime: running` * `RPC probe: ok` 일반적인 로그 서명: * `Gateway start blocked: set gateway.mode=local` → 게이트웨이 모드가 설정되지 않음/원격. * `refusing to bind gateway ... without auth` → 비인증 비밀번호/토큰 없이 비로컬 루프백에 바인드 거부. * `another gateway instance is already listening` or `EADDRINUSE` → 포트가 이미 사용 중. 심층 페이지: * [/gateway/troubleshooting#gateway-service-not-running](/ko-KR/gateway/troubleshooting#gateway-service-not-running) * [/gateway/background-process](/ko-KR/gateway/background-process) * [/gateway/configuration](/ko-KR/gateway/configuration) ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw status openclaw gateway status openclaw logs --follow openclaw doctor openclaw channels status --probe ``` 좋은 출력 결과는 다음과 같습니다: * 채널 전송이 연결됨. * 쌍/허용 목록 검사가 통과됨. * 필요한 경우 멘션이 감지됨. 일반적인 로그 서명: * `mention required` → 그룹 멘션 게이팅이 처리 차단. * `pairing` / `pending` → 다이렉트 메시지 발신자가 아직 승인되지 않음. * `not_in_channel`, `missing_scope`, `Forbidden`, `401/403` → 채널 권한 토큰 문제. 심층 페이지: * [/gateway/troubleshooting#channel-connected-messages-not-flowing](/ko-KR/gateway/troubleshooting#channel-connected-messages-not-flowing) * [/channels/troubleshooting](/ko-KR/channels/troubleshooting) ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw status openclaw gateway status openclaw cron status openclaw cron list openclaw cron runs --id --limit 20 openclaw logs --follow ``` 좋은 출력 결과는 다음과 같습니다: * `cron.status`가 다음으로 깨어날 예정으로 활성화된 상태로 표시됨. * `cron runs`가 최근 `ok` 항목을 표시함. * 하트비트가 활성화되고 활성 시간대 외부가 아님. 일반적인 로그 서명: * `cron: scheduler disabled; jobs will not run automatically` → 크론이 비활성화됨. * `heartbeat skipped` with `reason=quiet-hours` → 설정된 활성 시간대 외부. * `requests-in-flight` → 주레인 바쁨; 하트비트 깨우기 연기됨. * `unknown accountId` → 하트비트 전달 대상 계정이 존재하지 않음. 심층 페이지: * [/gateway/troubleshooting#cron-and-heartbeat-delivery](/ko-KR/gateway/troubleshooting#cron-and-heartbeat-delivery) * [/automation/troubleshooting](/ko-KR/automation/troubleshooting) * [/gateway/heartbeat](/ko-KR/gateway/heartbeat) * [/tools/browser-wsl2-windows-remote-cdp-troubleshooting](/ko-KR/tools/browser-wsl2-windows-remote-cdp-troubleshooting) ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw status openclaw gateway status openclaw nodes status openclaw nodes describe --node openclaw logs --follow ``` 좋은 출력 결과는 다음과 같습니다: * 노드가 `node` 역할로 연결되고 쌍으로 지정되어 있음. * 실행하려는 명령에 대한 기능이 존재함. * 도구에 대한 권한 상태가 부여됨. 일반적인 로그 서명: * `NODE_BACKGROUND_UNAVAILABLE` → 노드 앱을 포그라운드로 가져오세요. * `*_PERMISSION_REQUIRED` → OS 권한이 거부/누락됨. * `SYSTEM_RUN_DENIED: approval required` → 실행 승인이 대기 중. * `SYSTEM_RUN_DENIED: allowlist miss` → 명령이 실행 허용 목록에 없음. 심층 페이지: * [/gateway/troubleshooting#node-paired-tool-fails](/ko-KR/gateway/troubleshooting#node-paired-tool-fails) * [/nodes/troubleshooting](/ko-KR/nodes/troubleshooting) * [/tools/exec-approvals](/ko-KR/tools/exec-approvals) ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw status openclaw gateway status openclaw browser status openclaw logs --follow openclaw doctor ``` 좋은 출력 결과는 다음과 같습니다: * 브라우저 상태가 `running: true` 및 선택된 브라우저/프로필을 표시함. * `openclaw` 프로필 시작 또는 `chrome` 릴레이에 연결된 탭이 있음. 일반적인 로그 서명: * `Failed to start Chrome CDP on port` → 로컬 브라우저 실행 실패. * `browser.executablePath not found` → 설정된 이진 경로가 잘못됨. * `Chrome extension relay is running, but no tab is connected` → 확장 프로그램이 연결되지 않음. * `Browser attachOnly is enabled ... not reachable` → 붙임 전용 프로필에 라이브 CDP 대상이 없음. 심층 페이지: * [/gateway/troubleshooting#browser-tool-fails](/ko-KR/gateway/troubleshooting#browser-tool-fails) * [/tools/browser-linux-troubleshooting](/ko-KR/tools/browser-linux-troubleshooting) * [/tools/chrome-extension](/ko-KR/tools/chrome-extension)