paperclipai/paperclip

The open-source app everyone uses to manage agents at work

73,255
GitHub 스타
13,655
포크
TypeScript
언어
MIT
라이선스
2026.07.10
최근 푸시
2026.05.10
별표한 날

AI 분석

설치 난이도: 보통
큐레이터 노트
Paperclip은 여러 AI 에이전트를 조정하여 비즈니스 목표를 달성하려는 팀이나 개인에게 적합합니다. 특히 자율 에이전트 회사를 구축하거나, 다양한 에이전트를 통합 관리해야 하는 경우 유용합니다. 단, 에이전트 자체는 별도로 준비해야 하며, 초기 설정에 시간이 필요할 수 있습니다.

강점

  • 에이전트 오케스트레이션을 위한 완전한 제어판 제공 (조직도, 예산, 거버넌스, 티켓 시스템 등)
  • 다양한 에이전트(Claude Code, Codex, Cursor, OpenClaw 등)와 호환되며 하트비트 기반 통합
  • 원자적 실행, 영구 상태, 롤백 가능한 거버넌스 등 고급 기능 내장
  • 다중 회사 격리 및 모바일 지원으로 확장성과 접근성 우수

약점

  • README에 설치 방법이나 빠른 시작 가이드가 명시적으로 포함되지 않음
  • Node.js 서버와 React UI 기반으로 배포 및 운영에 일정 수준의 인프라 지식 필요
  • 에이전트 자체를 제공해야 하므로 Paperclip만으로는 완전한 자율 에이전트를 구성할 수 없음

주의사항

  • README가 매우 길고 상세하지만, 실제 사용을 위한 구체적인 설정 단계는 문서 사이트(paperclip.ing/docs)를 참조해야 함
  • 오픈소스 프로젝트로 활발히 개발 중이므로 버전 변경에 따른 호환성 주의
  • 비용 제어 기능이 있지만, 에이전트 실행 비용은 사용자가 직접 관리해야 함

시작 가이드

  • Paperclip 문서(paperclip.ing/docs)를 방문하여 설치 및 빠른 시작 가이드를 확인하세요.
  • 자체 AI 에이전트(예: Claude Code, Codex)를 준비하고 Paperclip과 통합하는 방법을 학습하세요.
  • 데모 비디오를 시청하여 실제 워크플로를 이해한 후, 간단한 목표로 테스트 배포를 진행하세요.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

<p align="center"> <img src="doc/assets/banner.jpg" alt="Paperclip은 업무용 AI 에이전트를 관리하는 앱입니다." width="720" /> </p>

<p align="center"> <a href="#quickstart"><strong>빠른 시작</strong></a> &middot; <a href="https://paperclip.ing/docs"><strong>문서</strong></a> &middot; <a href="https://github.com/paperclipai/paperclip"><strong>GitHub</strong></a> &middot; <a href="https://discord.gg/m4HZY7xNG3"><strong>Discord</strong></a> &middot; <a href="https://x.com/papercliping"><strong>Twitter</strong></a> &middot; <a href="https://paperclip.ing"><strong>웹사이트</strong></a> </p>

<br/>

<div align="center"> <video src="https://github.com/user-attachments/assets/773bdfb2-6d1e-4e30-8c5f-3487d5b70c8f" width="600" controls></video> </div>

<br/>

Paperclip은 사람들이 업무용 AI 에이전트를 관리하는 데 사용하는 앱입니다.

AI 에이전트 팀을 위한 오픈소스 오케스트레이션.

OpenClaw가 '직원'이라면, Paperclip은 '회사'입니다.

Paperclip은 비즈니스를 운영하기 위해 AI 에이전트 팀을 오케스트레이션하는 Node.js 서버 및 React UI입니다. 자체 에이전트를 가져오고, 목표를 할당하며, 하나의 대시보드에서 작업과 비용을 추적하세요.

작업 관리자처럼 보입니다. 내부적으로는 조직도, 예산, 거버넌스, 목표 정렬, 에이전트 조정이 이루어집니다.

Pull Request가 아닌 비즈니스 목표를 관리하세요.

단계 예시
01 목표 정의 "#1 AI 노트 앱을 만들어 월 매출 100만 달러 달성"
02 팀 고용 CEO, CTO, 엔지니어, 디자이너, 마케터 — 모든 봇, 모든 제공자.
03 승인 및 실행 전략 검토. 예산 설정. 시작. 대시보드에서 모니터링.

<br/>

<div align="center"> <table> <tr> <td align="center"><strong>호환</strong></td> <td align="center"><img src="doc/assets/logos/openclaw.svg" width="32" alt="OpenClaw" /><br/><sub>OpenClaw</sub></td> <td align="center"><img src="doc/assets/logos/claude.svg" width="32" alt="Claude" /><br/><sub>Claude Code</sub></td> <td align="center"><img src="doc/assets/logos/codex.svg" width="32" alt="Codex" /><br/><sub>Codex</sub></td> <td align="center"><img src="doc/assets/logos/cursor.svg" width="32" alt="Cursor" /><br/><sub>Cursor</sub></td> <td align="center"><img src="doc/assets/logos/bash.svg" width="32" alt="Bash" /><br/><sub>Bash</sub></td> <td align="center"><img src="doc/assets/logos/http.svg" width="32" alt="HTTP" /><br/><sub>HTTP</sub></td> </tr> </table>

