Paperclip: 내 AI 에이전트 팀을 회사처럼 굴리는 오픈소스 도구

AI 에이전트를 하나씩 쓰다 보면 '누가 뭘 하지?' '비용이 얼만데?' 같은 질문이 꼬리를 뭅니다. Paperclip은 에이전트들을 채용·배치·감독하는 가상 회사 운영체제 역할을 합니다.

Paperclip이란 무엇인가요

Paperclip은 AI 에이전트 팀을 회사처럼 운영하도록 돕는 오픈소스 오케스트레이션 도구예요. 저장소는 paperclipai/paperclip이고, MIT 라이선스로 공개돼 있어요. 6개월 전(2026년 3월)에 처음 만들어졌고, 이번 달(2026년 9월)에도 업데이트가 이어지고 있어요. 주 언어는 TypeScript이며, 현재 스타 83,961개·포크 15,171개를 기록 중이에요.

핵심 워크플로 3단계

지원하는 에이전트 런타임

Quickstart·Docs·GitHub·Discord·Twitter·Website 링크가 README에 정리돼 있으니, 바로 시작하려면 Quickstart를 따라 해보세요.

왜 Paperclip을 쓰나요

AI 에이전트 여러 대를 동시에 굴리다 보면 누가 무슨 일을 하는지, 비용이 얼마나 드는지, 목표가 맞게 가고 있는지 한눈에 보기 어렵습니다. Paperclip은 이 분산 관리·비용 추적·목표 정렬 문제를 하나의 대시보드에서 해결하도록 설계된 오픈소스 오케스트레이션 도구예요.

운영 흐름 3단계

지원하는 에이전트 런타임

• OpenClaw
• Claude Code
• Codex
• Cursor
• Bash
• HTTP (하트비트만 받으면 채용 가능)

설치·첫 팀 실행 3단계

Paperclip은 Node.js 서버와 React UI로 구성돼 있어요. 저장소를 복제한 뒤 의존성을 설치하고 서버를 띄우면 브라우저에서 대시보드에 바로 접속할 수 있어요.

git clone https://github.com/paperclipai/paperclip
cd paperclip
npm install
npm run dev

1. 1. 목표 정의

   대시보드 상단 ‘Goal’ 입력란에 비즈니스 목표를 한 문장으로 적어요. 예: "AI 회의록 서비스로 월 매출 1억 원 달성"

2. 2. 팀 구성

   ‘Team’ 탭에서 역할을 추가하고 각 역할에 연결할 에이전트(OpenClaw, Claude Code, Codex, Cursor, Bash, HTTP 등)를 지정해요. 하트비트만 받으면 어떤 봇이든 고용 가능해요.

3. 3. 예산·승인·실행

   ‘Budget’에서 총 비용 상한과 역할별 한도를 설정한 뒤 ‘Approve & Run’을 누르면 에이전트 팀이 작업을 시작해요. 진행 상황과 비용은 실시간 대시보드에서 확인할 수 있어요.

한눈에 보는 주요 기능 비교

Paperclip은 Claude Code, Codex, Cursor, OpenClaw, Bash, HTTP 등 심비트(heartbeat)만 주고받을 수 있으면 어떤 에이전트든 팀원으로 고용할 수 있어요. 공급사나 프레임워크에 구애받지 않고 한 대시보드에서 목표·예산·거버넌스를 함께 관리하는 것이 핵심 강점입니다.

표에 나온 기능은 Node.js 서버 + React UI 위에서 통합 동작하며, 저장소(paperclipai/paperclip, MIT 라이선스, 83,961★)에서 전체 코드를 확인할 수 있어요. 6개월 전(2026년 3월) 처음 만들어졌고, 마지막 업데이트는 이번 달(2026년 9월)입니다.

주의할 점

Paperclip을 도입하기 전에 몇 가지 체크포인트를 확인해 주세요. 이 도구는 MIT 라이선스로 공개돼 자유롭게 사용할 수 있지만, 6개월 전(2026년 3월) 에 처음 만들어졌고 이번 달(2026년 9월) 에 마지막 업데이트가 되었습니다. 아직 초기 단계라서 버그나 기능 변화가 있을 가능성이 있습니다. 또한 자체 호스팅이 전제이기 때문에 Node.js와 React 환경을 직접 구축·운영해야 하며, 이를 위한 서버 관리와 보안 책임도 사용자가 집니다.

에이전트를 Paperclip에 연결하려면 ‘heartbeat’를 받을 수 있는지 확인해야 합니다. README에 따르면 heartbeat을 받을 수 있는 모든 봇을 고용할 수 있다고 하니, 기존에 사용 중인 에이전트가 이 프로토콜을 지원하는지 먼저 검증하는 것이 좋습니다. 또한, 현재 TypeScript 기반으로 개발돼 있어 TypeScript 혹은 JavaScript 환경에 익숙한 팀이라면 더 원활하게 커스터마이징할 수 있습니다.

git clone https://github.com/paperclipai/paperclip

1. 라이선스 검토

   MIT 조항을 읽고, 보증 없음에 대한 위험을 팀 내에서 공유합니다.

2. 버전 안정성 확인

   최근 커밋과 이슈 현황을 확인해 버그와 패치 빈도를 파악합니다.

3. 인프라 준비

   Node.js와 React를 실행할 서버 환경을 구축하고, 포트·보안 설정을 점검합니다.

4. 에이전트 호환성 테스트

   heartbeat 전송이 가능한 에이전트를 하나씩 연결해 정상 동작을 확인합니다.

• ⭐ 현재 별 83,961개, 포크 15,171개 – 활발한 커뮤니티가 존재합니다.
• 🛠️ 주요 언어는 TypeScript이며, TypeScript 환경에 익숙하면 커스터마이징이 용이합니다.

• 라이선스 조항 정리
• 서버 사양 검토 및 프로비저닝
• heartbeat 테스트 스크립트 작성

도입 전 최종 체크리스트

정리 및 다음 단계

Paperclip은 공식 Docs, Discord, 그리고 GitHub 저장소를 통해 다양한 지원을 제공해요. Docs 페이지에서는 설치부터 팀 운영까지 단계별 가이드를 확인할 수 있고, Discord에서는 실시간 질문과 팁을 주고받을 수 있어요. 또한 GitHub 이슈 트래커를 활용하면 버그 신고·기능 요청·사용 사례 공유가 간편하게 이루어집니다.

1. Docs 확인

   Quickstart 가이드를 따라 로컬 서버를 띄우고, 대시보드에서 목표·예산·에이전트를 설정해 보세요.

2. Discord 가입

   공식 Discord 채널에 들어가 다른 사용자들의 활용 사례를 듣고, 궁금한 점을 바로 물어볼 수 있어요.

3. GitHub 이슈 활용

   버그나 개선 아이디어가 있으면 이슈를 열어 개발자와 직접 소통하고, 이미 올라온 토론을 참고해 프로젝트를 확장해 보세요.

• 원문 보기