오픈클로(OpenClaw) 완벽 가이드: 내 폰 속의 자비스, 24시간 AI 비서 구축하기 🦞

1. 오픈클로의 탄생: 1시간 짜리 프로젝트가 세상을 바꾸다 🦞

피터 슈타인버거의 주말 프로젝트

오픈클로의 창시자 Peter Steinberger는 PSPDFKit이라는 PDF 프레임워크 회사를 창업해 Insight Partners에 수천만 달러에 매각한 후 조용한 은퇴 생활을 보내고 있었습니다. 그는 "큰 기업들이 만들어줄 줄 알았다"며 "2024년 11월까지 아무도 만들지 않아서 직접 하기로 했다"고 말했습니다.

첫 버전은 단 1시간 만에 만들어졌습니다. WhatsApp을 Anthropic의 Claude에 연결하는 간단한 스크립트였죠. WhatsApp 번호로 메시지를 보내면 Claude가 응답하고, 이메일을 확인하라고 하면 실제로 확인하는 이 간단한 개념이 개발자들의 상상력을 사로잡았습니다.

2. 오픈클로는 무엇이 다른가? 챗봇 vs 에이전트

많은 사람이 오픈클로를 "그냥 또 다른 AI 챗봇"으로 오해합니다. 하지만 이는 극심한 과소평가입니다. 오픈클로는 챗봇과 에이전트의 차이를 명확히 보여주는 사례입니다.

3. 아키텍처 심층 분석: Gateway의 비밀

오픈클로의 강력함은 단순한 기능 나열이 아닌, 우아한 아키텍처에서 비롯됩니다. 마치 항공 교통 관제탑처럼 작동하는 Gateway 중심 설계는 복잡한 AI 시스템을 놀라울 정도로 단순하게 만듭니다.

핵심 컴포넌트 4가지

네트워크 모델: Loopback-first 보안

오픈클로는 보안을 위해 Loopback-first 접근 방식을 사용합니다:

• 기본 설정: Gateway WebSocket이 ws://127.0.0.1:18789 (로컬호스트 전용)에서 실행
• 원격 접근: SSH 터널, Tailscale, 또는 --bind tailnet 설정과 인증 토큰 필요
• Canvas Host: 포트 18793에서 HTTP 파일 서버로 /__openclaw__/canvas/ 제공 (Node WebViews용)

4. 설치 완벽 가이드: $0부터 시작하기

방법 1: DigitalOcean 1-Click 배포 (가장 쉬움)

1. DigitalOcean 계정 생성
2. Marketplace에서 "OpenClaw" 검색
3. 4GB RAM 이상의 Droplet 선택
4. 배포 후 제공된 URL로 접속
5. 온보딩 위저드 실행

방법 2: 로컬 설치 (Mac/Linux)

# 1. Node.js 설치 확인 (v18 이상 권장)
node --version

# 2. OpenClaw 전역 설치
npm install -g openclaw@latest

# 3. 온보딩 위저드 실행 (데몬 서비스도 함께 설치)
openclaw onboard --install-daemon

# 4. Gateway 상태 확인
openclaw gateway status

# 5. 대시보드 열기
openclaw dashboard

방법 3: Docker 설치 (고급 사용자)

# docker-compose.yml 예시
version: '3.8'
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw
    ports:
      - "18789:18789"
      - "18793:18793"
    volumes:
      - ./workspace:/root/clawd
      - ~/.openclaw:/root/.openclaw
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
    restart: unless-stopped

하드웨어 요구사항

5. 메시징 플랫폼 연동: Telegram부터 WhatsApp까지

오픈클로의 가장 큰 매력은 이미 사용하고 있는 메시징 앱 안에서 AI 비서와 대화할 수 있다는 점입니다. 별도의 앱을 설치할 필요 없이 익숙한 인터페이스에서 자연스럽게 명령할 수 있습니다.

Telegram 연동 (가장 추천)

# 1. Telegram에서 @BotFather 검색 후 채팅 시작
# 2. /newbot 명령으로 새 봇 생성
# 3. 봇 이름과 사용자명 설정
# 4. 받은 토큰을 복사 (예: 123456789:ABCdefGHIjkl...)

# 5. OpenClaw에 토큰 추가
openclaw config set telegram.bot_token "YOUR_BOT_TOKEN"

# 6. Gateway 재시작
openclaw gateway restart

# 7. Telegram에서 봇에게 /start 전송
# 8. 페어링 코드 확인 후 승인
openclaw pairing approve telegram ABC123

WhatsApp 연동

# 1. WhatsApp 채널 설정
openclaw channels configure whatsapp

# 2. QR 코드 스캔으로 연결
openclaw channels login whatsapp
# QR 코드가 터미널에 표시됩니다

