AI 코딩 어시스턴트가 하나둘 늘어나면서 관리가 복잡해진 경험이 있을 것이다. Claude Code로 코드를 짜고, Codex CLI로 리팩토링하고, Gemini CLI로 문서를 작성한다면 각각을 따로 실행하고 결과를 취합해야 한다. Claw-Empire는 이 모든 에이전트를 하나의 “가상 회사”로 조직해 CEO 시점에서 관리할 수 있게 해주는 도구다.
1. 왜 필요한가
AI 코딩 어시스턴트의 종류가 다양해지면서 몇 가지 문제가 생겼다:
- 컨텍스트 단절: 각 에이전트가 독립적으로 실행되어 작업 맥락을 공유하기 어렵다
- 협업 부재: 여러 에이전트가 같은 프로젝트에서 작업할 때 중복이나 충돌 발생
- 가시성 부족: 어떤 에이전트가 무엇을 하고 있는지 한눈에 보기 어렵다
Claw-Empire는 이 문제를 “회사”라는 은유로 해결한다. 에이전트들은 부서에 소속된 직원이 되고, 사용자는 CEO로서 전체를 조율한다.
2. 핵심 기능
2.1 멀티 프로바이더 통합
Claw-Empire는 CLI, OAuth, API 세 가지 방식으로 다양한 AI를 연결할 수 있다:
| 방식 | 지원 에이전트 |
|---|---|
| CLI | Claude Code, Codex CLI, Gemini CLI, OpenCode |
| OAuth | GitHub, Google |
| API | OpenAI, Anthropic, Google, Ollama, OpenRouter, Together, Groq, Cerebras |
하나의 대시보드에서 모든 에이전트를 관리할 수 있어 컨텍스트 전환 비용이 줄어든다.
2.2 워크플로우 팩 프로파일
Claw-Empire의 독특한 점은 작업 성격에 따라 다른 조직 구조를 적용할 수 있다는 것이다:
| 팩 | 용도 | 부서 구성 |
|---|---|---|
| development | 일반 개발 작업 | Planning, Development, Design, QA-QC, DevSecOps, Operations |
| report | 문서 및 보고서 작성 | Editorial Planning, Research Engine, Doc Design, Review Desk |
| web_research_report | 웹 리서치 및 팩트체크 | Research Strategy, Crawler Team, Fact Check |
| novel | 소설 창작 | Worldbuilding, Narrative Engine, Character Art, Tone QA |
| video_preprod | 영상 기획 | Pre-production, Scene Engine, Art & Camera, Cut QA |
| roleplay | 롤플레이 대화 | Character Planning, Dialogue Engine, Stage Art, Character QA |
개발 작업과 창작 작업이 서로 다른 협업 패턴을 요구한다는 점을 반영한 설계다.
2.3 칸반 보드와 태스크 관리
전체 태스크 생애주기를 관리할 수 있다:
- Inbox → Planned → Collaborating → In Progress → Review → Done
드래그 앤 드롭으로 상태를 변경할 수 있고, 부서별/에이전트별 필터링도 지원한다.
2.4 미팅 시스템과 회의록
계획된 미팅과 즉석 미팅을 모두 지원하며, AI가 회의록을 자동 생성한다. 여러 라운드의 리뷰를 거쳐 승인되는 구조라 품질 관리가 가능하다.
2.5 메신저 통합
Telegram, Discord, Slack 등에서 $ 프리픽스로 CEO 지시를 내릴 수 있다. OpenClaw와 연동하면 더 강력해지지만, 독립적으로도 사용 가능하다.
2.6 스킬 라이브러리
600개 이상의 분류된 스킬(Frontend, Backend, Design, AI, DevOps, Security 등)을 에이전트에 할당할 수 있다. 커스텀 스킬도 .md 파일로 업로드 가능하다.
3. 기술적 딥다이브
3.1 아키텍처
| 레이어 | 기술 스택 |
|---|---|
| 프론트엔드 | React 19 + Vite 7 + Tailwind CSS 4 + TypeScript 5.9 |
| 픽셀아트 엔진 | PixiJS 8 |
| 백엔드 | Express 5 + SQLite (제로설치 임베디드 DB) |
| 실시간 통신 | WebSocket (ws) |
| 검증 | Zod 4 |
로컬 우선 철학이 중요하다. 모든 데이터가 로컬 SQLite에 저장되며 클라우드 의존성이 없다. 프라이버시가 중요한 작업에도 안전하게 사용할 수 있다.
3.2 Git Worktree 격리
각 에이전트가 격리된 git 브랜치에서 작업하며, CEO 승인 시에만 머지된다. 여러 에이전트가 동시에 작업해도 충돌을 방지할 수 있다.
3.3 실시간 상태 동기화
WebSocket 기반으로 에이전트 상태, 활동 피드, 태스크 진행 상황을 실시간으로 동기화한다. 활성 에이전트 모니터에서 프로세스/활동/유휴 상태를 확인하고, 멈춘 태스크는 직접 종료할 수도 있다.
4. 실제 사용 시나리오
시나리오 1: 기능 개발
- CEO 채팅에서 “로그인 기능 구현해”라고 지시
- Planning 부서에서 요구사항 분석
- Development 부서에서 코드 작성
- QA-QC 부서에서 테스트
- DevSecOps에서 보안 검토
- 완료 보고서 생성
시나리오 2: 기술 리서치
web_research_report 팩을 사용하면:
- Research Strategy가 검색 전략 수립
- Crawler Team이 소스 수집.
- Fact Check가 정보 검증
- 최종 리포트 생성
시나리오 3: 프레젠테이션 생성
미팅 회의록이나 보고서에서 PowerPoint 슬라이드를 자동 생성할 수 있다. PptxGenJS를 사용하며 HTML 슬라이드에서 pptx로 변환하는 파이프라인이 내장되어 있다.
5. OpenClaw와의 관계
Claw-Empire는 OpenClaw의 에코시스템 일부로 개발되었다. OpenClaw는 AI 에이전트를 위한 메시징 플랫폼이고, Claw-Empire는 에이전트 오케스트레이션을 위한 시각적 인터페이스다.
OpenClaw 없이도 독립적으로 사용할 수 있지만, 함께 사용하면 메신저 통합이 더 강력해진다. Discord 봇 토큰 기반 채널 자동 발견, 인바운드 메시지 수신 등의 기능을 활용할 수 있다.
6. 설치 방법
AI 코딩 어시스턴트에게 이 한 줄만 전달하면 된다:
Install Claw-Empire following the guide at:
https://github.com/GreenSheep01201/claw-empire수동 설치는:
git clone https://github.com/GreenSheep01201/claw-empire.git
cd claw-empire
git submodule update --init --recursive
bash install.sh # Windows: powershell -ExecutionPolicy Bypass -File .\install.ps1Node.js 22+와 pnpm이 필요하다.
마치며: AI 협업의 새로운 패러다임
Claw-Empire는 AI 에이전트를 “도구”가 아닌 “동료”로 다루는 관점의 전환을 보여준다. 부서, 미팅, XP, 랭킹 같은 게이미피케이션 요소는 단순히 재미를 위한 것이 아니라 복잡한 협업 구조를 직관적으로 만드는 장치다.
395개의 스타와 85개의 포크를 기록한 점을 고려하면, AI 코딩 워크플로우를 체계화하려는 니즈가 꽤 크다는 것을 알 수 있다. 특히 로컬 우선 설계와 다국어 UI(한국어 포함) 지원은 한국 개발자들에게도 매력적인 요소다.
🔗 관련 정보
- GitHub: GreenSheep01201/claw-empire
- OpenClaw: openclaw/openclaw
- 릴리스 노트: v2.0.1 Release Notes
- 라이선스: Apache 2.0