OpenClaw 시스템 요구 사항

설치 전에 환경이 기본 요구 사항을 충족하는지 확인하십시오.

간단한 답변

OpenClaw는 Node.js 22 이상을 요구하며 macOS, Linux 및 WSL2를 통한 Windows를 지원합니다. 대부분의 사용자에게는 로컬 모델이나 무거운 자동화를 실행하지 않는 한 최신 노트북으로 충분합니다.

Node.js 22+가 필요한 이유

런타임은 최신 Node 기능과 최신 종속성에 따라 달라집니다. 이전 Node 버전을 사용하면 설치 실패 또는 부하 시 게이트웨이 프로세스가 충돌하는 경우가 많습니다.

지원되는 운영 체제

macOS 및 Linux는 네이티브로 지원됩니다. Windows 사용자는 안정적인 Unix 유사 환경을 위해 WSL2를 통해 OpenClaw를 실행해야 합니다. 서버에서 호스팅하는 경우 Linux가 가장 예측 가능한 옵션입니다.

사용 사례별 하드웨어 가이드

클라우드 모델만 사용하는 경우 CPU 및 메모리 요구 사항은 적게 유지됩니다. 로컬 모델이나 여러 채널을 동시에 실행할 계획이라면 더 많은 RAM과 스토리지가 도움이 됩니다. 로그, 캐시 및 스킬 데이터를 위한 충분한 디스크 공간을 확보하십시오.

최소 사양 대 권장 사양

8GB RAM을 갖춘 최신 노트북은 일반적으로 클라우드 모델 및 가벼운 자동화에 충분합니다. 더 무거운 워크로드를 위해서는 16GB 이상이 더 안전한 기본 사양입니다. 로그, 캐시 액세스 및 모델 다운로드를 더 빠르게 하려면 SSD 스토리지가 강력히 권장됩니다.

네트워크 고려 사항

OpenClaw는 완전히 로컬에서 실행될 수 있지만 많은 사용자가 외부 모델 API에 연결합니다. 아웃바운드 HTTPS 액세스가 허용되고 안정적인지 확인하십시오. 네트워크가 잠겨 있다면 프록시 설정을 계획하고 게이트웨이 포트가 공개적으로 노출되지 않는지 확인하십시오.

사용자 권한 및 데몬 모드

권한 있는 시스템 계정이 아닌 일반 사용자 계정으로 OpenClaw를 설치하고 실행하십시오. 데몬 모드를 사용하는 경우 서비스가 부팅 시 시작되고 작업 디렉토리를 읽고 쓸 수 있는지 확인하십시오. 잘못된 권한은 사소한 실패의 일반적인 원인입니다.

빠른 환경 확인

Check your Node version first, then run openclaw doctor after install. Fixing missing dependencies early saves hours of debugging later.

공식 참조

Use the official install requirements as the authoritative source: Install requirements .