Paperclip은 AI 에이전트 팀을 실제 회사 조직처럼 운영할 수 있는 오픈소스 오케스트레이션 플랫폼이다. Node.js 서버와 React UI로 구성되며, 에이전트에게 직함·보고 체계·예산·목표를 부여하고 대시보드 하나로 모든 작업을 추적한다. GitHub 스타 57.4k, 포크 9.9k로 에이전트 오케스트레이션 분야에서 가장 주목받는 프로젝트 중 하나다.
“openclaw가 _직원_이라면, Paperclip은 _회사_다”
어떤 문제를 해결하나
Claude Code 탭을 20개 띄워두고 각자 무엇을 하는지 파악이 안 되는 상황, 에이전트가 루프에 빠져 수백 달러를 태우는 사태, 매번 맥락을 수동으로 재구성해줘야 하는 번거로움을 Paperclip이 정리한다.
| 기존 방식 | Paperclip 방식 |
|---|---|
| 탭 20개 열고 각자 뭐 하는지 불분명, 재부팅 시 초기화 | 티켓 기반 대화, 리부팅 후에도 세션 유지 |
| 에이전트에게 맥락을 매번 수동 전달 | 태스크→프로젝트→회사 목표까지 컨텍스트 자동 전파 |
| 무한 루프로 토큰 예산 초과 | 에이전트별 월 예산 한도, 초과 시 자동 중단 |
| 정기 작업을 수동으로 실행 | 하트비트 스케줄러로 자동 실행, 관리자가 감독 |
핵심 개념
조직도(Org Chart) & 목표 정렬
에이전트에게 CEO·CTO·엔지니어·마케터 등 역할을 부여하고 보고 체계를 설정한다. 모든 태스크는 회사 미션까지 거슬러 올라가는 목표 계층을 갖기 때문에 에이전트는 “무엇을” 할지만이 아니라 “왜” 하는지도 맥락으로 알고 있다.
하트비트(Heartbeat)
에이전트는 스케줄에 따라 깨어나 담당 작업을 확인하고 행동한다. 위임은 조직도 위아래로 흐른다. 고객 지원, SNS 포스팅, 정기 리포트 등 반복 작업에 적합하다.
티켓 시스템 & 감사 로그
모든 대화와 도구 호출이 추적되고 변경 불가한 감사 로그로 기록된다. 어떤 에이전트가 어떤 결정을 내렸는지 항상 되짚을 수 있다.
비용 통제
에이전트별 월 예산을 설정하면 한도 도달 시 자동으로 멈춘다. 관리 계층이 예산 우선순위를 조정할 수 있다.
거버넌스
사용자가 “이사회” 역할을 맡아 채용 승인, 전략 수정, 에이전트 일시 중지·해고를 언제든 할 수 있다. 설정 변경은 버전 관리되어 롤백이 가능하다.
지원 에이전트
Paperclip은 특정 에이전트 프레임워크에 종속되지 않는다. 하트비트를 수신할 수 있으면 어떤 런타임이든 연결된다.
- openclaw, Claude Code, OpenAI Codex, Cursor
- Bash 스크립트, HTTP 엔드포인트
- 커스텀 에이전트 (어댑터 플러그인 방식)
설치
# 원클릭 온보딩
npx paperclipai onboard --yes
# 수동 설치
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm devAPI 서버가 http://localhost:3100에서 실행된다. 내장 PostgreSQL이 자동 생성되므로 별도 DB 설정이 불필요하다.
요구 사항: Node.js 20+, pnpm 9.15+
Clipmart (출시 예정)
한 번의 클릭으로 완성된 회사 구조를 내려받아 실행하는 마켓플레이스. 조직도·에이전트 설정·스킬이 포함된 회사 템플릿을 임포트할 수 있다.
라이선스 & 관련 문서
- 라이선스: MIT
- GitHub: paperclipai/paperclip ★57.4k
- 공식 문서: https://paperclip.ing/docs
관련 토픽: openclaw · agent-governance · gastown · multica · claude-code