OpenClaw 설치방법 완벽 가이드 (맥미니 개인서버부터 모바일·PC 연동, 텔레그램 연동까지) 구 MoltBot/ClawdBot

📌 목차

1. OpenClaw란 무엇인가?
2. 설치 전 준비물
3. 맥미니로 개인서버 구축하기
4. 모바일·PC 프로그램 설치 방법
5. 설치 후 텔레그램 연동 방법
6. 자주 발생하는 오류 및 해결법
7. 보안 및 안정성 관리 팁
8. 마무리 정리

---

1️⃣ OpenClaw란 무엇인가?

OpenClaw는 개인 서버 기반으로 운영할 수 있는 자동화·모니터링·데이터 관리 플랫폼입니다.
주로 다음과 같은 용도로 활용됩니다.

• 자동 알림 시스템 구축
• 데이터 수집 및 분석
• 원격 서버 관리
• 개인 업무 자동화
• API 기반 확장 기능 활용

특히 클라우드 서비스에 의존하지 않고 개인 서버 환경에서 직접 운영할 수 있다는 점이 가장 큰 장점입니다.

최근에는 맥미니(Mac Mini)를 이용해 저전력 홈서버로 구축하는 사례가 늘어나면서 OpenClaw 활용도도 빠르게 증가하고 있습니다.

---

2️⃣ 설치 전 준비물

본격적인 설치에 앞서 아래 항목들을 반드시 준비해야 합니다.

✅ 하드웨어 준비물

항목권장 사양

맥미니	M1 이상 / RAM 8GB 이상
저장공간	최소 256GB SSD
인터넷	유선 LAN 권장
전원	UPS 권장(선택)

※ 24시간 서버 운영을 고려하면 안정적인 전원 환경이 중요합니다.

---

✅ 소프트웨어 준비물

• macOS 최신 버전
• 터미널(Terminal)
• Homebrew
• Docker
• Git
• Python 3.9 이상

---

✅ 계정 및 서비스 준비

• GitHub 계정
• Telegram 계정
• Telegram Bot 생성용 BotFather
• 공인 IP 또는 포트포워딩 설정

---

✅ 네트워크 환경 확인

개인 서버 운영 시 다음 조건을 만족해야 합니다.

• 외부 접속 가능 여부
• 공유기 포트포워딩 가능 여부
• 방화벽 설정 확인

---

3️⃣ 맥미니로 개인서버 설치 방법

이 단계는 OpenClaw 운영의 핵심입니다.

---

3-1. Homebrew 설치

터미널 실행 후 입력합니다.

 

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치 확인:

 

brew --version

---

3-2. 필수 패키지 설치

 

brew install git python docker docker-compose

---

3-3. Docker 실행 설정

Docker Desktop 설치 후 자동 실행 설정

 

open /Applications/Docker.app

부팅 시 자동 실행 권장

---

3-4. OpenClaw 소스 다운로드

 

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

※ 실제 주소는 공식 저장소 기준으로 확인하세요.

---

3-5. 환경설정 파일 생성

 

cp .env.example .env nano .env

주요 항목 수정:

 

SERVER_PORT=8080 DB_PASSWORD=strongpassword API_KEY=your_api_key

보안을 위해 복잡한 비밀번호 사용 권장

---

3-6. Docker 컨테이너 실행

 

docker-compose up -d

실행 확인:

 

docker ps

---

3-7. 외부 접속 설정 (포트포워딩)

공유기 관리자 페이지 접속

예시:

 

192.168.0.1

포트 설정:

항목값

내부 IP	맥미니 IP
내부 포트	8080
외부 포트	8080
프로토콜	TCP

---

3-8. 서버 접속 테스트

브라우저에서:

 

http://공인IP:8080

접속 성공 시 관리자 화면 표시

---

4️⃣ 모바일·PC 프로그램 설치

---

4-1. PC 프로그램 설치

Windows / macOS

1. 공식 사이트 접속
2. 클라이언트 다운로드
3. 설치 진행
4. 서버 주소 입력

설정 예시:

 

Server: http://123.45.xxx.xxx:8080 Token: 개인 API 토큰

---

4-2. 모바일 앱 설치

Android

• Google Play → OpenClaw 검색

iOS

• App Store → OpenClaw 검색

---

모바일 설정 방법

1. 앱 실행
2. 서버 추가
3. 서버 주소 입력
4. 계정 로그인
5. 연동 완료

---

4-3. 계정 동기화

PC·모바일 간 자동 동기화를 위해:

 

Settings → Sync → Enable Cloud Sync

활성화 권장

---

5️⃣ 프로그램 설치 후 텔레그램 연동 방법

텔레그램 연동은 알림 자동화를 위해 매우 중요합니다.

---

5-1. 텔레그램 봇 생성

1. Telegram 검색 → BotFather
2. /start 입력
3. /newbot 입력
4. 봇 이름 설정
5. API Token 발급

예시:

 

123456789:ABCDEF123456

---

5-2. 채팅 ID 확인

봇과 대화 후:

 

https://api.telegram.org/bot토큰/getUpdates

브라우저 접속 → chat_id 확인

---

5-3. OpenClaw에 연동 설정

.env 파일 수정

 

TELEGRAM_TOKEN=123456789:ABCDEF TELEGRAM_CHAT_ID=987654321

---

5-4. 서버 재시작

 

docker-compose restart

---

5-5. 테스트 메시지 전송

 

docker exec openclaw python test_telegram.py

정상 작동 시 메시지 도착

---

6️⃣ 자주 발생하는 오류 및 해결법

---

❌ 포트 접속 불가

원인:

• 포트포워딩 미설정
• 방화벽 차단

해결:

 

sudo pfctl -d

또는 공유기 설정 확인

---

❌ Docker 실행 오류

 

docker-compose down docker-compose up -d --build

---

❌ 텔레그램 알림 안 옴

• Token 오타
• Chat ID 오류
• 서버 재시작 누락

---

❌ 서버 느림 현상

원인:

• 메모리 부족
• 로그 파일 과다

해결:

 

docker system prune

---

7️⃣ 보안 및 안정성 관리 팁

---

🔐 1. 방화벽 설정

 

sudo ufw enable sudo ufw allow 8080

---

🔐 2. 관리자 비밀번호 강화

• 12자 이상
• 특수문자 포함
• 주기적 변경

---

🔐 3. SSL 적용 (권장)

Let's Encrypt 사용 추천

 

certbot --nginx

---

🔐 4. 자동 백업 설정

 

crontab -e

 

0 3 * * * /backup/script.sh

---

🔐 5. 로그 관리

 

logrotate

활용 권장

---

8️⃣ 마무리 정리

 

지금까지 OpenClaw를 맥미니 개인 서버 환경에 설치하고, 모바일·PC 연동 및 텔레그램 알림까지 설정하는 전 과정을 살펴보았습니다.

✅ 핵심 요약

단계핵심 내용

준비물	하드웨어·소프트웨어·계정
서버 구축	Docker 기반 운영
클라이언트	PC·모바일 연동
알림	텔레그램 봇 연동
관리	보안·백업·최적화

---

📌 OpenClaw 개인서버 운영의 장점

✔ 클라우드 비용 절감
✔ 데이터 완전 통제
✔ 높은 확장성
✔ 자동화 시스템 구축 가능
✔ 24시간 안정 운영

---

OpenClaw는 제대로 구축해 두면 개인 업무 자동화, 데이터 관리, 알림 시스템 구축에 매우 강력한 도구가 됩니다.

특히 맥미니 기반 서버는 전력 효율이 높고 안정성이 뛰어나 장기 운영에 최적화된 환경입니다.