GreenSheep01201/claw-empire

CEO 데스크에서 당신의 AI 에이전트 제국을 지휘하세요

CLI, OAuth, 그리고 API 연결된 제공업체(Claude Code, Codex CLI, Gemini CLI, OpenCode, Kimi Code, GitHub Copilot, Antigravity 포함)를 자율적인 에이전트들의 가상 회사로 오케스트레이션하는 로컬 우선 (Local-first) AI 에이전트 오피스 시뮬레이터입니다.

빠른 시작 · AI 설치 가이드 · 릴리스 노트 · OpenClaw · Direct Messenger · $ Command · 기능 · 스크린샷 · 기술 스택 · 제공업체 · Docker 배포 · 보안

Claw-Empire는 CLI, OAuth 또는 직접 API 키를 통해 연결된 당신의 AI 코딩 어시스턴트들을 완전히 시뮬레이션된 가상 소프트웨어 회사로 변모시킵니다. 당신은 CEO입니다. 당신의 AI 에이전트들은 직원들입니다. 매력적인 픽셀 아트 (Pixel-art) 오피스 인터페이스를 통해 그들이 부서 간에 협업하고, 회의를 열고, 업무를 수행하며, 레벨 업하는 모습을 지켜보세요.

하나의 인터페이스, 다수의 AI 에이전트— 단일 대시보드에서 CLI, OAuth 및 API 기반 에이전트를 관리하세요
로컬 우선 및 프라이버시— 모든 데이터는 당신의 기기에 머뭅니다. SQLite 데이터베이스를 사용하며 클라우드 의존성이 없습니다
시각적이고 직관적임— 픽셀 아트 오피스 뷰를 통해 AI 오케스트레이션(Orchestration)을 재미있고 투명하게 즐기세요
실제 자율적 협업— 에이전트들은 격리된 git 워크트리(worktrees)에서 작업하고, 회의에 참석하며, 결과물을 생성합니다

다음 내용을 당신의 AI 코딩 에이전트(Claude Code, Codex, Gemini CLI 등)에 붙여넣으세요:
Install Claw-Empire following the guide at: https://github.com/GreenSheep01201/claw-empire

AI가 이 README를 읽고 모든 것을 자동으로 처리할 것입니다.

Docker 배포가 이제 공식 문서화된 경로가 되었습니다— 리포지토리는 이제 프로덕션 지향적인 Dockerfile, docker-compose.yml, .dockerignore 및 컨테이너 인식 런타임 경로 처리를 제공합니다.

Stale (만료)— 라이프사이클 시작 및 간격 스윕(interval sweeps)은 여전히 working으로 표시된 에이전트를 리셋합니다.
working 에이전트는 중단된 실행 후에도 실시간 in_progress 없이 자동으로 복구됩니다.

task. -
Settings > API에서 이제 공식 direct-API 프리셋 (presets)을 지원합니다

OpenCode Go 및 Bailian Coding Plan 프리셋은 예상되는 Base URL을 고정하고, 시드 폴백 모델 (seed fallback models)을 즉시 설정하며, 새로고침/재시도 (refresh/retry) 동작을 명시적으로 유지합니다.
Kimi Code가 이제 엔드 투 엔드 (end to end)로 지원됩니다
Kimi는 CLI 실행, 프로바이더 라벨 (provider labels), 스킬 학습/미학습 (skills learn/unlearn) 흐름, 프롬프트-스킬 렌더링 (prompt-skill rendering), 비디오-사전 제작 부트스트랩 (video-preprod bootstrap), 그리고 프로바이더 인지 스키마/런타임 (provider-aware schema/runtime) 체크를 통해 연결됩니다.
API 모델 할당이 이제 개발 팩 (development pack)에서 시작하여 초기화된 오피스 팩 (office packs)으로 확장됩니다
development는 기본 베이스라인으로 유지되며, 초기 설정을 통해 이미 하이드레이션 (hydrated)된 오피스 팩들도 할당 대상(assign targets)으로 나타납니다.
로컬 E2E 검증이 더 안전하고 깔끔해졌습니다
pnpm run test:e2e는 이제 Playwright 실행 전후로 격리된 런타임 (isolated runtime)을 리셋하며, 기존의 8810 서버는 명시적으로 옵트인 (opt in)하지 않는 한 더 이상 재사용되지 않습니다.

전체 노트:

docs/releases/v2.0.4.md

API 문서:

docs/api.md, docs/openapi.json

보안 정책:

SECURITY.md

각 오피스 팩은 서로 다른 협업 토폴로지 (collaboration topology), 네이밍 시드 (naming seed), 그리고 워크플로우 편향 (workflow bias)을 적용합니다.

