설치플랫폼 가이드health check
먼저 OpenClaw 설치를 안정화하고, 그 다음 고급 설정
설치 페이지의 목표는 가능한 한 빨리 동작 확인이 가능한 OpenClaw 인스턴스를 얻는 것이며, 처음부터 환경 문제에 빠지지 않는 것입니다.
- ›플랫폼별로 경로를 나눠 문제를 섞지 않는다.
- ›먼저 health 검증을 하고 그 뒤에 모델과 스킬 설정으로 진행.
- ›로컬 환경이 반복 실패하면 Docker나 호스팅 경로로 우선 전환.
시작하기
더 안정적인 설치 경로를 선택하세요
플랫폼별 설치를 먼저 끝낸 뒤 health check 와 첫 작업 검증으로 이어가세요.
왜 설치 단계가 가장 자주 막히는가
대부분의 실패는 OpenClaw 자체 문제가 아니라 시스템 의존성, 권한, 네트워크, 또는 컨테이너 환경 불일치 때문에 발생합니다.
따라서 설치 전략의 핵심은 단순히 깔리는 것이 아니라, 먼저 기반 환경이 제대로 맞는지 검증하는 것입니다.
권장 설치 순서
먼저 현재 플랫폼에 맞는 설치 경로를 확인하고, 그 다음 health check 를 완료한 뒤, 마지막으로 setup 페이지로 가서 모델, 스킬, Relay 를 설정해야 합니다.
이 순서를 따르면 설치 실패와 설정 실패를 분리해서 볼 수 있어 이후 문제를 훨씬 쉽게 좁힐 수 있습니다.
관련 가이드
Q&A
로컬 설치가 계속 실패하면 어떻게 해야 하나요?
먼저 해당 오류 페이지를 따라 하나씩 분리해서 확인하세요. 원인이 로컬 환경 드리프트라면 Docker 나 호스팅 경로로 바꾸는 편이 더 빠를 때가 많습니다.
설치가 끝난 뒤 가장 먼저 해야 할 일은 무엇인가요?
health check 와 첫 작업 검증을 수행해 인스턴스, 네트워크, 의존성이 정상인지 확인한 뒤 설정 단계로 넘어가야 합니다.