---
read_when:
    - 처음 사용하는 사용자를 위한 "무엇을 클릭하고 실행해야 하는지" 안내서
    - 무언가 문제가 발생했고 가장 빠른 해결 방법이 필요한 경우
summary: '도움말 허브: 일반적인 해결 방법, 설치 정상 여부 확인, 문제가 발생했을 때 확인할 위치'
title: 도움말
x-i18n:
    generated_at: "2026-05-06T06:28:14Z"
    model: gpt-5.5
    provider: openai
    source_hash: 118e8ad2207d32739d3da7d0097604dfad8e7780843841f4f84a44cd77eb8736
    source_path: help/index.md
    workflow: 16
---

빠르게 막힌 문제를 해결하기 위한 가장 흔한 문제 경로:

- [문제 해결](/ko/help/troubleshooting) - 증상 우선 의사결정 트리
- [디버깅](/ko/help/debugging) - watch 모드, 원시 스트림, 개발 프로필
- [설치 상태 확인](/ko/install/node#troubleshooting) - Node / npm / PATH 확인
- [Gateway 문제 해결](/ko/gateway/troubleshooting) - Gateway 관련 문제
- [진단 도구](/ko/gateway/doctor) - 자동 복구 + 진단 번들

## FAQ

- [FAQ](/ko/help/faq) - 일상적인 개념과 운영 질문
- [첫 실행 FAQ](/ko/help/faq-first-run) - 설치, 온보딩, 인증, 구독, 초기 실패
- [모델 FAQ](/ko/help/faq-models) - 모델 선택, 장애 조치, 인증 프로필

## 진단

- [환경 변수](/ko/help/environment) - OpenClaw가 환경 변수를 로드하는 위치와 우선순위
- [진단 플래그](/ko/diagnostics/flags) - 런타임 진단 및 상세 모드
- [Node + tsx 충돌](/ko/debug/node-issue) - 특정 Node / tsx 런타임 충돌 시나리오

## 테스트

- [테스트](/ko/help/testing) - 테스트 스위트와 Docker 러너
- [업데이트 및 Plugin 테스트](/ko/help/testing-updates-plugins) - 패키지 업데이트, 마이그레이션, Plugin 설치 검증
- [라이브 테스트](/ko/help/testing-live) - 네트워크에 연결되는 프로바이더 및 CLI 스모크 테스트

## 커뮤니티 및 메타

- [OpenClaw 이야기](/ko/start/lore) - 이야기
- [문서 허브](/ko/start/hubs) - 이 문서가 구성된 방식
- [문서 디렉터리](/ko/start/docs-directory) - 전체 파일 맵