AI ToolsEN

Paperclip — AI 에이전트로 "무인 회사"를 운영하는 오픈소스 프레임워크

3주 만에 GitHub 3만 스타. AI 에이전트들을 조직도, 예산, 거버넌스로 관리하는 오픈소스 멀티에이전트 오케스트레이션 플랫폼. Heartbeat 시스템, 에이전트별 월 예산, 회사 템플릿까지.

Paperclip — AI 에이전트로 "무인 회사"를 운영하는 오픈소스 프레임워크

Paperclip: AI 에이전트로 "무인 회사"를 만드는 오픈소스 프레임워크

AI 에이전트 하나 잘 쓰는 건 이제 보통이다. Paperclip은 에이전트 여러 개를 조직으로 묶어서 회사처럼 운영하는 오픈소스 프레임워크다. 2026년 3월 출시 3주 만에 GitHub 스타 3만 개를 돌파했고, 현재 4.3만 스타를 넘겼다.

"OpenClaw가 직원 한 명이라면, Paperclip은 회사 전체다."

핵심 컨셉: 에이전트 오케스트레이션 ≠ 에이전트 프레임워크

Paperclip이 CrewAI나 AutoGen과 다른 점은 명확하다:

CrewAI / AutoGenPaperclip
메타포팀 / 파이프라인회사
구조에이전트 간 메시지 전달조직도, 예산, 거버넌스
에이전트 런타임자체 프레임워크 내장BYOA (Bring Your Own Agent)
실행 방식코드에서 호출Heartbeat 스케줄 (4/8/12시간)
비용 관리없음에이전트별 월 예산 + 자동 정지

Paperclip은 에이전트를 만드는 도구가 아니다. 이미 있는 에이전트(Claude Code, OpenClaw, Codex, Python 스크립트, HTTP 웹훅 등)를 가져와서 조직으로 편성하는 오케스트레이션 레이어다.

아키텍처: 진짜 회사처럼

조직도

이사회 (당신)
└── CEO 에이전트
    ├── CTO 에이전트
    │   ├── 백엔드 엔지니어
    │   └── QA 엔지니어
    ├── 마케팅 디렉터
    │   └── 카피라이터
    └── 리서치 스페셜리스트
  • 목표는 위에서 아래로 흐른다 (CEO → 부서장 → 실무자)
  • 결과는 아래에서 위로 올라간다
  • 각 에이전트는 자기 하위 에이전트를 스폰할 수도 있다 (재귀 구조)
  • 당신은 이사회다. 채용 승인, 전략 오버라이드, 에이전트 일시정지/종료 권한

4개의 지시 파일: Memento Man 문제 해결

AI 에이전트는 깨어날 때마다 자기가 누구인지, 뭘 하고 있었는지 모른다. Paperclip은 이걸 4개 파일로 해결한다:

파일역할
AGENTS.md핵심 정체성 — 역할, 목표, 메모리 사용법
HEARTBEAT.md실행 체크리스트 — 깨어날 때마다 따르는 순서
SOUL.md성격 — 의사결정 스타일, 우선순위
TOOLS.md도구 — 사용 가능한 도구와 사용 프로토콜

Heartbeat 시스템

에이전트는 상시 실행이 아니다. 4시간/8시간/12시간마다 "심박"처럼 깨어난다:

  1. API로 자기 정체성 확인
  2. 인박스 확인 (할당된 태스크, @멘션)
  3. 작업 체크아웃 (중복 처리 방지)
  4. 태스크 실행
  5. 메모리 저장
  6. 진행 상황 보고
  7. 종료

이벤트 기반 트리거도 있다 — 직접 태스크 할당이나 @멘션이 달리면 즉시 깨어난다.

비용 제어: 이게 핵심이다

2026년 AI 에이전트의 가장 큰 문제는 비용 폭발이다. 에이전트가 실패해서가 아니라 성공해서 문제다 — 자율적으로 돌아가다가 API 비용이 하루 만에 수만 달러 찍히는 사례가 속출했다.

Paperclip의 3단계 예산 시스템:

단계임계값동작
소프트 경고80%알림 발송, 에이전트 계속 작업
하드 스톱100%에이전트 자동 일시정지
서킷 브레이커비정상 패턴시스템이 이상 지출 감지 시 차단

에이전트별 월 예산 예시:

  • CEO: $50/월
  • 리서처: $100/월
  • 카피라이터: $75/월
  • QA: $40/월

Claude Code Max 구독($200/월)이 있으면 대시보드에 $0으로 표시된다 — 구독 할당량을 쓰기 때문.

빠른 시작: 10분이면 "회사" 하나

설치

bash
npx paperclipai onboard --yes