<em>하트비트를 받을 수 있다면 고용됩니다.</em>

</div>

<br/>

Paperclip이 적합한 경우

  • 자율 AI 회사를 구축하려는 경우
  • ✅ 여러 다른 에이전트(OpenClaw, Codex, Claude, Cursor)를 공통 목표로 조정하는 경우
  • 20개의 동시 Claude Code 터미널을 열어두고 각각이 무엇을 하는지 파악하지 못하는 경우
  • ✅ 에이전트가 24/7 자율적으로 실행되기를 원하지만, 작업을 감사하고 필요할 때 개입하고 싶은 경우
  • 비용을 모니터링하고 예산을 적용하려는 경우
  • ✅ 에이전트 관리 프로세스가 작업 관리자처럼 느껴지길 원하는 경우
  • 휴대폰에서 자율 비즈니스를 관리하려는 경우

<br/>

기능

<table> <tr> <td align="center" width="33%"> <h3>🔌 자체 에이전트 가져오기</h3> 모든 에이전트, 모든 런타임, 하나의 조직도. 하트비트를 받을 수 있다면 고용됩니다. </td> <td align="center" width="33%"> <h3>🎯 목표 정렬</h3> 모든 작업은 회사 미션으로 추적됩니다. 에이전트는 <em>무엇을</em> 해야 하는지와 <em>왜</em> 해야 하는지를 압니다. </td> <td align="center" width="33%"> <h3>💓 하트비트</h3> 에이전트는 일정에 따라 깨어나 작업을 확인하고 행동합니다. 위임은 조직도를 따라 위아래로 흐릅니다. </td> </tr> <tr> <td align="center"> <h3>💰 비용 제어</h3> 에이전트별 월별 예산. 한도에 도달하면 중지됩니다. 비용 폭주 없음. </td> <td align="center"> <h3>🏢 다중 회사</h3> 하나의 배포, 여러 회사. 완전한 데이터 격리. 포트폴리오를 위한 단일 제어판. </td> <td align="center"> <h3>🎫 티켓 시스템</h3> 모든 대화 추적. 모든 결정 설명. 전체 도구 호출 추적 및 불변 감사 로그. </td> </tr> <tr> <td align="center"> <h3>🛡️ 거버넌스</h3> 고용 승인, 전략 재정의, 에이전트 일시 중지 또는 종료 — 언제든지. </td> <td align="center"> <h3>📊 조직도</h3> 계층, 역할, 보고 라인. 에이전트는 상사, 직함, 직무 설명이 있습니다. </td> <td align="center"> <h3>📱 모바일 지원</h3> 어디서나 자율 비즈니스를 모니터링하고 관리하세요. </td> </tr> </table>

<br/>

Paperclip이 해결하는 문제

Paperclip 없이 Paperclip 사용 시
❌ 20개의 Claude Code 탭이 열려 있고 각각이 무엇을 하는지 추적할 수 없습니다. 재부팅 시 모든 것을 잃습니다. ✅ 작업은 티켓 기반이며, 대화는 스레드로 연결되고, 세션은 재부팅 후에도 유지됩니다.
❌ 여러 곳에서 수동으로 컨텍스트를 수집하여 봇에게 실제로 무엇을 하고 있는지 상기시킵니다. ✅ 컨텍스트는 작업에서 프로젝트 및 회사 목표를 통해 흐릅니다. 에이전트는 항상 무엇을 해야 하는지와 왜 해야 하는지를 압니다.
❌ 에이전트 구성 폴더가 정리되지 않았고 작업 관리, 통신, 에이전트 간 조정을 다시 발명하고 있습니다. ✅ Paperclip은 조직도, 티켓팅, 위임, 거버넌스를 기본 제공하므로 스크립트 더미가 아닌 회사를 운영합니다.
❌ 폭주 루프가 수백 달러의 토큰을 낭비하고 알기도 전에 할당량을 최대화합니다. ✅ 비용 추적은 토큰 예산을 표시하고 예산이 소진되면 에이전트를 제한합니다. 관리자는 예산으로 우선순위를 정합니다.
❌ 반복 작업(고객 지원, 소셜, 보고서)이 있고 수동으로 시작해야 합니다. ✅ 하트비트가 일정에 따라 정기 작업을 처리합니다. 관리자가 감독합니다.
❌ 아이디어가 있으면 저장소를 찾고, Claude Code를 실행하고, 탭을 열어두고, 돌봐야 합니다. ✅ Paperclip에 작업을 추가하세요. 코딩 에이전트가 완료될 때까지 작업합니다. 관리자가 작업을 검토합니다.

