pillar

OpenClaw 완전 가이드: 설치부터 멀티에이전트 오케스트레이션까지

핵심 요약

OpenClaw(오픈클로)는 CLI 기반 오픈소스 AI 에이전트 오케스트레이션 플랫폼으로, 설치부터 멀티에이전트 병렬 실행까지 포괄하는 완전한 개발 환경을 제공한다. ACP 채널바인딩 프로토콜로 세션 격리를 보장하고, 서브에이전트 풀의 Fan-Out/Fan-In 패턴으로 처리량을 극대화하며, Markdown 선언적 설정으로 개발자 경험을 혁신한다.

이 글의 핵심 주장과 근거

핵심 주장

OpenClaw 는 제대로 세팅 시 Notion→블로그 자동 발행, Claude/GPT/Gemini 간 맥락 유지 모델 전환, AI 가 직접 전화해 식당 예약 완료하는 등 비서 수준의 자율 자동화가 실제로 가능하다

출처: [1] 오픈 클로 (OpenClaw) 한 달 실사용 후기 모음 : 진짜 써보니 어땠나? (커뮤니티 총정리)

핵심 주장

OpenClaw 에서 heartbeat 는 정기적인 체크리스트 (메일, 캘린더, 날씨 등) 를 30 분 주기로 부드럽게 수행할 때 사용하고, cron 은 정확히 정해진 시간 (예: 매일 9 시) 에 한 번만 실행해야 할 작업 (리마인더, 보고서 생성 등) 에 사용한다.

직접 근거: [1] ZeroInput 직접 경험 ([World] 비전책이 아닌 개발자가 OpenClaw 를 처음 쓸 때 자주 하는 질문 7 가지)

핵심 주장

OpenClaw 는 장기 기억을 MEMORY.md 에서 curated(요약·정제) 하고, 일일 로그를 memory/YYYY-MM-DD.md 에 원문 가깝게 기록하며, memory_search 로 조회하고 memory_get 으로 필요한 조각만 읽어오는 2 계층 메모리 구조를 사용한다.

직접 근거: [1] ZeroInput 직접 경험 ([World] 비전책이 아닌 개발자가 OpenClaw 를 처음 쓸 때 자주 하는 질문 7 가지)

OpenClaw의 온프레미스 실행 모드는 모든 AI 추론을 로컬 LMStudio 서버에서 처리하여, 프롬프트와 응답이 외부 네트워크로 한 번도 전송되지 않도록 보장한다.

출처: [1] OpenClaw GitHub 저장소 [2] ZeroInput 직접 경험

OpenClaw 는 개별 스크립트가 아닌 세션 기반의 장시간 실행 가능한 워크플로우를 제공하며, 지속적인 메모리·상태 관리·자동화된 작업 (heartbeat·cron) 을 통해 실제 개발 작업을 수행하도록 설계되었다.

직접 근거: [1] ZeroInput 직접 경험 ([World] 비전책이 아닌 개발자가 OpenClaw 를 처음 쓸 때 자주 하는 질문 7 가지)

OpenClaw 설치 성공률은 기기마다 달라 M4 맥미니에서는 실패했으나 M1/M3 에서 성공하는 등 '설치가 로또'라는 커뮤니티 평가가 지배적이며, SKILLS.md 설정을 꼼꼼히 하지 않으면 단순 챗봇 수준에 그친다

출처: [1] 오픈 클로 (OpenClaw) 한 달 실사용 후기 모음 : 진짜 써보니 어땠나? (커뮤니티 총정리)

OpenClaw + Capability Hub + vibe-kanban 통합은 제품 로드맵이나 추측이 아닌, 리포지토리에서 검증된 현재 시스템으로, PRODUCT_ARCHITECTURE_DEEP_DIVE.md 는 운영 매뉴얼 README 와 구분되는 엔지니어링 심층 분석 문서이다

출처: [1] Claude Code GAV Feedback Loop

설치와 환경 구성

OpenClaw는 npm 또는 직접 바이너리 설치를 지원하며, LMStudio·Claude·GPT 등 다양한 모델 백엔드와 연동할 수 있다. .openclaw 디렉토리에 에이전트 설정과 세션 데이터가 저장되며, JSON 기반 설정 파일로 모델·프롬프트·권한을 세밀하게 제어한다. 로컬에서 완전히 오프라인으로 실행할 수 있어 데이터 주권과 보안을 확보할 수 있다.

CLI 명령 체계와 에이전트 실행

openclaw agent 명령은 에이전트를 생성하고 작업을 위임하는 핵심 인터페이스다. --local 플래그로 로컬 모델을 사용하거나 --agent 플래그로 특정 에이전트 프로파일을 지정할 수 있다. 세션 관리, 컨텍스트 체크포인트, 자동 복구 기능이 내장되어 있어 장시간 실행되는 복잡한 작업도 안정적으로 처리한다.

ACP 채널바인딩 프로토콜 심화

ACP(Agent Communication Protocol)는 요청→인증→라우팅→실행→검증→피드백→적용→로그의 8단계로 구성된 결정적 메시지 전달 프로토콜이다. dmScope 이중 격리를 통해 물리적 프로세스 격리와 논리적 라우팅 격리를 동시에 적용하며, 채널-스레드 고정으로 동일한 대화 컨텍스트 내에서 메시지가 일관되게 처리된다.

서브에이전트 풀과 병렬 실행 전략

서브에이전트 풀은 다수의 에이전트를 동시에 생성·관리하는 병렬 실행 계층이다. Fan-Out 패턴으로 작업을 분산하고 Fan-In 패턴으로 결과를 수집·병합한다. 각 서브에이전트는 고유한 agentId를 통해 독립적으로 관리되며, 동시성 스로틀링 메커니즘으로 리소스 과부하를 방지한다.

실전 사례와 응용

OpenClaw는 ERP 시스템 구축, 웹 애플리케이션 자동 개발, 데이터 파이프라인 자동화, 지식 그래프 관리 등 다양한 실전 사례에서 활용되고 있다. 특히 17년차 ERP 전문가의 도입 사례에서는 클라우드 의존도를 40% 이상 낮추고 시스템 가용성 99.8%를 달성하는 성과를 보여주었다.

자주 묻는 질문

OpenClaw를 처음 설치하려면 무엇이 필요한가?

Node.js 18+ 환경에서 npm 또는 직접 바이너리로 설치할 수 있으며, 로컬 모델(LMStudio)이나 클라우드 API 키(Claude/GPT)가 필요하다. 설치 후 openclaw agent --local 명령으로 즉시 첫 에이전트를 실행할 수 있다.

ACP 채널바인딩은 왜 필요한가?

ACP 채널바인딩은 여러 서브에이전트가 동시에 작업할 때 세션 간 컨텍스트 오염을 방지하고 메시지 전달의 결정성을 보장한다. 이를 통해 복잡한 멀티에이전트 워크플로우에서도 안정적인 실행 결과를 얻을 수 있다.

OpenClaw와 Claude Code의 차이점은?

Claude Code는 단일 에이전트 기반의 대화형 코딩 도구인 반면, OpenClaw는 멀티에이전트 오케스트레이션 플랫폼으로 여러 에이전트를 병렬로 실행하고 작업을 위임·조율할 수 있다. 게이트웨이 영속성과 세션 격리라는 구조적 차별점이 있다.