OpenClaw를 빨리 써보고 싶은데 어디서부터 할지 모르겠다면? 이 글은 설치 전 준비(Node 버전과 18789 포트), 세 가지 설치 방식과 10분 루트 선택, 설치부터 첫 대화까지 단계, 그리고 포트/콘솔 접속 불가 3가지 난관과 FAQ를 담아 Windows, Linux, macOS, 원격 Mac 어디서든 약 10분 안에 첫 대화까지 갈 수 있게 돕습니다.
설치 전 준비: Node 버전과 18789 포트
OpenClaw 2026은 Node.js v22 이상이 필요하며, 그 미만이면 설치나 빌드가 실패할 수 있습니다. nvm 사용 권장: nvm install 22 && nvm use 22. OpenClaw는 Web 콘솔에 기본으로 18789 포트를 씁니다. 클라우드 서버나 원격 Mac을 쓰면 방화벽/보안 그룹에서 18789(TCP)를 허용해야 브라우저로 콘솔에 접속할 수 있습니다.
- Node 버전: 터미널에서
node -v실행, v22.0.0 이상이어야 함. - 포트 18789: 호스트에서 18789 인바운드를 허용. Linux에서 ufw 사용 시
ufw allow 18789.
세 가지 설치 방식과 10분 루트 선택
환경과 선호에 따라 아래 세 가지 중 하나를 고르면 됩니다. 목표는 약 10분 안에 설치를 끝내고 콘솔을 여는 것입니다.
| 방식 | 적합한 대상 | 예상 소요 | 비고 |
|---|---|---|---|
| 공식 설치 스크립트 | 초보자, 로컬·VPS에서 빠르게 체험 | 약 5–10분 | curl -fsSL https://openclaw.ai/install.sh | bash. 스크립트가 Node를 검사·설치. |
| npm 전역 설치 | 이미 Node 22+가 있는 개발자 | 약 5–8분 | npm install -g openclaw@latest 후 openclaw onboard, openclaw gateway 실행. |
| Docker / 사전 구성 이미지 | 팀·운영 환경, 의존성 격리 원할 때 | 약 10–15분 | 공식 또는 커뮤니티 Docker 이미지 사용, 18789 포트 매핑. 일부 클라우드는 OpenClaw 원클릭 이미지 제공. |
npm config set registry https://registry.npmmirror.com.설치부터 첫 대화까지 단계
「설치 스크립트 + onboard」 기준 최소 경로입니다.
OpenClaw 설치
curl -fsSL https://openclaw.ai/install.sh | bash 또는 npm install -g openclaw@latest 실행 후 완료될 때까지 대기.
설정 마법사 실행
openclaw onboard 실행 후 Gateway, API 등 기본 설정을 안내에 따라 완료. 권한 창(macOS 등)이 뜨면 GUI에서 허용 클릭.
Gateway 실행
openclaw gateway 실행(또는 systemd/pm2로 상주). 18789 포트 리스닝 확인.
Web 콘솔 열기
브라우저에서 http://localhost:18789(또는 서버 IP:18789) 접속해 Dashboard 진입.
첫 명령 보내기
콘솔 또는 TUI(openclaw tui)에서 간단한 명령 한 개를 보내 모델과 Gateway가 응답하는지 확인하면「첫 대화」완료.
포트와 콘솔 접속 불가 3가지 난관
「설치는 했는데 콘솔이 안 열린다」「onboard 중에 에러」로 막히는 경우가 많습니다. 흔한 원인과 대처는 아래와 같습니다.
- 방화벽/보안 그룹에서 18789 미허용: 클라우드에서는 보안 그룹에 TCP 18789 인바운드 규칙 추가. 로컬 Linux에서 ufw 사용 시
ufw allow 18789후 reload. - Node 버전이 낮음: Node 22+가 아니면 설치·실행 시 에러.
nvm use 22또는 시스템 패키지 매니저로 업그레이드 후 재시도. - 기본 Token 미변경으로 스캔당함: 배포 후 Dashboard에서 기본 Gateway Token을 바로 변경해 공개 스캔·악용을 막고, 시스템 프롬프트 길이도 확인해 Token 소비 이상을 피하세요.
FAQ
10분이면 정말 첫 대화까지 갈 수 있나요?
Node 22+와 네트워크가 정상이면, 설치 스크립트 또는 npm 전역 설치로 onboard → gateway → 18789 콘솔 열기 → 명령 한 개 보내기 순서로 진행하면 대부분 사용자가 10분 안에 끝낼 수 있습니다. 네트워크·권한 문제가 있으면 사이트 내 OpenClaw 오류 조사·배포 글을 참고하세요.
원격 Mac에 OpenClaw를 설치하는 이점은?
원격 Mac은 풀 GUI(VNC)라서 onboard 중 시스템 권한 창, Keychain 확인을 직접 클릭해 처리할 수 있어, SSH만으로는 창을 못 누르는 문제를 피할 수 있습니다. 사이트 내 다른 OpenClaw 배포·권한 창 회피 글과 함께 보시면 좋습니다.
openclaw doctor는 뭘 하나요?
openclaw doctor는 환경·의존성·설정이 정상인지 점검합니다. 콘솔이 안 뜨거나 이상할 때는 먼저 doctor를 실행해 출력을 확인한 뒤, 사이트 내 조사 가이드와 함께 대처하세요.
마무리:로컬 Windows, Linux나 자체 VPS에서도 OpenClaw를 돌릴 수 있지만, Node 버전·포트 개방·권한 창·의존 환경 때문에 난관이 많고 조사 비용이 듭니다. 환경 부담을 줄이고 GUI onboard와 시스템 권한까지 포함해 OpenClaw를 빠르게 쓰고 싶다면 VNCMac 원격 Mac을 임대해 VNC 데스크톱에서 OpenClaw를 배포하면 환경 차이와 창 클릭 불가 문제를 피하고, 몇 분 안에 준비된 Mac과 그래픽 설정을 쓸 수 있습니다. 선택은 사이트 내「OpenClaw 환경 선택」「빠른 개통」 페이지를 참고하세요.