콘텐츠로 이동

문제가 생겼을 때 바로 확인하는 해결 가이드

코드를 짜다 보면 갑자기 막히는 순간이 오기 마련이죠. 분명 어제까지는 잘 작동했는데 갑자기 에러 메시지가 뜨거나, 환경 설정이 꼬여서 진도가 나가지 않을 때의 답답함은 모든 개발자가 겪는 고충입니다.

문제를 해결하려고 구글링을 반복하며 시간을 쓰기보다는, 아래 가이드를 따라 하나씩 점검해 보세요. 가장 빠르게 다시 개발에 집중할 수 있는 방법을 정리했습니다.

시작하기 전에 다음 항목들이 준비되어 있는지 확인해 주세요.

  • Node.js 및 npm 설치 상태 확인
  • 시스템 PATH 설정 상태
  • Gateway 환경 구성

문제를 해결하는 가장 빠른 4가지 단계입니다. 5분 안에 상태를 점검해 보세요.

  1. Troubleshooting 시작: 가장 먼저 Troubleshooting 가이드를 확인해서 일반적인 해결책을 찾아보세요.
  2. 설치 상태 점검: Node.js, npm 또는 PATH 설정에 문제가 있다면 Install sanity 섹션을 참고하세요.
  3. Gateway 이슈 해결: Gateway 서비스에서 문제가 발생했다면 Gateway troubleshooting 페이지가 도움이 됩니다.
  4. 시스템 복구: 설정이 많이 꼬였다면 Doctor 기능을 사용해 복구를 시도해 보세요.

자주 발생하는 문제와 로그 확인 방법입니다.

  • 로그 확인이 필요한 경우: 일반적인 시스템 로그는 Logging에서, Gateway 관련 로그는 Gateway logging에서 확인할 수 있습니다.
  • 개념적인 궁금증: “왜 이렇게 동작하지?” 같은 기술적 개념이 궁금하다면 FAQ (concepts)를 읽어보세요.

더 자세한 도움이 필요하거나 특정 상황에 맞는 해결책을 찾고 싶다면 AI Setup Assistant에게 직접 물어보세요.

OpenClaw

OpenClaw Expert

아직 막혀 있나요?

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.