Troubleshooting

첫 60초

다음 명령을 순서대로 실행하세요:

openclaw status
openclaw status --all
openclaw gateway probe
openclaw logs --follow
openclaw doctor

Gateway에 접근 가능하다면, 심층 프로브를 실행합니다:

openclaw status --deep

일반적인 "문제 발생" 사례

openclaw: command not found

거의 항상 Node/npm PATH 문제입니다. 여기서 시작하세요:

설치 프로그램 실패 (또는 전체 로그가 필요한 경우)

전체 추적 및 npm 출력을 보려면 verbose 모드에서 설치 프로그램을 다시 실행하세요:

curl -fsSL https://openclaw.bot/install.sh | bash -s -- --verbose

베타 설치의 경우:

curl -fsSL https://openclaw.bot/install.sh | bash -s -- --beta --verbose

플래그 대신 OPENCLAW_VERBOSE=1을 설정할 수도 있습니다.

Gateway "unauthorized", 연결 불가, 또는 계속 재연결됨

Control UI가 HTTP에서 실패 (기기 ID 필요)

docs.openclaw.ai에 SSL 오류 표시 (Comcast/Xfinity)

일부 Comcast/Xfinity 연결은 Xfinity Advanced Security를 통해 docs.openclaw.ai를 차단합니다. Advanced Security를 비활성화하거나 docs.openclaw.ai를 허용 목록에 추가한 후 다시 시도하세요.

서비스가 실행 중이라고 하지만 RPC 프로브가 실패함

모델/인증 실패 (속도 제한, 결제, "all models failed")

/model이 model not allowed라고 표시

일반적으로 agents.defaults.models가 허용 목록으로 구성되어 있음을 의미합니다. 비어 있지 않으면 해당 provider/model 키만 선택할 수 있습니다.

  • 허용 목록 확인: openclaw config get agents.defaults.models
  • 원하는 모델을 추가하거나 허용 목록을 지운 후 /model을 다시 시도하세요
  • /models를 사용하여 허용된 provider/model을 탐색하세요

이슈 제출 시

안전한 리포트를 붙여넣으세요:

openclaw status --all

가능하면 openclaw logs --follow에서 관련 로그 테일을 포함하세요.

← 문서로 돌아가기