OpenClaw 설치 방법 (공식 방법 + 주의사항)

간단한 답변

Confirm system requirements (Node.js 22+, macOS or Linux or Windows via WSL2), run the official install script, then complete openclaw onboard to connect channels and models.

1단계: 먼저 요구 사항 확인

OpenClaw는 최신 Node 기능을 사용하므로 Node.js 22 이상이 필요합니다. Windows에서는 WSL2가 지원되는 경로입니다. 이전 Node 버전에 설치하는 것이 실패의 가장 흔한 원인입니다.

2단계: 공식 설치 스크립트 사용

권장 방법은 CLI를 설치하고 런타임을 준비합니다:

curl -fsSL https://openclaw.bot/install.sh | bash
openclaw onboard --install-daemon

3단계: 온보딩 완료

마법사를 통해 메시징 채널 페어링, 모델 제공자 선택, 스킬 활성화를 진행합니다. 여기서 초기 권한을 설정하고 OpenClaw가 액세스할 수 있는 항목을 확인합니다.

설치 후 유용한 명령어

Use openclaw doctor to validate dependencies, openclaw status or openclaw health to check the gateway, and openclaw update to stay current.

운영 환경 사용 전 설치 확인

온보딩 후, 임시 폴더에 파일을 생성하거나 로컬 텍스트 파일을 요약하는 등 위험도가 낮은 스킬을 사용하는 작은 테스트 작업을 실행하세요. 이를 통해 채널, 모델 및 스킬이 올바르게 연결되었는지 확인할 수 있습니다. 서버에 배포하는 경우, 필요한 포트만 열려 있는지, 관리자 페어링이 적용되었는지 확인하세요.

일반적인 설치 시 문제점

Most failures come from an outdated Node version, missing build tools, or running the script under the wrong user account. Another frequent issue is partial installs caused by network errors during package download. If the CLI behaves inconsistently, re-run the install script and check logs with openclaw doctor .

보안 관련 알림

관리자 엔드포인트를 공개 인터넷에 노출하지 말고, 신뢰할 수 없는 스킬 설치를 피하세요. 서버에서 OpenClaw를 실행하는 경우, 포트를 잠그고 최소 권한 액세스를 사용하세요.

공식 참고 자료

For exact instructions, see the official install and wizard pages: Install and Onboard .

OpenClaw 설치 방법