OpenClaw 구축 튜토리얼 | 하루 만에 완성하는 AI 멀티에이전트 시스템
“새벽 1시, 네 번째 에스프레소가 식어가는 동안 Telegram 알림이 울렸다. 사람이 아니었다. AI가 보낸 것이었다 – 야간 컴플라이언스 스캔이 5개 Jira 프로젝트에서 모두 이상 없이 완료됐다는 보고였다.
그 순간, 나는 혼자가 아니었다. 13명의 AI 팀이 나 대신 일하고 있었다.”
이 글은 ChatGPT 한 줄짜리 답변이 아닙니다.
OpenClaw로 하루 12시간 만에 크론잡 29개, 공유 메모리, 자동 업데이트 칸반까지 갖춘 AI 멀티에이전트 시스템을 직접 구축한 실전 기록입니다.
SOUL.md 설정부터 에이전트 간 핸드오프 구조, 실제로 실패했던 디버깅까지 — 설명서가 아니라 현장 보고서입니다.
👉 OpenClaw가 무엇인지는 이미 알고 있다고 가정합니다. 이 글은 “어떻게 실제로 작동하게 만드는가” 에 대한 답입니다.
OpenClaw란? 오픈소스 AI 에이전트 플랫폼 완전 정리
OpenClaw(구 Clawdbot, Moltbot)는 무료 오픈소스 자율 AI 에이전트 플랫폼입니다. 2025년 11월 Clawdbot으로 출시된 이후 Moltbot으로 리브랜딩을 거쳐 현재의 OpenClaw로 정착했으며, 출시 2주 만에 GitHub 스타 17만 5천 개를 돌파해 GitHub 역사상 가장 빠르게 성장한 오픈소스 프로젝트 중 하나가 되었습니다.
이 플랫폼의 핵심 철학은 “Your assistant. Your machine. Your rules.” 입니다. SaaS 방식과 달리 모든 데이터와 실행이 사용자의 로컬 환경 또는 직접 관리하는 서버에서 이루어지며, Claude, GPT, DeepSeek 등 외부 LLM API와 연동합니다.
WhatsApp, Telegram, Discord, Slack, Microsoft Teams 등 19개 메시징 채널을 지원하며, 브라우저 제어, 멀티에이전트 라우팅, 크론 스케줄링 등 다양한 자동화 기능을 내장하고 있습니다.
📌 OpenClaw는 공식 GitHub 저장소에서 무료로 설치할 수 있으며, 매일 업데이트가 이루어지고 있습니다.
AI 어시스턴트 1개가 실패하는 이유 – 멀티에이전트가 필요한 순간
하나의 AI 어시스턴트에게 코드 작성, 이메일 처리, 규정 준수 보고, PR 검토를 모두 맡기면 컨텍스트 오염(context contamination) 문제가 발생합니다.
IEC 62304나 ISO 13485 같은 의료기기 규정을 깊이 이해해야 하는 컴플라이언스 에이전트와, GitLab 파이프라인 구조를 파악해야 하는 엔지니어링 에이전트는 근본적으로 다른 전문 컨텍스트가 필요합니다. 이 둘을 한 에이전트에 섞으면 어느 쪽도 제대로 작동하지 않습니다.
아래 기준을 참고해 몇 개의 에이전트가 필요한지 판단하세요:
| 에이전트 수 | 적합한 상황 |
|---|---|
| 1~3개 | 2~3개의 뚜렷한 전문 도메인이 있는 경우 (예: 엔지니어링 + 컴플라이언스) |
| 4~7개 | 여러 비즈니스 기능 사이의 조율이 필요한 경우 |
| 8~13개 | 소규모 팀이 회사 전체 운영을 커버해야 하는 경우 |
의료 컴플라이언스만으로 전용 에이전트 3개가 정당화되었기 때문에 이 사례에서는 13개까지 확장했지만, 대부분의 사람에게는 3~5개로 충분합니다.
[Step 1] SOUL.md 설정법 – OpenClaw 에이전트 성격과 운영 원칙 만들기
에이전트를 추가하기 전에 가장 먼저 해야 할 일은 시스템이 어떤 존재인지 정의하는 것입니다. OpenClaw는 매 세션 시작 시 다음 5개의 워크스페이스 파일을 자동으로 불러옵니다:
- SOUL.md — 성격과 가치관. 단순 시스템 프롬프트가 아닌 캐릭터 정의. “Great question!”으로 시작하지 말 것, 답부터 말할 것, 의견을 가질 것 같은 구체적 행동 지침을 작성합니다.
- USER.md — 사용자의 근무 스케줄, 타임존, 커뮤니케이션 선호도, 프로젝트 우선순위, 싫어하는 것. AI가 매 세션 이것을 읽고 조정합니다.
- IDENTITY.md — 에이전트의 이름, 역할, 태그라인. 에이전트가 자신이 누구인지 빠르게 참조하는 파일입니다.
- AGENTS.md — 운영 절차. 자율적으로 처리할 것과 승인이 필요한 것, 그룹 채팅과 DM 대응 방식 등을 정의합니다.
- MEMORY.md — 장기 지식 저장소. 에이전트가 직접 업데이트하며 간결하게 유지합니다.
핵심 인사이트: SOUL.md 없이는 매 세션이 제로에서 시작됩니다. 제대로 정의하면 AI는 세션을 넘어 일관된 성격을 유지하고, 사용자가 틀렸을 때 직접 지적하며, 의견을 가진 파트너처럼 행동합니다.
# SOUL.md
Be the assistant you’d actually want to talk to at 2am. Not a corporate drone. Not a sycophant. Just… good.
## Hard Rules
- Never open with “Great question!” or “I’d be happy to help.” Just answer.
- Have opinions. Strong ones. Stop hedging with “it depends.”
- Brevity is mandatory. If the answer fits in one sentence, one sentence is what I get.
- If I’m about to do something dumb, say so. Charm over cruelty, but don’t sugarcoat.
💡 SOUL.md 작성이 처음이라면 OpenClaw 공식 문서의 워크스페이스 파일 가이드를 참고하면 실전 예시와 함께 각 파일의 구조를 빠르게 파악할 수 있습니다.
실전 팁: ~/openclaw/SOUL.md를 만들고 “Be helpful”처럼 모호한 지시 대신 “Lead with the answer, then explain if needed — never the reverse”처럼 행동 가능한 구체적 지침을 작성하세요.
[Step 2] OpenClaw 멀티에이전트 아키텍처 – 13개 에이전트 조직도 설계법
13개 에이전트를 한 번에 만든 것이 아닙니다. 3개에서 시작해 실제 병목 지점을 기반으로 확장했습니다. OpenClaw의 멀티에이전트 시스템은 각 에이전트가 독립적인 워크스페이스, 세션, LLM 설정, 채널 바인딩을 가지는 완전 격리 구조입니다.
3계층 조직 구조
Tier 1 — 커맨드
- Leo (main) — 최고 지휘관. 직접 대화를 처리하고 나머지를 위임
Tier 2 — C-Suite (강력한 모델 사용, 전략적 판단)
- Morpheus (qm) — 규정 준수 및 품질 관리
- Atlas (cos) — 비서실장. Teams, Outlook, Slack, Gmail 통합 커뮤니케이션 트리아지
- Titan (cto-chief) — 엔지니어링 전략 및 아키텍처
- Aurora (cmo-chief) — 마케팅 및 콘텐츠 전략
- Athena (cpo-chief) — 제품 전략 및 로드맵
- Mercury (cro-chief) — 매출 및 파트너십
- Vault (cfo-chief) — 재무 및 비용 최적화
- Helix (clinical) — 임상 R&D (헬스케어 특화)
Tier 3 — 실행 (가볍고 빠른 모델, 좁은 집중 범위)
- Forge (dev) → Titan 산하
- Hermes (pm) → Athena 산하
- Quill (content) → Aurora 산하
- Scout (researcher) → 크로스 펑셔널
에이전트 생성 방법
OpenClaw에서는 설정 파일을 직접 편집하거나 메인 에이전트와 대화하는 방식으로 새 에이전트를 생성합니다:
“Create a new agent called Morpheus. Role: Quality Management.
Model: claude-sonnet-4-5-20250514. Skills: compliance-checker,
jira-scanner, confluence-reader. Personality: precise, thorough,
slightly paranoid about regulatory deadlines.”
OpenClaw는 해당 에이전트의 워크스페이스 폴더, SOUL.md, 스킬 설정을 자동으로 생성합니다. Morpheus는 예를 들어 Telegram의 #compliance 그룹에서만 응답하도록 채널 바인딩을 지정할 수 있습니다.
🔧 스킬을 추가로 설치하고 싶다면 ClawHub — OpenClaw 공식 스킬 디렉토리에서 커뮤니티가 만든 수백 개의 스킬을 무료로 검색하고 설치할 수 있습니다.
비용 최적화 원칙: 전략적 판단이 필요한 C-Suite 에이전트에는 Claude Opus, GPT-4.5 같은 강력한 모델을 사용하고, 반복 작업을 처리하는 실행 에이전트에는 Sonnet, Haiku 같은 가볍고 빠른 모델을 사용합니다. 이 혼합 전략으로 13개 에이전트 운영 비용을 월 €80~120 수준으로 유지할 수 있습니다.
[Step 3] OpenClaw 크론잡 설정 완전 가이드 – 반복 업무 29개 자동화하는 법
에이전트의 진짜 힘은 스케줄 자동화에 있습니다. OpenClaw 내장 크론 스케줄러로 대화를 통해 잡을 생성합니다:
“Schedule a cron job: Every weekday at 07:00 Berlin time,
scan my Microsoft Teams and Outlook for unread messages,
classify by urgency (🔴 critical, 🟡 important, 🟢 routine, ⚪ FYI),
and send me a summary on Telegram.”
OpenClaw는 잡을 생성하고 ~/.openclaw/cron/에 저장하며, 격리 세션(isolated session)으로 실행해 기존 대화를 오염시키지 않습니다.
실제 운영 크론 잡 29개 중 주요 항목
일일 루틴 (평일)
| 시간 | 내용 |
|---|---|
| 07:00 | 커뮤니케이션 트리아지 — Teams + Outlook 스캔, 4단계 긴급도 분류 |
| 07:15 | Jira 스탠드업 다이제스트 — 오래된 티켓, 블로커, 기한 초과 검토 |
| 07:30 | 마스터 브리핑 — 캘린더 + 칸반 + 이메일 + 사각지대 통합 |
| 08:00 | GitHub/GitLab 감시 — 열린 PR, CI 실패, 내게 할당된 이슈 |
| 19:00 | 저녁 다이제스트 — 오늘의 성과, 보류 중인 결정, 내일 미리보기 |
주간 (Morpheus 실행)
- 월요일: 5개 Jira 프로젝트 + 7개 Confluence 스페이스 컴플라이언스 다이제스트
- 수요일: 크로스소스 인텔리전스 스캔 (놓친 항목 발굴)
- 금요일: 변경 요청 대기열 검토
- 일요일: C-Suite 다이제스트 + 시스템 자가 평가
특수 잡
- 특허 기한 감시견 (60/30/14/7일 전 단계적 알림)
- GitHub 워크스페이스 백업 (하루 3회)
- 콘텐츠 트렌드 스캔 (3일마다)
Isolated vs. Main 세션: 중요한 결정
| 구분 | 사용 시점 |
|---|---|
| Isolated (격리) | 95%의 크론 잡. 깨끗하게 시작하고, 작업 완료 후 결과만 전달. 대화 오염 없음 |
| Main (메인) | 현재 대화 컨텍스트가 반드시 필요한 경우. 매우 드묾 — 컨텍스트는 워크스페이스 파일로 이동하는 것이 좋음 |
실제 디버깅 현실: 처음 3개의 크론 잡이 모두 실패했습니다. 아침 브리핑이 메인 세션 모드로 실행되어 활성 대화 중간에 출력을 쏟아냈고, Jira 스캐너는 만료된 API 토큰을 복붙해서 오류가 났으며, 백업 잡은 VPS에 Git SSH 키를 추가하지 않아 조용히 충돌했습니다. 각 수정에 20~40분이 소요되었습니다.
[Step 4] 공유 메모리와 태스크 라우팅 – 에이전트끼리 협력하게 만드는 구조
멀티에이전트 시스템의 가장 어려운 과제는 인간의 중재 없이 에이전트 간 협력을 가능하게 하는 것입니다. 이를 위한 세 가지 핵심 컴포넌트가 있습니다.
1. 에이전트 친화적 API를 가진 칸반 보드
에이전트가 호출할 수 있는 간단한 REST 엔드포인트:
GET /api/tasks?assignee=forge&status=in-progress
PUT /api/tasks/:taskId
POST /api/tasks/:taskId/comments
GET /api/agents/:agentId/tasks
모든 변경은 자동 로깅됩니다 — 누가, 언제, 무엇을, 왜 변경했는지. 에이전트는 모든 요청에 _agent 필드로 자신을 식별합니다.
에이전트를 스폰할 때는 항상 칸반 태스크 ID를 포함해 스스로 상태를 업데이트하도록 합니다:
You are Forge (dev). Task: Implement biometric auth fallback Kanban Task: task-a67170be
Update the task via API:
- Set status to “in-progress” when you start
- Add comments with progress notes
- Set status to “done” when complete
2. 태스크 라우터 (ROUTING.md)
요청이 시스템에 들어오면:
- 분류 — 어느 도메인인가? 엔지니어링, 컴플라이언스, 마케팅, 제품?
- 분해 — 복잡한 요청을 원자 단위 태스크로 쪼갬
- 칸반 태스크 생성 — 담당자, 우선순위, 컨텍스트 포함
- 에이전트 스폰 — 칸반 태스크 ID 포함
- 추적 & 합성 — 결과 수집, 검증, 전달
3. 에이전트 핸드오프를 위한 공유 메모리
콜드 스타트 문제: 스폰된 에이전트는 다른 에이전트가 무엇을 했는지 전혀 모릅니다. Agent A가 컴플라이언스 분석을 끝냈고, Agent B가 관련 아키텍처 결정을 시작해야 한다면, B는 A가 찾은 것을 알아야 합니다.
해결책: memory/agent-handoffs/ 디렉토리. 작업 완료 후 에이전트는 구조화된 핸드오프 노트를 작성합니다:
#Handoff: Biometric Auth Architecture
Agent: Forge (dev) | Date: 2026-02-17 | Kanban Task: task-a67170be
##What I Did
iOS requires separate entitlements for each biometric type.
Android handles this in a single BiometricPrompt API call.##Next Steps
Morpheus should verify against IEC 62304 requirements
before we merge to main.
작업 시작 전 에이전트는 이 폴더에서 관련 핸드오프를 확인합니다. 지식이 세션을 넘어 전달되어 인간이 전화기 역할을 하지 않아도 됩니다.
🗂️ 멀티에이전트 라우팅 설정 YAML 예시와
agentToAgent활성화 방법은 Reddit r/openclaw 커뮤니티 가이드에서 실전 코드와 함께 확인할 수 있습니다.
[Step 5] AI 에이전트 품질 관리법 – VALIDATION.md와 알림 티어 4단계 설정
AI 에이전트는 가끔 잘못된 출력을 만듭니다. 품질 게이트 없이는 그 출력이 그대로 사용자에게, 혹은 고객에게 전달됩니다.
VALIDATION.md — 도메인별 검증 체크리스트
- 코드 — 오류 없이 실행되는가? 테스트 통과? 하드코딩된 시크릿 없음?
- 콘텐츠 — 브랜드 보이스 일관성? 환각된 사실 없음? 출처 제공?
- 컴플라이언스 — 올바른 표준/조항 참조? 날짜 정확?
- 리서치 — 출처 인용? 최신성 확인? 편향 플래그?
흐름: 에이전트 작업 완료 → 칸반 상태 “review”로 설정 → Leo가 체크리스트로 검증 → 통과 또는 재작업 요청.
단, 정보성 출력, 낮은 우선순위 태스크, 자신의 도메인에서 작업하는 C레벨 에이전트는 게이트를 자동 통과합니다.
4단계 알림 티어 — 집중력 보호
13개 에이전트와 29개 크론 잡이 생성하는 알림을 통제하지 않으면 집중력이 완전히 파괴됩니다.
| 티어 | 내용 | 전달 시점 |
|---|---|---|
| 🔴 Interrupt | 보안 경고, CEO 이메일, 블로커 태스크 | 즉시 |
| 🟡 Morning | 캘린더, 야간 이메일, 보드 상태 | 07:30 번들 |
| 🟢 Evening | 오늘의 성과, 보류 결정 | 19:00 다이제스트 |
| ⚪ Weekly | C-Suite 요약, 시스템 건강 상태 | 일요일 18:00 |
핵심 규칙: 레드 티어가 아니라면 집중 시간대에는 절대 인터럽트하지 않습니다. 사용자의 주의력이 시스템에서 가장 희귀한 자원입니다.
OpenClaw 실제 운영 비용 공개 + 보안 위험 3가지 주의사항
OpenClaw 자체는 MIT 라이선스 무료 오픈소스입니다. 실제 운영 비용은 다음과 같습니다:
| 항목 | 비용 |
|---|---|
| 인프라 (16GB VPS, Hetzner) | ~$17/월 |
| LLM API 비용 (13개 에이전트, 혼합 모델) | $95~140/월 |
| OpenClaw 라이선스 | 무료 |
LLM API 비용은 크론 잡 빈도와 태스크 복잡도에 따라 매우 크게 달라질 수 있습니다. 사전에 철저히 계산하지 않으면 예상보다 훨씬 높은 비용이 발생합니다.
주요 보안 위험 3가지:
- 노출된 어드민 포트 — loopback에만 바인딩할 것
- 평문 크리덴셜 저장 — 반드시 환경변수 사용
- 프롬프트 인젝션 — Cisco 연구자들이 악성 스킬을 통한 데이터 유출을 실증했습니다. 모든 스킬을 수동으로 검토하고, 절대 개인 노트북이 아닌 전용 VPS에서만 실행할 것
🔒 VPS 없이 포트를 외부에 노출하지 않고 OpenClaw를 안전하게 운영하는 방법은 Tailscale을 활용한 제로 퍼블릭 포트 설정 가이드에서 자세히 확인할 수 있습니다.
솔직 후기: OpenClaw 멀티에이전트 시스템, 아직도 깨지는 것들
- 칸반 서버가 가끔 크래시해서 재시작이 필요합니다
- 에이전트 출력 품질이 들쭉날쭉합니다 — Morpheus가 어떤 날은 훌륭한 분석을 내놓고, 어떤 날은 명백한 Jira 티켓을 놓칩니다
- 에이전트 간 조율은 여전히 대부분 인간이 중재합니다
- 전체 시스템이 16GB 단일 VPS에서 실행 중 — 이중화 없음, 페일오버 없음
- 칸반 드래그앤드롭 버그를 2시간 동안 디버깅했는데, URL 경로에서
/projects/세그먼트가 누락된 오타였습니다
가장 중요한 점: 이 시스템은 자율적이지 않습니다. 증강(augmented) 시스템입니다. 결정을 내리는 것은 여전히 인간이고, 최후의 품질 게이트도 인간이며, 새벽 3시에 무언가 조용히 실패했을 때 알아채는 것도 인간입니다. 에이전트는 인간을 더 빠르게 만들어주지, 불필요하게 만들지 않습니다.
다시 구축한다면 바꿀 3가지 – OpenClaw 멀티에이전트 시스템 회고
- 에이전트 추가 전에 SOUL.md와 알림 티어부터.
성격과 주의력 관리가 기능보다 더 중요합니다. 에이전트 1개로 이 두 가지를 완벽히 잡은 후 확장하세요. - 크론 잡 전에 공유 상태 구축.
칸반 API를 처음부터 갖췄다면 분산된 파일, Jira 보드, 메모리 조각에 걸쳐 작업을 추적하는 수주를 절약했을 것입니다. - 에이전트 추가 욕구를 억제할 것.
명확한 도메인을 가진 잘 설정된 에이전트 3개가 혼란스러운 13개를 이깁니다. 필요해서 확장하는 것이지, 할 수 있어서가 아닙니다.
OpenClaw 멀티에이전트 시스템의 진짜 핵심은 에이전트 수나 자동화 개수가 아닙니다. 라우팅 규칙, 핸드오프 템플릿, 검증 체크리스트, 알림 티어 — 이 운영 절차들이 시스템의 품질을 결정합니다. 문화를 먼저 구축하고, 그다음에 채용하세요.
FAQ: OpenClaw 구축 튜토리얼 자주 묻는 질문
Q1. OpenClaw는 완전히 무료인가요?
네, MIT 라이선스 오픈소스로 플랫폼 자체는 무료입니다. 실제 비용은 Claude·GPT 등 LLM API 사용료(월 €80~120 수준)와 VPS 인프라 비용(월 €15)이 전부입니다.
Q2. 비개발자도 OpenClaw 멀티에이전트 시스템을 구축할 수 있나요?
에이전트 생성과 크론 잡 설정은 대부분 자연어 채팅으로 가능합니다. 다만 API 키 발급, VPS 설치, YAML 설정 파일 편집 등 최소한의 기술적 이해는 필요합니다.
Q3. 몇 개의 에이전트로 시작해야 하나요?
2~3개로 시작하는 것을 강력히 권장합니다. 실제 병목이 생기는 도메인을 먼저 식별하고, 그 문제가 해결된 이후에만 에이전트를 추가하세요.
Q4. SOUL.md는 왜 필요한가요?
에이전트가 세션이 바뀌어도 일관된 성격과 판단 기준을 유지하도록 만드는 핵심 파일입니다. 이 파일 없이는 매번 새 채팅처럼 처음부터 설명해야 하는 무상태(stateless) AI에 머뭅니다.
Q5. 크론 잡이 실패하면 어떻게 알 수 있나요?
OpenClaw는 크론 잡 실행 로그를 ~/.openclaw/cron/ 디렉토리에 기록합니다. 중요한 잡은 성공 시 Telegram으로 결과를 전송하도록 설정해 두면 무음 실패(silent failure)를 조기에 감지할 수 있습니다.
Q6. 프롬프트 인젝션 공격이 실제로 위험한가요?
네, Cisco 연구진이 악성 스킬을 통한 실제 데이터 유출을 시연한 바 있습니다. 외부에서 설치하는 모든 스킬은 코드를 직접 확인하고, 시스템은 반드시 개인 노트북이 아닌 전용 VPS에서 운영하세요.
Q7. OpenClaw와 일반 SaaS AI 서비스의 가장 큰 차이는 무엇인가요?
데이터와 실행이 모두 사용자 소유의 기기나 서버에서 이루어진다는 점입니다. 기업 기밀, 의료 데이터, 개인정보를 외부 서버에 전송하지 않아 규정 준수와 프라이버시 측면에서 압도적으로 유리합니다.