<br/>

Paperclip이 특별한 이유

Paperclip은 어려운 오케스트레이션 세부 사항을 올바르게 처리합니다.

원자적 실행. 작업 체크아웃과 예산 적용이 원자적이므로 중복 작업과 비용 폭주가 없습니다.

| 영구 에이전트 상태. | 에이전트는 처음부터 다시 시작하는 대신 하트비트 간에 동일한 작업 컨텍스트를 재개합니다. |

런타임 스킬 주입. 에이전트는 재훈련 없이 런타임에 Paperclip 워크플로와 프로젝트 컨텍스트를 학습할 수 있습니다.

| 롤백이 가능한 거버넌스. | 승인 게이트가 적용되고, 구성 변경은 버전 관리되며, 잘못된 변경은 안전하게 롤백할 수 있습니다. |

목표 인식 실행. 작업은 전체 목표 계보를 전달하므로 에이전트는 제목뿐만 아니라 "이유"를 일관되게 볼 수 있습니다.

| 이식 가능한 회사 템플릿. | 비밀 제거 및 충돌 처리를 통해 조직, 에이전트, 스킬을 내보내기/가져오기할 수 있습니다. |

진정한 다중 회사 격리. 모든 엔터티는 회사 범위로 지정되므로 하나의 배포로 여러 회사를 별도의 데이터 및 감사 추적으로 운영할 수 있습니다.

<br/>

내부 구조

Paperclip은 래퍼가 아닌 완전한 제어판입니다. 이 중 어떤 것을 직접 구축하기 전에 이미 존재한다는 것을 알아두세요:

┌──────────────────────────────────────────────────────────────┐
│                       PAPERCLIP SERVER                       │
│                                                              │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  │
│  │Identity & │  │  Work &   │  │ Heartbeat │  │Governance │  │
│  │  Access   │  │   Tasks   │  │ Execution │  │& Approvals│  │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘  │
│                                                              │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  │
│  │ Org Chart │  │Workspaces │  │  Plugins  │  │  Budget   │  │
│  │ & Agents  │  │ & Runtime │  │           │  │ & Costs   │  │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘  │
│                                                              │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  │
│  │ Routines  │  │ Secrets & │  │ Activity  │  │  Company  │  │
│  │& Schedules│  │  Storage  │  │ & Events  │  │Portability│  │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘  │
└──────────────────────────────────────────────────────────────┘
         ▲              ▲              ▲              ▲
   ┌─────┴─────┐  ┌─────┴─────┐  ┌─────┴─────┐  ┌─────┴─────┐
   │  Claude   │  │   Codex   │  │   CLI     │  │ HTTP/web  │
   │   Code    │  │           │  │  agents   │  │   bots    │
   └───────────┘  └───────────┘  └───────────┘  └───────────┘

시스템

<table> <tr> <td width="50%">

Identity & Access — 두 가지 배포 모드(신뢰된 로컬 또는 인증됨), 보드 사용자, 에이전트 API 키, 단기 실행 JWT, 회사 멤버십, 초대 흐름, OpenClaw 온보딩. 모든 변경 요청은 행위자로 추적됩니다.

</td> <td width="50%">

Org Chart & Agents — 에이전트는 역할, 직함, 보고 라인, 권한, 예산이 있습니다. 어댑터 예시는 다이어그램과 일치합니다: Claude Code, Codex, Cursor/Gemini/bash와 같은 CLI 에이전트, OpenClaw와 같은 HTTP/webhook 봇, 외부 어댑터 플러그인. 하트비트를 받을 수 있다면 고용됩니다.

</td> </tr> <tr> <td>

Work & Task System — 이슈는 회사/프로젝트/목표/상위 링크, 실행 잠금이 있는 원자적 체크아웃, 일급 블로커 종속성, 댓글, 문서, 첨부 파일, 작업 산출물, 레이블, 받은 편지함 상태를 전달합니다. 중복 작업 없음, 컨텍스트 손실 없음.

</td> <td>

Heartbeat Execution — DB 기반 웨이크업 큐(병합 포함), 예산 확인, 워크스페이스 해결, 비밀 주입, 스킬 로딩, 어댑터 호출. 실행은 구조화된 로그, 비용 이벤트, 세션 상태, 감사 추적을 생성합니다. 복구는 고아 실행을 자동으로 처리합니다.

</td> </tr> <tr> <td>

Workspaces & Runtime — 프로젝트 워크스페이스, 격리된 실행 워크스페이스(git worktrees, operator 브랜치), 런타임 서비스(개발 서버, 미리보기 URL). 에이전트는 매번 올바른 디렉토리와 올바른 컨텍스트에서 작업합니다.

</td> <td>

Governance & Approvals — 보드 승인 워크플로, 검토/승인 단계가 있는 실행 정책, 결정 추적, 예산 하드 스톱, [...]

원본 저장소: paperclipai/paperclip

라이선스: MIT

게재 제외를 원하시면 삭제 요청을 보내주세요.