OpenClaw 설치 및 리뷰

1. 들어가며

OpenClaw(오픈클로)는 AI 에이전트를 다양한 채널(Telegram, Discord, Slack 등)과 연동하여 운영할 수 있는 플랫폼이다. 공식 문서에 따르면 Node.js 22 이상이 필수 요구사항이다. Rocky Linux, RHEL 8, CentOS 8 같은 RPM 기반 배포판에서는 기본 AppStream 리포지토리의 Node.js 버전이 10대인 경우가 많아, 별도 설정 없이는 설치가 불가능하다.

이 글은 Rocky Linux 환경에서 OpenClaw를 설치·운영하기 위한 사전 준비를 수행한 과정을 정리한 것이다. 동일 환경에서 재설치하거나, 다른 사용자에게 설치 방법을 안내할 때 참고할 수 있도록 작성하였다.

---

2. 요구사항

항목	버전/사양
Node.js	22 이상 (LTS 권장)
패키지 매니저	npm, pnpm, 또는 bun
OS	Rocky Linux / RHEL 8 / CentOS 8 (macOS, Windows WSL2도 지원)
RAM	최소 4GB (8GB+ 권장)
저장공간	최소 2GB (10GB+ 권장)

---

3. 사전 준비 작업

3.1 기존 Node.js 버전 확인

먼저 설치된 Node.js 버전을 확인한다.

node --version

v10.x.x 또는 그 이하가 출력된다면 NodeSource를 통해 Node.js 22를 설치해야 한다. 주의: AppStream의 Node.js 10과 NodeSource의 Node.js 22는 동시에 설치할 수 없으며, 기존 Node.js를 제거한 후 새 버전을 설치해야 한다.

3.2 자동 설치 (권장)

프로젝트에 포함된 스크립트를 실행하면 빌드 도구, Git, Node.js 22가 순서대로 설치된다.

./scripts/setup-prerequisites.sh

 

스크립트가 수행하는 작업:

1. gcc-c++, make, curl, git 설치
2. 기존 Node.js 10 제거 (있는 경우)
3. NodeSource Node.js 22 리포지토리 설정
4. Node.js 22 설치
5. 설치 결과 확인

3.3 수동 설치

⚠️ 기존 Node.js 10(AppStream)이 설치된 경우
NodeSource Node.js 22와 충돌하므로, 먼저 sudo dnf remove -y nodejs npm 후 진행해야 한다.

# 1. 빌드 도구 및 Git
sudo dnf install -y gcc-c++ make curl git

# 2. 기존 Node.js 제거 (v10인 경우)
sudo dnf remove -y nodejs npm
sudo dnf module reset -y nodejs

# 3. NodeSource Node.js 22 리포지토리 설정
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -

# 4. Node.js 설치
sudo dnf install -y nodejs --allowerasing

# 5. 확인
node --version   # v22.x.x
npm --version   # 10.x.x

---

4. 트러블슈팅

4.1 "cannot install both nodejs" 충돌 오류

증상: dnf install nodejs 실행 시 cannot install both nodejs-1:10.24.0... and nodejs-2:22.x.x 오류 발생.

원인: AppStream의 Node.js 10과 NodeSource의 Node.js 22가 동시에 설치될 수 없음.

해결: 기존 nodejs, npm 패키지를 먼저 제거한 후 설치한다.

sudo dnf remove -y nodejs npm
sudo dnf module reset -y nodejs
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install -y nodejs --allowerasing

4.2 npm EACCES 권한 오류

증상: npm install -g openclaw 실행 시 EACCES, mkdir 관련 권한 오류 발생.

해결: npm 글로벌 prefix를 사용자 디렉터리로 변경한다.

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc   # bash 사용 시
# echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc  # zsh 사용 시
source ~/.bashrc   # 또는 source ~/.zshrc

4.3 openclaw 명령어를 찾을 수 없음

증상: 설치 후 openclaw 명령어를 실행할 수 없음.

해결: 새 터미널을 열거나, npm prefix의 bin 경로가 PATH에 포함되었는지 확인한다.

npm config get prefix
# 출력된 경로/bin 이 PATH에 있어야 함
which node

---

5. OpenClaw 설치

사전 준비가 완료되면 OpenClaw를 설치한다.

# npm 글로벌 설치
npm install -g openclaw@latest

# 온보딩 (게이트웨이, 워크스페이스 설정)
openclaw onboard --install-daemon

원클릭 설치 (Node 포함)

Node.js가 전혀 없는 환경에서 한 번에 설치하고 싶다면 공식 설치 스크립트를 사용할 수 있다. 이 스크립트는 Linux에서 NodeSource를 통해 Node.js 22를 설치한 뒤 openclaw를 설치한다.

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

 

 

 

---

 

6. 마치며

Rocky Linux 환경에서 AppStream의 Node.js 10과 NodeSource의 Node.js 22 간 충돌을 해결한 뒤 OpenClaw 사전 준비를 완료했다. 동일한 RPM 기반 배포판을 사용하는 환경에서도 위 순서대로 진행하면 설치가 가능할 것이다.

추가로 채널 연동(Telegram, Discord 등), 에이전트 설정, 스킬 설치 등은 공식 문서(docs.clawd.bot)를 참고하자.