당신이 구축하게 될 것
이 가이드를 마칠 때쯤, 당신은 다음과 같이 작동하는 OpenClaw 인스턴스를 갖게 될 것입니다:
- WhatsApp, Telegram 또는 선호하는 채팅 앱에서 당신에게 응답합니다
- 당신이 선택한 AI 모델(Claude, GPT, DeepSeek 또는 무료 로컬 모델)을 사용합니다
- 이메일 요약, 파일 관리 또는 웹 리서치 등 적어도 하나 이상의 실제 워크플로우를 자동화합니다
- 적절한 보안 강화 설정을 통해 Docker에서 안정적으로 실행됩니다
이것은 단순한 기능 개요가 아닙니다. 직접 따라 하며 구축하는 가이드입니다.
OpenClaw: 제로에서 시작하는 작동하는 개인용 AI 에이전트 구축하기
OpenClaw는 March 2026 초에 247,000 GitHub stars를 돌파한 셀프 호스팅 오픈 소스 개인용 AI 어시스턴트입니다. 이 숫자가 중요한 이유는 그것이 상징하는 바 때문입니다. 수십만 명의 개발자들이 클라우드 챗봇만으로는 충분하지 않다고 결정했습니다. 그들은 자신을 대신해 실제로 무언가를 할 수 있는 AI를 원합니다.
오스트리아 개발자 Peter Steinberger가 제작하여 November 2025에 Clawdbot이라는 이름으로 처음 공개된 이 프로젝트는 두 번의 이름 변경을 거쳤습니다. 먼저 Anthropic과의 상표권 문제로 Moltbot으로 변경되었고, 3일 후 OpenClaw로 변경되어 현재의 이름으로 자리 잡았습니다. 바닷가재 이모지(🦞)가 마스코트가 되었고, "The lobster way"라는 슬로건은 셀프 호스팅 AI 운동의 구호가 되었습니다.
OpenClaw가 ChatGPT, Claude 또는 다른 클라우드 챗봇과 다른 점은 간단합니다. 당신의 머신에서 실행되고, 당신의 채팅 앱에 연결되며, 실제 세계에서 행동을 취한다는 점입니다. 이메일을 읽고, 브라우저를 제어하고, 파일을 관리하고, shell 명령을 실행하며, 다단계 워크플로우를 자동화합니다. 이 모든 것이 당신이 이미 사용 중인 플랫폼의 텍스트 메시지로 트리거됩니다.
이제 구축해 봅시다.
Part 1: 설치 및 첫 실행
시스템 요구 사항
OpenClaw는 가볍습니다. 다음이 필요합니다:
- Node.js 24 (권장) 또는 Node.js 22.16+
- 2GB RAM 최소 (로컬 모델을 함께 실행할 경우 8GB+ 권장)
- macOS, Linux, 또는 Windows (Windows의 경우 WSL2 권장)
- 20GB 디스크 공간 (기본 설치 및 모델 캐시용)
OpenClaw 설치
가장 빠른 방법은 global npm 설치입니다:
# OpenClaw를 전역으로 설치
npm install -g openclaw@latest
# 또는 pnpm을 선호하는 경우
pnpm add -g openclaw@latest
설치 확인:
openclaw --version
# 예상 출력: openclaw v0.x.x
온보딩 마법사 실행
OpenClaw는 첫 번째 채팅 플랫폼과 AI 제공업체를 연결하는 과정을 안내하는 대화형 온보딩 명령어를 제공합니다:
openclaw onboard --install-daemon
--install-daemon 플래그는 Gateway를 부팅 시 자동으로 시작되는 백그라운드 서비스로 설치합니다. 이것은 계속 실행되면서 채팅 앱과 AI 에이전트 사이의 메시지를 라우팅하는 핵심 프로세스입니다.
출처: OpenClaw GitHub Repository
마법사는 세 가지 질문을 합니다:
- 어떤 채팅 플랫폼을 사용하시겠습니까? — 시작할 플랫폼 하나를 선택하세요 (처음 사용하시는 분들께는 Telegram을 추천합니다)
- 어떤 AI 제공업체를 사용하시겠습니까? — Claude, GPT, DeepSeek의 API key를 입력하거나 Ollama를 구성하세요
- 어시스턴트의 이름은 무엇입니까? — 이 이름은 채팅 앱의 표시 이름이 됩니다
온보딩이 완료되면 Gateway가 시작되고 어시스턴트가 활성화됩니다.
Part 2: 채팅 플랫폼 연결
OpenClaw는 20 messaging platforms 이상의 메시징 플랫폼을 지원하며, 이는 다른 어떤 AI 어시스턴트 프레임워크보다 많은 수치입니다. 가장 인기 있는 플랫폼들을 연결하는 방법은 다음과 같습니다.
Telegram (가장 쉬운 설정)
Telegram은 가장 성숙한 OpenClaw 통합 기능을 제공하며 커뮤니티에서 초보자에게 권장하는 방식입니다.
- Telegram을 열고 @BotFather에게 메시지를 보냅니다
/newbot을 전송하고 안내에 따라 봇을 생성합니다- BotFather가 제공하는 봇 토큰을 복사합니다
- OpenClaw 설정에 토큰을 추가합니다:
# ~/.openclaw/config.yaml
channels:
telegram:
enabled: true
botToken: "YOUR_TELEGRAM_BOT_TOKEN"
allowedUsers:
- your_telegram_username
- Gateway 재시작:
openclaw gateway restart
Telegram에서 봇에게 메시지를 보내면 즉시 응답할 것입니다.
출처: OpenClaw Personal Assistant Setup
WhatsApp 통합은 WhatsApp Web 프로토콜을 사용합니다. 완벽하게 작동하지만 전용 전화번호가 필요합니다. 기본 WhatsApp 계정은 사용하지 마세요.
openclaw onboard --channel whatsapp
CLI가 터미널에 직접 QR 코드를 표시합니다. 휴대폰에서:
- WhatsApp 열기 → 설정 → 연결된 기기 → 기기 연결
- 터미널의 QR 코드를 스캔합니다
이제 WhatsApp을 통해 OpenClaw 인스턴스에 액세스할 수 있습니다. 해당 연결된 세션으로 보내는 모든 메시지는 에이전트에게 전달됩니다.
중요: 어시스턴트 전용 번호를 사용하세요. OpenClaw가 이 계정의 메시지를 읽고 응답하게 되므로, 개인 채팅과 에이전트를 분리하는 것이 좋습니다.
출처: OpenClaw WhatsApp Setup Guide
Discord
# ~/.openclaw/config.yaml
channels:
discord:
enabled: true
botToken: "YOUR_DISCORD_BOT_TOKEN"
allowedGuilds:
- "your_server_id"
discord.com/developers에서 Discord 애플리케이션을 만들고, 봇을 추가한 후 토큰을 복사하세요. OpenClaw는 봇이 멘션된 모든 채널에서 응답합니다.
Slack
channels:
slack:
enabled: true
appToken: "xapp-..."
botToken: "xoxb-..."
Slack은 앱 수준 토큰과 봇 토큰이 모두 필요합니다. api.slack.com/apps에서 Socket Mode가 활성화된 Slack 앱을 만드세요.
기타 지원 플랫폼
OpenClaw는 Google Chat, Signal, iMessage (macOS 전용), Microsoft Teams, Matrix, IRC, LINE, Mattermost, Nextcloud Talk, Feishu, Nostr, Synology Chat, WeChat 등을 지원합니다. 각 플랫폼은 유사한 패턴을 따릅니다. 플랫폼에서 봇/토큰을 생성하고, config.yaml에 자격 증명을 추가한 후 Gateway를 재시작하면 됩니다.
Part 3: AI 모델 선택 및 구성
이 부분이 OpenClaw가 흥미로워지는 지점입니다. 특정 제품에 종속되는 것과 달리, 당신은 어시스턴트의 두뇌를 직접 선택할 수 있으며 모델을 즉석에서 교체하거나 자동 폴백 체인을 설정할 수 있습니다.
옵션 A: Claude (Anthropic)
Claude는 복잡한 추론과 긴 대화를 위해 OpenClaw 사용자들이 가장 많이 선택하는 모델입니다.
# ~/.openclaw/config.yaml
providers:
anthropic:
apiKey: "${ANTHROPIC_API_KEY}"
agents:
primary:
model: "anthropic/claude-sonnet-4-6"
contextTokens: 200000
thinkingEnabled: true
API key 설정:
export ANTHROPIC_API_KEY="sk-ant-..."
출처: OpenClaw Model Configuration Guide
옵션 B: GPT (OpenAI)
providers:
openai:
apiKey: "${OPENAI_API_KEY}"
baseUrl: "https://api.openai.com/v1"
agents:
primary:
model: "openai/gpt-4.1"
옵션 C: DeepSeek (가성비 클라우드)
DeepSeek는 Claude나 GPT 가격의 일부만으로 강력한 성능을 제공하여 대량의 자동화 작업에 인기가 많습니다.
providers:
openai-compatible:
apiKey: "${DEEPSEEK_API_KEY}"
baseUrl: "https://api.deepseek.com/v1"
agents:
primary:
model: "openai-compatible/deepseek-chat"
옵션 D: Ollama (무료, 완전 로컬, 완전 프라이빗)
비용이 전혀 들지 않는 옵션입니다. Ollama는 당신의 머신에서 직접 오픈 소스 모델을 실행하므로 API key나 인터넷 연결이 필요 없고 데이터가 기기를 벗어나지 않습니다.
먼저 Ollama를 설치하고 모델을 불러옵니다:
# Ollama 설치
curl -fsSL https://ollama.com/install.sh | sh
# 모델 불러오기 (Llama 3 8B가 좋은 시작점입니다)
ollama pull llama3:8b
# 더 강력한 추론을 원하는 경우
ollama pull deepseek-r1:14b
그런 다음 OpenClaw를 구성합니다:
providers:
ollama:
baseUrl: "http://127.0.0.1:11434/v1"
apiKey: "ollama-local"
api: "ollama"
agents:
primary:
model: "ollama/llama3:8b"
contextWindow: 8192
maxTokens: 4096
참고: baseUrl에는 반드시 /v1 접미사가 포함되어야 합니다. 이는 새로운 사용자들이 가장 흔히 저지르는 설정 실수 중 하나입니다.
출처: Using OpenClaw with Ollama — DataCamp
다중 모델 폴백 체인
OpenClaw의 가장 강력한 기능 중 하나는 폴백 체인을 정의하는 기능입니다. 에이전트는 먼저 기본 모델을 시도하고, 실패할 경우(속도 제한, 타임아웃, 중단 등) 자동으로 다음 모델로 넘어갑니다:
agents:
primary:
model: "openai-compatible/deepseek-chat"
fallback:
- model: "anthropic/claude-sonnet-4-6"
- model: "ollama/llama3:8b"
이 구성은 대부분의 상호작용에는 DeepSeek를 사용하고(가장 저렴함), 복잡한 작업에는 Claude로 전환하며, 두 클라우드 제공업체를 모두 사용할 수 없는 경우에는 로컬 Ollama 모델을 사용합니다. 단일 설정을 통해 비용 최적화, 신뢰성, 오프라인 기능을 모두 얻을 수 있습니다.
출처: OpenClaw API & Model Configuration
Part 4: OpenClaw가 실제로 할 수 있는 일
OpenClaw가 "AI 에이전트"라는 말은 추상적입니다. 여기 오늘 바로 시도해 볼 수 있는 구체적인 예시들이 있습니다.
브라우저 제어
OpenClaw는 브라우저를 열고, 페이지를 탐색하고, 양식을 채우고, 버튼을 클릭하고, 데이터를 추출하고, 스크린샷을 찍을 수 있습니다. 이 모든 것이 채팅 메시지로 가능합니다.
사용자 (Telegram): "아마존으로 가서 100달러 미만의 가장 평점이 좋은 기계식 키보드를 찾아줘"
OpenClaw는 headless 브라우저를 열고, 아마존으로 이동하여 검색하고, 평점과 가격으로 필터링한 후 링크가 포함된 형식화된 목록을 반환합니다. 내부적으로 신뢰성 있는 브라우저 자동화를 위해 Playwright를 사용합니다.
더 강력한 변형은 Live Browser Control입니다. 이는 당신이 로그인한 계정, 쿠키, 탭이 그대로 유지된 기존 Chrome 세션에 연결됩니다. 즉, OpenClaw가 별도의 자격 증명 없이도 당신의 이메일, 뱅킹 대시보드 또는 사내 도구와 같은 인증된 서비스와 상호작용할 수 있음을 의미합니다.
출처: OpenClaw Live Browser Control — Goldie Agency
이메일 관리
가장 영향력이 큰 자동화 중 하나입니다. OpenClaw를 Gmail이나 Outlook에 연결하면 다음과 같은 일이 가능합니다:
- 매일 아침 읽지 않은 편지함을 요약하여 Telegram으로 브리핑 전송
- 대화 맥락에 기반한 답장 초안 작성
- 정의한 규칙에 따라 메시지 보관, 라벨링 또는 플래그 표시
- 캘린더 관련 이메일을 식별하고 자동으로 일정 관리
사용자 (WhatsApp): "내 편지함을 요약하고 급한 건은 플래그 표시해 줘"
파일 및 시스템 작업
OpenClaw는 파일을 읽고, 쓰고, 이동하고, 삭제할 수 있습니다. shell 명령을 실행할 수 있습니다. 샌드박스 환경에서 코드를 실행할 수도 있습니다.
사용자 (Slack): "이번 달 다운로드 폴더에서 모든 PDF 영수증을 찾아서, 업체 이름과 날짜로 파일명을 바꾸고 ~/Documents/Invoices/2026-03/ 폴더로 이동시켜 줘"
에이전트는 각 PDF를 읽고, 업체 이름과 날짜를 추출한 후 파일명을 변경하고 이동시킵니다. 이러한 다단계 파일 작업은 OpenClaw가 실제 시간을 절약해 주는 부분입니다.
캘린더 및 일정 관리
OpenClaw는 캘린더를 모니터링하고, 일정 충돌을 처리하며, 회의 물류를 관리합니다:
사용자 (Telegram): "누군가 회의 일정 변경에 대해 이메일을 보내면, 내 예약 가능 여부를 확인하고 이벤트를 업데이트한 뒤 확인 메시지를 보내줘"
이것은 가설이 아니라 가장 흔히 배포되는 OpenClaw 자동화 중 하나입니다.
콘텐츠 및 소셜 미디어
가장 널리 채택되는 유스케이스 카테고리입니다. OpenClaw 사용자들은 블로그 RSS 피드를 연결하여 에이전트가 X, LinkedIn 및 뉴스레터용 플랫폼별 포스트를 자동으로 생성하게 합니다. 한 사용자는 소셜 미디어 콘텐츠 작업에서만 주당 10시간 이상을 절약했다고 보고했습니다.
리서치 및 경쟁사 인텔리전스
웹사이트에서 제품 변경, 가격 업데이트 및 뉴스를 스크랩하는 주간 경쟁사 모니터링을 설정하면, OpenClaw가 모든 정보를 구조화된 보고서로 정리하여 선호하는 채널로 전달합니다.
출처: Advanced OpenClaw Workflows — LightNode
Part 5: 커스텀 Skills 구축
Skills는 OpenClaw의 확장 메커니즘으로, 에이전트에게 새로운 능력을 가르치는 Markdown 파일입니다. ClawHub registry에는 수천 개의 커뮤니티 기여 Skills가 있으며, 자신만의 Skills를 만드는 데는 몇 분이면 충분합니다.
Skills 작동 방식
각 Skill은 메타데이터, 의존성, 필요한 도구를 선언하는 YAML frontmatter와 에이전트가 무엇을 어떻게 해야 하는지 알려주는 자연어 지침이 담긴 skill.md 파일이 포함된 디렉토리입니다.
출처: OpenClaw Skills Documentation
커뮤니티 Skills 설치
# 사용 가능한 Skills 검색
openclaw skills search "email"
# Skill 설치
openclaw skills install email-summarizer
# 설치된 Skills 목록 확인
openclaw skills list
awesome-openclaw-skills 저장소는 공식 레지스트리에서 필터링 및 분류된 5,400개 이상의 Skills를 카탈로그화하여 제공합니다.
커스텀 Skill 생성
다음은 당신이 관심을 갖는 주제에 대해 Hacker News를 모니터링하는 간단한 Skill입니다:
mkdir -p ~/.openclaw/skills/hn-monitor
~/.openclaw/skills/hn-monitor/skill.md 파일을 생성합니다:
---
name: hn-monitor
description: 지정된 주제에 대해 Hacker News를 모니터링하고 일일 요약을 전송합니다
triggers:
- schedule: "0 9 * * *" # 매일 오전 9시
requires:
tools:
- browser
- messaging
---
# Hacker News 모니터
## 지침
1. https://news.ycombinator.com 접속
2. 첫 30개의 스토리에서 다음 주제 중 하나라도 포함된 것이 있는지 스캔: {{topics}}
3. 일치하는 각 스토리에 대해 제목, URL, 포인트, 댓글 수를 추출
4. 가장 관련성 높은 스토리가 먼저 오도록 결과를 깔끔한 요약 형식으로 구성
5. 사용자의 기본 채널을 통해 요약을 전송
## 출력 형식
**🦞 HN 일일 요약 — {{date}}**
각 스토리별:
- **제목** (포인트 | 댓글)
링크: url
일치 이유: 간단한 설명
일치하는 스토리가 없으면 "오늘 HN에는 관련 주제가 없습니다."라고 전송하세요.
이 Skill은 다음 Gateway 재시작 시 자동으로 로드되며 정의된 일정에 따라 실행됩니다.
출처: What Are OpenClaw Skills — DigitalOcean
플러그인 아키텍처
Skills 외에도 OpenClaw는 소스 코드를 수정하지 않고 핵심 시스템을 확장하는 네 가지 유형의 플러그인을 지원합니다:
- Channel plugins — 새로운 메시징 플랫폼 추가
- Memory plugins — 대체 스토리지 백엔드로 교체
- Tool plugins — 커스텀 기능 추가 (API, 하드웨어 제어, 특수 처리)
- Provider plugins — 커스텀 또는 셀프 호스팅 LLM 제공업체 통합
플러그인 로더는 package.json에서 openclaw.extensions 필드를 스캔하고, 선언된 스키마에 대해 유효성을 검사한 후 설정이 존재할 때 hot-load합니다.
출처: Deep Dive into OpenClaw Architecture — Medium
Part 6: Docker를 이용한 프로덕션 배포
노트북에서 OpenClaw를 실행하는 것은 테스트용으로 적합합니다. 안정적이고 항상 켜져 있는 어시스턴트를 원한다면 VPS의 Docker에 배포하세요.
왜 Docker인가?
Docker는 OpenClaw를 호스트 시스템으로부터 격리하고, 환경 간에 일관된 동작을 제공하며, 업데이트를 간편하게 만듭니다. 이는 권장되는 프로덕션 배포 방법입니다.
최소 VPS 사양
- 1 vCPU, 2GB RAM, 20GB SSD — 클라우드 모델 사용 시 충분
- 2 vCPU, 8GB RAM, 40GB SSD — Ollama를 함께 실행할 경우 필요
- 제공업체: Hetzner, Contabo, DigitalOcean 모두 월 5달러부터 시작하는 적절한 요금제를 제공합니다
출처: How to Deploy OpenClaw with Docker — CyberNews
Docker Compose 설정
docker-compose.yml 파일을 생성합니다:
version: "3.8"
services:
openclaw:
image: openclaw/openclaw:latest
container_name: openclaw-agent
restart: unless-stopped
ports:
- "127.0.0.1:3000:3000" # localhost에만 바인딩
volumes:
- ./config:/app/config
- ./data:/app/data
- ./skills:/app/skills
environment:
- ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
- OPENAI_API_KEY=${OPENAI_API_KEY}
env_file:
- .env
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
interval: 30s
timeout: 10s
retries: 3
API key가 포함된 .env 파일을 생성합니다:
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
DEEPSEEK_API_KEY=sk-...
실행:
docker compose up -d
로그 확인:
docker compose logs -f openclaw
TLS를 포함한 역방향 프록시 추가
3000 포트를 인터넷에 직접 노출하지 마세요. Caddy나 nginx를 역방향 프록시로 사용하세요:
# Caddyfile
openclaw.yourdomain.com {
reverse_proxy localhost:3000
}
Caddy는 TLS 인증서를 자동으로 발급하고 갱신합니다. 이제 OpenClaw 웹훅이 전송 중에 암호화됩니다.
출처: How to Install and Securely Run OpenClaw with Docker — IONOS
Part 7: 보안 강화
OpenClaw가 강력한 이유는 당신을 대신해 실제 작업을 수행할 수 있기 때문입니다. 그 강력함에는 신중한 보안 구성이 수반되어야 합니다.
위협 모델
Bitsight의 보안 연구원들은 40,000개 이상의 인터넷에 노출된 OpenClaw 인스턴스를 발견했으며, 그중 35.4%가 원격 코드 실행 취약점에 노출된 것으로 분류되었습니다. Microsoft 보안 팀은 노출된 AI 에이전트의 ID, 격리 및 런타임 위험에 대한 상세 분석을 발표했습니다.
핵심 문제: OpenClaw는 shell 명령을 실행하고, 외부 소스에서 Skills를 다운로드하여 실행하며, 저장된 자격 증명을 사용하여 작업을 수행할 수 있습니다. 적절한 제어 없이 Gateway가 인터넷에 노출되면 공격자는 당신이 할 수 있는 모든 일을 하도록 지시할 수 있습니다.
필수 보안 강화 체크리스트
1. localhost에 바인딩
# config.yaml
gateway:
host: "127.0.0.1" # 절대 0.0.0.0을 사용하지 마세요
port: 3000
2. 격리를 위해 Docker 사용
컨테이너에서 OpenClaw를 실행하여 명시적으로 마운트한 파일에만 액세스할 수 있도록 하세요:
volumes:
- ./config:/app/config:ro # 읽기 전용 설정
- ./data:/app/data # data 디렉토리에만 쓰기 가능
3. 허용된 사용자 제한
모든 채널 구성에 allowlist를 포함해야 합니다:
channels:
telegram:
allowedUsers:
- your_username_only
whatsapp:
allowedNumbers:
- "+1234567890"
4. 비밀 정보 순환 및 보호
OAuth tokens 및 API keys는 ~/.openclaw/에 저장됩니다. 이 디렉토리에 제한된 권한이 설정되어 있는지 확인하세요:
chmod 700 ~/.openclaw
chmod 600 ~/.openclaw/config.yaml
5. OpenClaw 최신 상태 유지
npm update -g openclaw@latest
# 또는 Docker 사용 시
docker compose pull && docker compose up -d
6. Gateway 로그 모니터링
# 예기치 않은 도구 호출 감시
docker compose logs -f openclaw | grep -E "tool_call|exec|shell"
출처: Running OpenClaw Safely — Microsoft Security Blog
Part 8: 이번 주말에 구축해 볼 5가지 자동화
이론도 유용하지만, 실제로 작동하는 자동화가 더 좋습니다. 오늘 바로 배포할 수 있는 5가지 실용적인 워크플로우를 쉬운 것부터 어려운 것 순으로 소개합니다.
1. 아침 편지함 브리핑 (설정 시간 15분)
기능: 매일 아침 7 AM에 OpenClaw가 읽지 않은 이메일을 읽고, 긴급도에 따라 분류한 뒤 우선순위 요약을 Telegram으로 전송합니다.
방법: email-summarizer Skill을 설치하고 Gmail 자격 증명을 구성하세요:
openclaw skills install email-summarizer
skills:
email-summarizer:
schedule: "0 7 * * *"
emailProvider: gmail
outputChannel: telegram
categories:
- urgent
- needs-reply
- informational
- newsletter
사용자들은 이 자동화 하나만으로도 OpenClaw 전체 설정을 정당화할 수 있다고 말합니다.
2. 회의록을 할 일 목록으로 변환 (20분)
기능: 회의 후 OpenClaw에 녹취록(또는 오디오 파일)을 보냅니다. OpenClaw는 할 일 항목을 추출하여 참가자에게 할당하고 각자에게 이메일로 작업을 전송합니다.
사용자 (Slack): [meeting_recording.m4a 업로드]
"이 회의에서 할 일 항목을 추출해서 각 참가자에게 이메일로 보내줘"
3. 의존성 보안 스캐너 (30분)
기능: 매주 OpenClaw가 프로젝트 의존성의 보안 취약점과 업데이트 가능 여부를 확인하고 우선순위 보고서를 보냅니다.
~/.openclaw/skills/dep-scanner/skill.md에 커스텀 Skill을 생성하세요:
---
name: dep-scanner
description: 주간 의존성 보안 감사
triggers:
- schedule: "0 10 * * 1" # 매주 월요일 오전 10시
requires:
tools:
- exec
- messaging
---
# 의존성 보안 스캐너
1. {{projects}}에 나열된 각 프로젝트 디렉토리로 이동
2. 적절한 감사 명령어 실행 (npm audit, pip audit, cargo audit)
3. 발견 사항 분류: critical, high, medium, low
4. 각 취약점에 대한 업그레이드 명령어가 포함된 보고서 작성
5. 사용자의 기본 채널을 통해 보고서 전송
4. 경쟁사 가격 모니터 (45분)
기능: 매일 OpenClaw가 경쟁사 가격 페이지를 방문하여 현재 가격을 추출하고, 어제의 데이터와 비교하여 변경 사항이 있으면 알려줍니다.
이 워크플로우는 OpenClaw의 브라우저 도구를 사용하여 가격 페이지를 탐색하고, 파일 시스템을 사용하여 기록 데이터를 JSON에 저장하며, 메시징 채널을 사용하여 알림을 보냅니다.
출처: OpenClaw Business Use Cases — Codebridge
5. 전체 콘텐츠 파이프라인 (1시간)
기능: 블로그 포스트를 발행하면 OpenClaw가 자동으로 X, LinkedIn용 플랫폼별 소셜 미디어 포스트와 뉴스레터 초안을 생성합니다. 각 플랫폼에 적절한 톤, 길이, 형식을 맞춥니다.
블로그 RSS 피드를 연결하고, 각 플랫폼에 맞는 출력 템플릿을 구성한 후 OpenClaw가 배포를 처리하게 하세요. 커뮤니티는 이 워크플로우를 통해 주당 10시간 이상을 절약했다고 보고합니다.
Part 9: 자동화를 넘어 앱을 직접 만들고 싶을 때
OpenClaw는 기존 서비스를 연결하고 당신을 대신해 작업을 수행하는 개인용 자동화에 탁월합니다. 하지만 "채팅 메시지로 워크플로우를 자동화하는 것"과 "다른 사람들이 사용할 수 있는 실제 애플리케이션을 구축하는 것" 사이에는 격차가 있습니다.
OpenClaw로 워크플로우를 검증했고 이를 SaaS 툴, 내부 대시보드 또는 고객용 앱과 같은 독립적인 제품으로 만들고 싶다면, 자동화 프레임워크가 아닌 애플리케이션 빌더가 필요합니다.
ZBuild는 바로 이러한 전환을 위해 설계된 AI 앱 빌더입니다. 평범한 언어로 만들고 싶은 것을 설명하면, ZBuild가 적절한 UI, 데이터베이스, 인증 및 배포 파이프라인을 갖춘 full-stack 애플리케이션을 생성합니다. OpenClaw가 당신의 워크플로우를 자동화한다면, ZBuild는 다른 사람들이 사용할 수 있는 제품을 출시하도록 돕습니다.
워크플로우는 다음과 같습니다:
- OpenClaw로 프로토타입 제작 — 자동화 아이디어가 작동하는지 검증
- ZBuild로 구축 — 검증된 컨셉을 studio.zbuild.io에서 실제 애플리케이션으로 전환
- 배포 — 사용자들에게 출시
최고의 SaaS 아이디어 중 상당수는 개인적인 자동화에서 시작됩니다. 만약 OpenClaw로 유용한 것을 만들었고 "다른 사람들도 돈을 내고 쓸 것 같다"는 생각이 든다면, 그것이 바로 자동화에서 애플리케이션으로 나아갈 신호입니다.
Part 10: 일반적인 문제 해결
Gateway가 시작되지 않음
# 3000 포트가 이미 사용 중인지 확인
lsof -i :3000
# Node.js 버전 확인 (22.16+ 또는 24+ 필요)
node --version
# 상세 Gateway 로그 확인
openclaw gateway logs --level debug
WhatsApp 연결이 빈번하게 끊김
WhatsApp Web 세션은 주기적으로 만료됩니다. 연결 끊김을 최소화하려면:
- Gateway를 지속적으로 실행 (Docker 또는 systemd 사용)
- 브라우저에서 동시에 WhatsApp Web을 열지 말 것
- 온보딩 시
--install-daemon플래그 사용
모델 타임아웃
에이전트가 복잡한 작업에서 타임아웃이 발생할 경우:
agents:
primary:
model: "anthropic/claude-sonnet-4-6"
timeout: 120000 # 타임아웃을 120초로 증가
maxRetries: 3
Skills가 로드되지 않음
# Skill 구조 검증
openclaw skills validate ~/.openclaw/skills/your-skill/
# Skill 로그 확인
openclaw gateway logs --filter skills
높은 API 비용
Part 3에서 설명한 다중 모델 폴백 체인을 설정하세요. 간단한 쿼리는 DeepSeek나 로컬 모델로 보내고, Claude나 GPT는 더 강력한 추론이 필요한 작업을 위해 남겨두세요.
OpenClaw vs. 대안 모델
| 기능 | OpenClaw | Apple Intelligence | Google Gemini | Microsoft Copilot |
|---|---|---|---|---|
| 오픈 소스 | 예 (MIT) | 아니오 | 아니오 | 아니오 |
| 셀프 호스팅 | 예 | 아니오 | 아니오 | 아니오 |
| 채팅 플랫폼 | 20+ | iMessage 전용 | Google Chat | Teams |
| 모델 선택 | 모든 LLM | Apple 모델만 | Gemini만 | GPT만 |
| 브라우저 제어 | 전체 자동화 | 없음 | 제한적 | 제한적 |
| Shell 명령 | 예 | 아니오 | 아니오 | 아니오 |
| 커스텀 Skills | 5,400+ 커뮤니티 | 없음 | Gems (제한적) | Copilot Studio |
| 프라이버시 | 완전 로컬 옵션 | 기기 내 처리 | 클라우드 전용 | 클라우드 전용 |
| 비용 | 무료 + 모델 비용 | 기기에 포함됨 | 무료 티어 + 유료 | $30/월 (365) |
OpenClaw는 유연성, 프라이버시, 확장성 측면에서 우위에 있습니다. 단점은 설정의 복잡성입니다. 대안들은 즉시 사용할 수 있지만 제어 권한은 훨씬 적습니다.
출처: What Is OpenClaw — DigitalOcean
커뮤니티 및 생태계
OpenClaw의 성장은 상당한 생태계를 만들어냈습니다:
- ClawHub — 수천 개의 커뮤니티 기여가 있는 공식 Skills 레지스트리
- awesome-openclaw-skills — 엄선된 5,400개 이상의 Skills 목록
- nanobot — 리소스가 제한된 환경을 위한 초경량 OpenClaw 변형
- IronClaw — 프라이버시와 보안에 중점을 둔 Rust 기반 재구현 버전
- OpenClaw Showcase — 사람들이 무엇을 구축하고 있는지 보여주는 실제 사례
Zeabur, Hostinger, DigitalOcean 및 기타 호스팅 플랫폼에서 원클릭 배포 템플릿을 사용할 수 있어 5분 안에 시작할 수 있습니다.
출처: OpenClaw Deploy Guide — Zeabur
OpenClaw의 향후 전망
이 프로젝트는 둔화될 기미가 보이지 않습니다. 247K+ 이상의 stars와 47,700 forks를 기록하며 셀프 호스팅 AI 에이전트의 사실상 표준이 되었습니다. 플러그인 생태계는 빠르게 확장되고 있으며, 새로운 채널 통합, 도구 플러그인, Skills가 매일 발표되고 있습니다.
더 큰 그림에서 OpenClaw는 사람들이 AI와 상호작용하는 방식의 변화를 나타냅니다. 봇과 채팅하기 위해 웹사이트를 방문하는 대신, 텍스트 메시지를 보내면 당신의 AI 어시스턴트가 당신의 머신에서, 당신의 제어 하에, 당신이 선택한 모델로 나머지를 처리합니다.
AI가 챗봇을 넘어 실제 에이전시를 갖기를 기다려왔다면, OpenClaw가 바로 그 시작점입니다.
빠른 참조
| 작업 | 명령어 |
|---|---|
| 설치 | npm install -g openclaw@latest |
| 온보딩 | openclaw onboard --install-daemon |
| Gateway 시작 | openclaw gateway start |
| Gateway 중지 | openclaw gateway stop |
| Gateway 재시작 | openclaw gateway restart |
| 로그 확인 | openclaw gateway logs |
| Skill 설치 | openclaw skills install <name> |
| Skill 검색 | openclaw skills search "<query>" |
| Skill 목록 | openclaw skills list |
| 업데이트 | npm update -g openclaw@latest |
| Docker 시작 | docker compose up -d |
| Docker 로그 | docker compose logs -f openclaw |
출처
- OpenClaw GitHub Repository
- OpenClaw Official Website
- OpenClaw Documentation
- OpenClaw — Wikipedia
- What is OpenClaw? — DigitalOcean
- OpenClaw Integrations
- OpenClaw Personal Assistant Setup Guide
- OpenClaw Skills Documentation
- ClawHub — Official Skills Registry
- awesome-openclaw-skills — 5,400+ Curated Skills
- Using OpenClaw with Ollama — DataCamp
- OpenClaw LLM Setup Guide — LaoZhang AI
- OpenClaw API & Model Configuration — Ofox
- How to Change Your AI Model in OpenClaw
- Best Models for OpenClaw — Haimaker
- OpenClaw Live Browser Control — Goldie Agency
- OpenClaw Use Cases 2026 — TLDL
- Top 10 OpenClaw Use Cases — Simplified
- OpenClaw Use Cases — Hostinger
- Advanced OpenClaw Workflows — LightNode
- OpenClaw Business Use Cases — Codebridge
- Deep Dive into OpenClaw Architecture — Medium
- What Are OpenClaw Skills — DigitalOcean
- How to Deploy OpenClaw with Docker — CyberNews
- OpenClaw Docker Documentation
- How to Install and Securely Run OpenClaw — IONOS
- OpenClaw Deploy Guide — Zeabur
- OpenClaw Security Risks — Bitsight
- Running OpenClaw Safely — Microsoft Security Blog
- Mastering OpenClaw — Medium (Vignaraj Ravi)
- OpenClaw Tutorial — AIML API
- nanobot — Ultra-Lightweight OpenClaw
- IronClaw — Rust-based OpenClaw