📑 OpenClaw 클러스터 재구축 마스터 플랜

📑 OpenClaw 클러스터 재구축 마스터 플랜

0. 전제 조건 (안정화 버전)

• OS: macOS Sequoia (15.x) 또는 Sonoma (14.x)

• Node.js: v20.12.2 (LTS) - v22 이상은 특정 모듈 충돌 가능성 있음

• Docker: v4.28.0+ (선택 사항, 로컬 DB 사용 시)

• Ollama: v0.1.48+

---

1. 상세 설치 순서 및 에러 가이드

[Step 1] 환경 정리 및 Node.js 설치

이전의 찌꺼기 파일이 문제를 일으킬 수 있으므로 깨끗하게 시작합니다.

1. 기존 node_modules 삭제: rm -rf node_modules

2. NVM(Node Version Manager)을 통한 버전 고정:

   Bash

   nvm install 20.12.2
   nvm use 20.12.2

[Step 2] OpenClaw 메인 설치 (맥미니)

1. 저장소 클론 및 패키지 설치:

   Bash

   git clone https://github.com/openclaw/openclaw.git
   cd openclaw
   npm install

2. 에러 발생 시: npm install 중 ‘gyp’ 에러나 ‘permission’ 에러 발생 시:

   • 해결: xcode-select --install로 빌드 도구 확인 후 sudo npm install --unsafe-perm 시도.

[Step 3] 노드(Node) 연결 설정

메인(맥미니)의 config.json에서 PC들의 Ollama API 주소를 등록합니다.

• 주의: 각 PC의 Ollama 환경변수에 OLLAMA_HOST=0.0.0.0 설정이 되어 있어야 외부 접속이 가능합니다.

---

2. 단계별 확인 명령어 (Sanity Check)

설치 후 다음 명령어들로 각 파트가 살아있는지 꼭 확인하세요.

단계	명령어	기대 결과
Node 버전	node -v	v20.12.2 확인
노드 통신	curl http://[PC_IP]:11434/api/tags	각 노드의 모델 리스트 출력 확인
포트 점유	lsof -i :3000	OpenClaw 기본 포트 충돌 여부 확인
로그 확인	tail -f logs/app.log	실시간 에러 발생 여부 감시

---

3. OpenClaw 주입용 시스템 스크립트 (에이전트 가이드)

설치 완료 후, OpenClaw의 System Instruction 칸에 아래 내용을 그대로 복사해서 넣으세요. “말만 하고 실행 안 하는” 증상을 막는 강화 스크립트입니다.

Markdown

# Role: High-Performance Multi-Node Agent
당신은 M4 Pro(Main), RTX 3090(Node1), RTX 3080(Node2)으로 구성된 클러스터의 관리자입니다.

# Execution Rules:
1. **Thought-First**: 모든 응답 전에 반드시 <thought> 태그를 사용하여 실행 단계를 계획하라.
2. **Tool-Usage**: 파일을 수정하거나 코드를 실행할 때는 반드시 실제 도구를 호출하고 결과를 확인하라. 결과 확인 전에는 작업을 완료했다고 보고하지 마라.
3. **Data Safety**: NAS 및 Obsidian 데이터를 다룰 때는 원본을 직접 수정하기보다 복사본을 만들어 작업한 뒤 검토를 요청하라.
4. **Hardware Routing**:
   - 코딩/추론: Node1(3090) 활용 요청.
   - 단순 요약/분류: Node2(3080) 활용 요청.
   - 비전/대용량 문서: Main(M4 Pro) 활용 요청.

# Failure Handling:
- 에러 발생 시 즉시 중단하고, 에러 로그의 마지막 10줄을 분석하여 사용자에게 보고하라.
- 스스로 해결할 수 없는 권한 문제는 강제로 시도하지 마라.

---

4. 추가로 고려해야 할 안전장치 (추천)

1. 설정 파일 자동 백업 (크론탭)

맥미니 터미널에 crontab -e를 입력하고 다음 줄을 추가하세요. (매일 새벽 3시에 설정을 NAS로 복사)

Bash

0 3 * * * cp -R ~/openclaw/config /Volumes/Backup_NAS/OpenClaw_Config_Backup

2. 옵시디언 ‘샌드박스’ 폴더

에이전트가 직접 옵시디언 본진을 건드리지 못하게 하세요.

• Obsidian/Inbox 폴더를 만들고, 에이전트의 모든 출력물은 여기로만 들어가게 경로를 제한하는 것이 데이터 유실을 막는 가장 확실한 방법입니다.

---

💡 보너스 제안

위 가이드에 “복구 모드 매뉴얼” 섹션을 하나 더 추가하는 건 어떨까요?

예를 들어, “시스템이 멈췄을 때 PM2 restart all을 한다”나 “설정이 꼬였을 때 NAS에 있는 config.json을 다시 덮어씌운다” 같은 내용을 적어두면 훨씬 안심이 되실 겁니다.

이제 이 내용을 옵시디언에 넣고, 아주 천천히 [Step 1]부터 시작해 보세요. 이번에는 제가 옆에서 꼼꼼히 체크해 드릴게요! 시작하시겠어요?