---
read_when:
    - 처음 시작하며 “무엇을 클릭하거나 실행해야 하나요?” 가이드를 원합니다
    - 문제가 발생했고 가장 빠르게 해결하는 방법을 원합니다
summary: '도움말 허브: 일반적인 문제 해결, 설치 상태 점검, 그리고 문제가 발생했을 때 확인할 위치'
title: 도움말
x-i18n:
    generated_at: "2026-04-24T08:57:45Z"
    model: gpt-5.4
    provider: openai
    source_hash: f4ea596c304ceee2422fd0ba67f61ad6e38c423a476a41cabec06f53f7a55b38
    source_path: help/index.md
    workflow: 15
---

가장 흔한 문제에서 빠르게 “막힘 해소” 경로:

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

## FAQ

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

## 진단

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

## 테스트

- [테스트](/ko/help/testing) — 테스트 스위트와 Docker 러너
- [라이브 테스트](/ko/help/testing-live) — 네트워크에 연결되는 provider 및 CLI 스모크 테스트

## 커뮤니티 및 기타

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