The open-source app everyone uses to manage agents at work
이 번역은 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> · <a href="https://paperclip.ing/docs"><strong>문서</strong></a> · <a href="https://github.com/paperclipai/paperclip"><strong>GitHub</strong></a> · <a href="https://discord.gg/m4HZY7xNG3"><strong>Discord</strong></a> · <a href="https://x.com/papercliping"><strong>Twitter</strong></a> · <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/>
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/>
<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 사용 시 | ||
|---|---|---|---|
| ❌ 20개의 Claude Code 탭이 열려 있고 각각이 무엇을 하는지 추적할 수 없습니다. 재부팅 시 모든 것을 잃습니다. | ✅ 작업은 티켓 기반이며, 대화는 스레드로 연결되고, 세션은 재부팅 후에도 유지됩니다. | ||
| ❌ 여러 곳에서 수동으로 컨텍스트를 수집하여 봇에게 실제로 무엇을 하고 있는지 상기시킵니다. | ✅ 컨텍스트는 작업에서 프로젝트 및 회사 목표를 통해 흐릅니다. 에이전트는 항상 무엇을 해야 하는지와 왜 해야 하는지를 압니다. | ||
| ❌ 에이전트 구성 폴더가 정리되지 않았고 작업 관리, 통신, 에이전트 간 조정을 다시 발명하고 있습니다. | ✅ Paperclip은 조직도, 티켓팅, 위임, 거버넌스를 기본 제공하므로 스크립트 더미가 아닌 회사를 운영합니다. | ||
| ❌ 폭주 루프가 수백 달러의 토큰을 낭비하고 알기도 전에 할당량을 최대화합니다. | ✅ 비용 추적은 토큰 예산을 표시하고 예산이 소진되면 에이전트를 제한합니다. 관리자는 예산으로 우선순위를 정합니다. | ||
| ❌ 반복 작업(고객 지원, 소셜, 보고서)이 있고 수동으로 시작해야 합니다. | ✅ 하트비트가 일정에 따라 정기 작업을 처리합니다. 관리자가 감독합니다. | ||
| ❌ 아이디어가 있으면 저장소를 찾고, Claude Code를 실행하고, 탭을 열어두고, 돌봐야 합니다. | ✅ Paperclip에 작업을 추가하세요. 코딩 에이전트가 완료될 때까지 작업합니다. 관리자가 작업을 검토합니다. |
<br/>
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 — 보드 승인 워크플로, 검토/승인 단계가 있는 실행 정책, 결정 추적, 예산 하드 스톱, [...]