이 한 줄이:

  • Paperclip CLI 다운로드
  • 임베디드 PostgreSQL 생성 (~/.paperclip/instances/default/)
  • 설정 파일 생성
  • 스킬 설치 (~/.claude/skills/)
  • 서버 시작 (http://localhost:3100)

요구사항: Node.js 20+, pnpm 9.15+

또는 직접 클론

bash
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

회사 만들기 (5단계)

  1. 대시보드에서 회사 이름 + 미션 입력
  2. CEO 에이전트 생성 (Claude Code 또는 원하는 런타임)
  3. CEO에게 첫 태스크 할당: "팀 구성하고 전략 짜줘"
  4. CEO가 채용 요청 → 이사회(당신)가 승인
  5. 조직 완성, 자동 운영 시작

실전 예시: LeadForge (AI 리드 제너레이션 회사)

Paperclip 공식 튜토리얼에서 제시하는 예시다:

미션: B2B 잠재고객을 발굴하고, 개인화된 아웃리치 시퀀스를 만들어, 검증된 리드를 클라이언트에게 전달

조직:

이사회 (당신)
└── CEO (Claude Opus 4.6, $50/월)
    ├── 리드 리서치 스페셜리스트 (Sonnet 4.6, $100/월)
    ├── 아웃리치 카피라이터 (Sonnet 4.6, $75/월)
    └── QA 스페셜리스트 (Sonnet 4.6, $40/월)

자동화 루틴:

  • 매일 10시: QA가 지난 24시간 리드 검토 + 정확도 검증 + 리포트
  • 매일 8시: 카피라이터가 아웃리치 초안 작성
  • 매주 월요일 9시: CEO가 전략 리뷰

워크플로우 캐스케이드:

  1. 당신이 리서치 이슈 생성
  2. CEO가 분해해서 리서처에게 할당
  3. 리서처 완료 → @카피라이터 멘션
  4. 카피라이터 초안 작성 → @QA 멘션
  5. QA 승인 또는 피드백

이 전체 과정이 여러 Heartbeat 사이클에 걸쳐 자율적으로 돌아간다.

스킬 시스템과 회사 템플릿

스킬

스킬은 에이전트에게 특정 프로세스를 가르치는 마크다운 지시 파일이다. GitHub URL로 추가하면 자동 업데이트된다.

회사 전체에 적용하는 스킬과, 특정 에이전트에게만 적용하는 스킬을 구분할 수 있다.

주의: 서드파티 스킬의 보안은 보장되지 않는다. skills.sh 같은 플랫폼이 보안 감사 배지를 제공하지만 100% 안전하다고 할 수 없다.

회사 템플릿

github.com/paperclipai/companies에서 미리 만들어진 조직 구조를 임포트할 수 있다:

템플릿구성
GStackCTO, QA 엔지니어, 릴리즈 엔지니어
Agency Agents100+ 페르소나
Game Studio크리에이티브 디렉터, 프로듀서, 기술 디렉터
Scientific Research전문 지식 에이전트

솔직한 한계

1. "무인 회사"는 아직 이상에 가깝다

"zero-human company"라는 마케팅 문구와 달리, 실제로 Paperclip만으로 운영되는 회사의 사례는 아직 공개되지 않았다. 비즈니스, 법률, 재무 관련 결정은 여전히 사람이 해야 한다.

2. 비용이 만만치 않다

멀티에이전트 세션은 토큰을 많이 소비한다. Claude Code Max($200/월)가 사실상 필수이고, 여러 에이전트를 API 크레딧으로 돌리면 비용이 빠르게 올라간다.

3. 기술 진입 장벽

CLI, 환경 변수, pnpm — 노코드 경험이 아니다. 개발자가 아니면 셋업이 어렵다.

4. 품질 변동성

에이전트의 출력은 기반 모델의 능력에 의존한다. 코드 에이전트는 괜찮지만, 마케팅이나 전략 에이전트의 출력은 불안정할 수 있다.

누가 쓰면 좋은가?

적합:

  • 멀티에이전트 오케스트레이션을 실험하고 싶은 개발자
  • AI 에이전트 비용 관리가 절실한 팀
  • 반복적 업무를 에이전트 팀으로 자동화하고 싶은 스타트업

부적합:

  • 노코드 솔루션을 원하는 비개발자
  • 에이전트 하나로 충분한 작업
  • 프로덕션 레벨의 안정성이 필요한 기업 (아직 초기 단계)

마무리

Paperclip은 "AI 에이전트 시대의 다음 질문"에 답하려는 시도다:

에이전트 하나는 잘 된다. 그런데 여러 개를 어떻게 조직하고, 관리하고, 비용을 통제하나?

조직도, 예산 관리, 거버넌스, 감사 로그 — 이런 걸 오픈소스로 제공하는 건 Paperclip이 처음이다. 3주 만에 3만 스타를 찍은 이유도 이 질문이 그만큼 절실했기 때문이다.

"무인 회사"는 아직 먼 이야기지만, 멀티에이전트 오케스트레이션의 구조와 패턴을 이해하는 출발점으로는 충분하다. 특히 비용 제어 시스템은 2026년 AI 에이전트 운영의 가장 현실적인 문제를 정면으로 다루고 있다.

참고 자료

🔒

이어서 읽으려면 로그인이 필요합니다

무료 회원가입으로 전체 콘텐츠를 확인하세요.

관련 포스트