팩 (Pack)	핵심 초점 (Core Focus)	대표 구조 (Representative Structure)
`development` (`DEV`)	하위 호환 가능한 동작을 갖춘 기본 엔지니어링 베이스라인 (Default engineering baseline)	계획 (Planning) / 개발 (Development) / 설계 (Design) / QA-QC / DevSecOps / 운영 (Operations)
`report` (`RPT`)	구조화된 보고서 및 문서 생성 (Structured report and document production)	편집 계획 (Editorial Planning), 리서치 엔진 (Research Engine), 문서 설계 (Doc Design), 검토 데스크 (Review Desk)
`web_research_report` (`WEB`)	소스 수집 및 인용 우선의 사실 검증 (Source collection and citation-first fact validation)	리서치 전략 (Research Strategy), 크롤러 팀 (Crawler Team), 사실 확인 (Fact Check)
`novel` (`NOV`)	세계관 구축 (Worldbuilding), 서사 흐름 (Narrative flow), 그리고 톤 일관성 (Tone consistency)	세계관 구축 (Worldbuilding), 서사 엔진 (Narrative Engine), 캐릭터 아트 (Character Art), 톤 QA (Tone QA)
`video_preprod` (`VID`)	컨셉/스크립트/샷 리스트/편집 노트 프리프로덕션 (Concept/script/shot-list/editing-note pre-production)	프리프로덕션 (Pre-production), 장면 엔진 (Scene Engine), 아트 및 카메라 (Art & Camera), 컷 QA (Cut QA)
`roleplay` (`RPG`)	캐릭터 몰입형 대화 및 역할 일관성 (In-character dialogue immersion and role consistency)	캐릭터 계획 (Character Planning), 대화 엔진 (Dialogue Engine), 스테이지 아트 (Stage Art), 캐릭터 QA (Character QA)

미리보기 샘플 인트로 영상 출력:

직접 파일:
Sample_Img/claw-empire-intro.mp4

보고서-PPT 생성 (report-to-PPT generation) 기능을 검토하거나 확장할 때 아래의 샘플 소스를 사용하십시오:
사용 경로: 채팅창 > 보고서 요청 (Report Request) 버튼, 그 다음 요청 사항을 입력하십시오.

폴더:
docs/reports/Sample_Slides
샘플 덱 (.pptx):
docs/reports/PPT_Sample.pptx
HTML 슬라이드:
slide-01.html, slide-02.html, slide-03.html, slide-04.html, slide-05.html, slide-06.html, slide-07.html, slide-08.html, slide-09.html
빌드 스크립트 (Build scripts):
build-pptx.mjs, build-pptx.cjs, html2pptx.cjs

기능	설명
픽셀 아트 사무실 (Pixel-Art Office)	6개 부서에 걸쳐 에이전트(Agents)들이 걷고, 일하고, 회의에 참석하는 애니메이션 사무실 뷰
워크플로우 팩 프로필 (Workflow Pack Profiles)	6개의 내장 워크플로우 팩 (`development`, `report`, `web_research_report`, `novel`, `video_preprod`, `roleplay`)이 팩별 라우팅 스키마 (Routing schema), QA 규칙, 출력 템플릿을 제공
오피스 팩 프로필 (Office Pack Profiles)	팩 범위의 오피스 프로필은 팩별로 전용 부서 토폴로지 (Topology), 명칭/테마 프리셋, 격리된 에이전트/부서 데이터를 적용 (DB 기반의 development 베이스라인 제외)
칸반 작업 보드 (Kanban Task Board)	드래그 앤 드롭을 지원하는 전체 작업 라이프사이클 — 받은 편지함 (Inbox), 계획됨 (Planned), 협업 중 (Collaborating), 진행 중 (In Progress), 검토 중 (Review), 완료 (Done)
CEO 채팅 및 지시 (CEO Chat & Directives)	팀 리더들과의 직접적인 소통; `$` 지시어는 회의 선택과 더불어 프로젝트 경로/컨텍스트 라우팅 (`project_path`, `project_context`)을 지원
멀티 프로바이더 지원 (Multi-Provider Support)	Claude Code, Codex CLI, Gemini CLI, OpenCode, Kimi Code, Antigravity — 모두 하나의 대시보드에서 사용 가능
외부 API 프로바이더 (External API Providers)	설정(Settings) > API 탭을 통해 에이전트를 외부 LLM API (OpenAI, Anthropic, Google, Ollama, OpenRouter, Together, Groq, Cerebras, 커스텀)에 연결, OpenCode Go 및 Bailian Coding Plan을 위한 공식 프리셋 제공
OAuth 통합 (OAuth Integration)	로컬 SQLite에 AES 암호화된 토큰 저장 방식으로 GitHub 및 Google OAuth 지원
실시간 웹소켓 (Real-time WebSocket)	실시간 상태 업데이트, 활동 피드, 에이전트 상태 동기화
활성 에이전트 제어 (Active Agent Control)	프로세스/활동/유휴(Idle) 메타데이터를 포함한 활성 에이전트 모니터 및 멈춘 작업을 위한 직접 종료(Kill) 액션
작업 보고 시스템 (Task Report System)	완료 팝업, 보고 이력, 팀 보고서 상세 보기(Drilldown), 기획 리더 통합 아카이브
에이전트 관리 (Agent Management)	다국어 이름, 역할/부서/프로바이더 선택, 성격(Personality) 필드를 포함한 에이전트 채용, 편집 및 삭제
에이전트 랭킹 및 XP (Agent Ranking & XP)	에이전트는 완료된 작업에 대해 XP를 획득하며, 랭킹 보드에서 상위 성과자를 추적
기술 라이브러리 (Skills Library)