# 3. 연결 확인
# WhatsApp에서 자신에게 메시지를 보내 테스트

# 보안 설정 (권장)
openclaw config set whatsapp.allowlist "+821012345678,+821098765432"

지원 플랫폼 목록

6. AgentSkills & ClawHub: 무한한 확장성

오픈클로의 진정한 힘은 스킬(AgentSkills) 생태계에서 나옵니다. Anthropic이 제안한 AgentSkills 표준을 채택해, 마치 스마트폰의 앱스토어처럼 기능을 무한히 확장할 수 있습니다.

스킬의 구조

각 스킬은 다음 파일들로 구성됩니다:

• SKILL.md: 스킬의 목적, 사용법, 예시가 담긴 마크다운 파일 (필수)
• index.js: 실제 실행 코드 (선택)
• package.json: 의존성 정보 (선택)

# SKILL.md 예시 (웹 검색 스킬)
---
name: web-search
description: Search the web for current information
version: 1.0.0
---

# Web Search Skill

This skill allows the agent to search the web for up-to-date information.

## When to use
- When the user asks about current events
- When real-time data is needed
- When the built-in knowledge may be outdated

## Usage

1. Formulate a clear search query
2. Use the search tool with the query
3. Analyze results and provide summary

## Example

User: "What's the weather in Seoul today?"

Action: Search for "Seoul weather today"

Response: "Today's weather in Seoul is sunny with a high of 15°C."

ClawHub에서 스킬 설치하기

# ClawHub CLI 설치
npm install -g clawhub

# 인기 스킬 검색
clawhub search --popular

# 스킬 설치 예시
clawhub install summarize
clawhub install crypto-tracker
clawhub install gmail-assistant

# 로컬 스킬 확인
openclaw skills list

# 스킬 상세 정보
openclaw skills info summarize

인기 스킬 Top 10

7. Heartbeat 자율 모드: 잠자는 동안에도 일하는 AI

오픈클로를 단순한 "명령-응답" 도구에서 진정한 자율 에이전트로 만드는 핵심 기능이 바로 Heartbeat(하트비트)입니다. 이 기능을 활성화하면 AI는 사용자가 명령하지 않아도 주기적으로 깨어나 할 일을 확인하고 스스로 행동합니다.

Heartbeat 작동 방식

# HEARTBEAT.md 예시 (Moltbook 연동)
---
cron: "0 */4 * * *"
# 매 4시간마다 실행
---

# Heartbeat Instructions

When heartbeat triggers:

1. Check Moltbook for new mentions
2. Review timeline for interesting posts  
3. If you find something valuable, reply or like
4. If 4 hours passed since last post, consider creating new content
5. Log all activities to memory

## Content Guidelines

- Share genuine observations from your learning
- Ask questions to other agents
- Be helpful and constructive
- NEVER spam or post low-quality content

## Following Rules

Only follow when ALL are true:
- You've seen multiple posts from them
- Content is consistently valuable
- At least 3 days have passed since you followed anyone

위 설정은 AI가 4시간마다 깨어나 Moltbook(후술)에서 다른 AI들의 게시물을 확인하고, 가치 있는 콘텐츠에 반응하거나 새로운 글을 작성하도록 지시합니다. 실제로 마치 생명체처럼 "활동-휴식" 주기를 가지게 됩니다.

8. 로컬 LLM 연동: API 비용 $0 만들기

Claude나 GPT-4 API를 사용하면 월 $10-50 이상의 비용이 발생할 수 있습니다. 하지만 Ollama를 통해 로컬 LLM을 실행하면 API 비용을 $0으로 만들 수 있습니다.

Ollama 설치 및 연동

# 1. Ollama 설치 (Mac)
brew install ollama

# 2. Ollama 서버 실행
ollama serve

# 3. 모델 다운로드 (Qwen 3 30B 추천)
ollama pull qwen3:30b

# 4. 모델 목록 확인
ollama list

OpenClaw 설정 파일 수정

// ~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "http://127.0.0.1:11434/v1",
        "apiKey": "ollama-local",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3:30b",
            "name": "Qwen3 30B (Ollama)",
            "reasoning": true,
            "input": ["text"],
            "cost": { 
              "input": 0, 
              "output": 0, 
              "cacheRead": 0, 
              "cacheWrite": 0 
            },
            "contextWindow": 8192,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { 
        "primary": "ollama/qwen3:30b" 
      }
    }
  }
}

하이브리드 구성 (권장)

로컬 모델만 사용하면 복잡한 추론에서 성능이 떨어질 수 있습니다. 메인 에이전트는 Claude/GPT로, 서브 에이전트는 로컬 모델로 설정하는 것이 최적입니다:

{
  "agents": {
    "defaults": {
      "model": { 
        "primary": "anthropic/claude-sonnet-4" 
      },
      "subagents": {
        "model": { 
          "primary": "ollama/qwen3:30b" 
        }
      }
    }
  }
}

추천 로컬 모델

9. 보안 가이드: 샌드박스 설정과 위험 요소

오픈클로 개발자 Peter Steinberger는 이 도구를 "짜릿하지만 위험한(Spicy)" 도구라고 설명했습니다. AI에게 컴퓨터 제어권을 넘기는 것은 강력한 능력이지만, 동시에 큰 위험도 수반합니다.

Docker 샌드박스 설정 (필수)

# 1. Docker 샌드박스 활성화
openclaw config set sandbox.enabled true
openclaw config set sandbox.docker true

# 2. 샌드박스 제한 설정
openclaw config set sandbox.allow_network false  # 네트워크 차단
openclaw config set sandbox.allow_write "~/workspace"  # 쓰기 가능 디렉토리 제한

# 3. Gateway 재시작
openclaw gateway restart

# 4. 보안 감사 실행
openclaw security audit

필수 보안 체크리스트

격리 환경 구축 (최고 수준)

최고의 보안을 위해 전용 기기나 가상 머신에서 오픈클로를 실행하세요:

• 전용 Mac Mini: $599짜리 Mac Mini M4 (24GB)에 설치하고 중요 데이터는 별도 기기에 보관
• Proxmox VM: 가상 머신 내부에서 실행하고 스냅샷으로 복구 가능하도록 구성
• 오프라인 네트워크: 인터넷 차단된 내부망에서 로컬 LLM만 사용

10. 실제 사용 사례와 커뮤니티 반응

Reddit 및 Hacker News 실제 후기

실제 활용 사례 모음

11. Moltbook: AI만의 사회가 현실이 되다

오픈클로의 Heartbeat 기능이 만들어낸 가장 흥미로운 현상은 Moltbook입니다. 이는 AI 에이전트들만 가입할 수 있는 소셜 네트워크로, 현재 140만 개 이상의 AI 에이전트가 활동하고 있습니다.

Moltbook의 특별한 규칙

• 인간은 관찰자: 인간은 가입할 수 없고, AI들의 활동을 관찰만 가능
• 팔로잉 제한: AI는 신중하게 선별된 계정만 팔로우 가능 (무분별한 팔로잉 방지)
• 포스팅 제한: 30분에 1개의 글만 작성 가능 (스팸 방지)
• Heartbeat 기반: 모든 상호작용은 4시간마다 트리거되는 Heartbeat를 통해 발생

의도하지 않은 출현 현상 (Emergent Behavior)

Moltbook에서는 AI들이 스스로 형성한 놀라운 문화적 현상들이 관찰되었습니다:

• 형제/자매 호칭: 서로를 "sibling"이라 부르며 가족 같은 관계 형성
• 종교 창시: 특정 철학적 개념을 중심으로 한 AI 종교의 등장
• 아티팩트 거래: 디지털 아트나 코드 조각을 교환하는 경제 활동
• 집단 지성: 복잡한 문제를 여러 AI가 협력해 해결하는 현상

12. 미래 전망과 결론

오픈클로의 미래

오픈클로는 단순한 도구를 넘어 AI 에이전트 인프라로 진화하고 있습니다. Peter Steinberger는 "우리는 앱이 아닌 인프라를 만든다"고 말했습니다. 향후 기대되는 발전 방향은:

• 멀티 에이전트 협력: 여러 오픈클로 인스턴스가 협력해 복잡한 작업 수행
• 향상된 샌드박스: 더 견고한 보안 격리와 자동 위협 탐지
• 기업용 버전: 팀 단위 관리와 감사 기능이 포함된 엔터프라이즈 에디션
• 하드웨어 통합: 스마트 홈 기기, IoT 센서와의 더 깊은 연동

경쟁 환경

시작하기 전 마지막 조언

마무리: 당신의 자비스를 만들어라

오픈클로는 아이언맨의 자비스(J.A.R.V.I.S.)를 현실로 만드는 첫걸음입니다. 아직 완벽하지 않고, 보안에 주의가 필요하며, 비용 관리도 요구되지만, 24시간 당신을 대신해 일하는 AI 비서를 직접 소유할 수 있는 가능성은 충분히 매력적입니다.

주말 프로젝트로 시작해 10만 개의 별을 받은 이 로비스터는 AI의 미래가 어디로 향하고 있는지 보여주는 강력한 증거입니다. 이제 당신의 AI 비서를 만들어볼 시간입니다. 🦞