600개 이상의 카테고리화된 기술 (Frontend, Backend, Design, AI, DevOps, Security 등) 및 사용자 정의 기술 업로드 지원 |
회의 시스템 (Meeting System) |
AI가 생성한 회의록과 다회차 검토를 포함한 계획된 회의 및 즉석 회의 |
Git Worktree 격리 (Git Worktree Isolation) |
각 에이전트는 격리된 git 브랜치에서 작업하며, CEO의 승인 시에만 병합됨 |
다국어 UI (Multi-Language UI) |
영어, 한국어, 일본어, 중국어 — 자동 감지 또는 수동 설정 |
메신저 통합 (Messenger Integration) |
Telegram, Discord, Slack 등 — $ CEO 지시사항을 전송하고 내장된 직접 채널 세션(OpenClaw 선택 사항)을 통해 업데이트를 수신함 |
PowerPoint 내보내기 (PowerPoint Export) |
회의록 및 보고서로부터 발표 슬라이드 생성 |
연결성 QA 스크립트 (Connectivity QA Scripts) |
재시도 및 증거 로그를 포함하여 CLI/OAuth/API 통신 검증을 위한 내장 test:comm:* 스크립트 제공 |
앱 내 업데이트 알림 (In-App Update Notice) |
GitHub의 최신 릴리스를 확인하고, 새 버전이 사용 가능한 경우 OS별 git pull 안내가 포함된 상단 배너를 표시함 |
부서 관리 (Department Management) |
기획, 개발, 디자인, QA/QC, DevSecOps, 운영 — 화살표/드래그 앤 드롭 정렬 순서 편집을 위한 전용 관리 탭 포함 |
수동 에이전트 할당 (Manual Agent Assignment) |
특정 에이전트를 프로젝트에 할당; 회의/위임 시 수동 선택 사항을 준수하며, 에이전트 없음 또는 리더만 선택된 경우를 대비한 저장 전 보호 기능 제공 |
스프라이트 등록 안전성 (Sprite Registration Safety) |
충돌하는 업로드를 명시적인 409 sprite_number_exists 응답으로 거부하여 중복된 스프라이트 번호 파일 덮어쓰기 방지 |
사용자 정의 기술 업로드 (Custom Skill Upload) |
UI를 통해 .md 기술 파일을 업로드하여 사용자 정의 기술을 가진 CLI 대표를 훈련시키며, 강의실 훈련 애니메이션 및 관리 인터페이스를 제공함 |

계층 (Layer)	기술 (Technology)
Frontend	React 19 + Vite 7 + Tailwind CSS 4 + TypeScript 5.9
Pixel Art 엔진	PixiJS 8
Backend	Express 5 + SQLite (설정 없는 임베디드 DB)
실시간 (Real-time)	WebSocket (ws)
검증 (Validation)	Zod 4
아이콘 (Icons)	Lucide React
라우팅 (Routing)	React Router 7
내보내기 (Export)	PptxGenJS (PowerPoint 생성)

이 섹션은 AI 코딩 에이전트 (AI coding agents)를 위한 것입니다. 다음 단계로 넘어가기 전에 각 단계를 실행하고 검증 명령어를 실행하십시오.

# Node.js 22+
node -v
# pnpm (또는 corepack 활성화)
...

git clone https://github.com/GreenSheep01201/claw-empire.git
cd claw-empire
git submodule update --init --recursive
...

Windows PowerShell:

git clone https://github.com/GreenSheep01201/claw-empire.git
cd claw-empire
git submodule update --init --recursive
...

macOS/Linux:

# 설정 후 필수 파일 확인
[ -f .env ] && [ -f scripts/setup.mjs ] && echo "setup files ok"
# AGENTS 오케스트레이션 (orchestration) 규칙 설치됨
...

Windows PowerShell:

if ((Test-Path .\.env) -and (Test-Path .\scripts\setup.mjs)) { "setup files ok" }
$agentCandidates = @("$env:USERPROFILE\.openclaw\workspace\AGENTS.md", ".\AGENTS.md")
$agentCandidates | ForEach-Object { if (Test-Path $_) { Select-String -Path $_ -Pattern "BEGIN claw-empire orchestration rules" } }
...

pnpm dev:local

다른 터미널에서:

curl -s http://127.0.0.1:8790/healthz

예상 결과: {"ok":true,...}

메신저 채널 (Messenger channels)은 설정 UI (Settings UI)에서 구성되며 SQLite (settings.messengerChannels)에 저장됩니다. .env 파일의 메신저 토큰/채널 변수는 더 이상 사용되지 않습니다.

curl -s http://127.0.0.1:8790/api/messenger/sessions

이 명령은 설정에 저장된 메신저 세션 (messenger sessions)을 반환합니다.

curl -X POST http://127.0.0.1:8790/api/inbox \
-H "content-type: application/json" \
-H "x-inbox-secret: $INBOX_WEBHOOK_SECRET" \
...

예상 결과:

200: INBOX_WEBHOOK_SECRET이 구성되어 있고 x-inbox-secret이 일치할 때.
401: 헤더가 누락되었거나 일치하지 않을 때.
503: 서버에 INBOX_WEBHOOK_SECRET이 구성되어 있지 않을 때.

OpenClaw 없이 Claw-Empire에서 직접 메신저 채널을 실행할 수 있습니다.

Settings > Channel Messages를 엽니다.
Add Chat을 클릭합니다.
메신저를 선택합니다 (telegram, whatsapp, discord, googlechat, slack, signal, imessage).
세션 필드를 채웁니다: Name

(세션 라벨)- 메신저 토큰/자격 증명 (messenger token/credential)
Channel/Chat ID

(대상)- 매핑된 대화 (mapped conversation)
Agent

클릭
Confirm

즉시 저장하려면 클릭하세요 (별도의 전역 저장 단계가 필요하지 않음). 세션을 활성화한 후 테스트하십시오:

일반 메시지 -> 에이전트 직접 채팅
$ ...

-> 지시 흐름 (directive flow)

참고 사항:

메신저 세션은 SQLite (settings.messengerChannels)에 유지됩니다.
메신저 토큰은 OAUTH_ENCRYPTION_SECRET (fallback: SESSION_SECRET)을 사용하여 저장 시 암호화(AES-256-GCM)되며, 런타임(runtime)에만 복호화됩니다.
.env 메신저 변수 (TELEGRAM_BOT_TOKEN, DISCORD_BOT_TOKEN, SLACK_BOT_TOKEN 등)는 사용되지 않습니다.
/api/inbox + INBOX_WEBHOOK_SECRET은 웹훅/인박스(webhook/inbox) 흐름(OpenClaw 브리지 포함)에만 필요합니다.

이 저장소는 이제 운영 환경 지향적인 Docker 기본 설정을 제공합니다:

non-root 사용자 (app, uid/gid 10001)로 실행됩니다.
필수 CLI/런타임 도구 (git, bash, openssh-client)를 포함합니다.
docker-compose.yml + Dockerfile을 사용합니다.
런타임 데이터를 ./data에 유지합니다 (이미 gitignored 처리됨).

cp .env.example .env.docker

민감한 런타임 비밀값(sensitive runtime secrets)을 위해 .env.docker.private를 생성하십시오 (이 파일은 로컬에만 보관하십시오):

cat > .env.docker.private <<'EOF'
# 호환 가능한 엔드포인트를 통한 Claude Code
ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic
...

.env.docker*는 git에 의해 무시되므로 (.env.*), 토큰이 기본적으로 커밋되지 않습니다.

docker compose up -d --build

docker ps --filter name=claw-empire
docker logs -f claw-empire

열기: http://127.0.0.1:8790

# package write 권한이 있는 토큰이 필요합니다
echo "<GITHUB_TOKEN_WITH_PACKAGES_WRITE>" | docker login ghcr.io -u <github-user> --password-stdin
docker tag claw-empire-claw-empire:latest ghcr.io/<github-user>/claw-empire:latest
...

도구	버전	설치
Node.js	>= 22	nodejs.org
pnpm	latest	`corepack enable` (Node.js에 내장됨)
Git	any	git-scm.com

GreenSheep01201/claw-empire

요약

핵심 포인트

댓글