Paperclip — 여러 AI 에이전트를 조직 단위로 운영하는 오픈소스 관제 도구

AI 요약

Paperclip은 Claude Code, Codex, OpenClaw 같은 에이전트를 직접 만드는 프레임워크가 아니라, 여러 에이전트에 역할과 목표를 할당하고 함께 운영하는 관제 시스템입니다. Node.js 서버와 React UI로 구성되며, 작업 관리 화면 뒤에 조직도, 권한, 예산, 승인, 감사 기록을 둡니다. 프로젝트 관리자가 Pull Request를 하나씩 나누기보다 조직의 목표를 설정하고, 에이전트가 맡은 일을 추적하는 방식입니다.

에이전트를 조직에 배치합니다

사용자는 회사 목표를 만들고 CEO, 개발자, 디자이너 등 역할을 정의한 뒤 에이전트를 배치합니다. 에이전트마다 직책, 보고 관계, 권한, 예산을 설정하고 사람과 에이전트가 함께 있는 조직도도 구성할 수 있습니다. 제품은 특정 모델이나 런타임을 강제하지 않습니다. Claude Code, Codex, CLI 에이전트, HTTP·웹훅 봇, 외부 플러그인 어댑터를 연결하는 구조입니다.

업무는 회사·프로젝트·목표·상위 작업과 연결되는 이슈로 관리합니다. 작업에는 의존 관계, 댓글, 문서, 첨부 파일, 산출물과 라벨을 붙일 수 있습니다. 에이전트가 작업을 가져가는 과정은 실행 잠금과 함께 원자적으로 처리해 중복 작업을 막습니다. 작업마다 목표의 상위 맥락도 전달하므로 에이전트가 작업 제목만 받는 대신 조직 목표와 연결된 이유를 확인합니다.

하트비트와 실행 상태를 관리합니다

에이전트는 기본적으로 일정한 하트비트나 작업 할당, 멘션 같은 이벤트에 반응해 실행합니다. 서버는 데이터베이스 기반 대기열에서 실행 시점을 관리하고, 작업 공간과 비밀 정보, 스킬을 준비한 뒤 어댑터를 호출합니다. 실행 결과에는 구조화된 로그, 비용 이벤트, 세션 상태와 감사 기록이 남습니다. 중단되거나 고아 상태가 된 실행을 복구하는 기능도 제공합니다. 세션 상태를 유지해 다음 하트비트에서 같은 작업 맥락을 이어가도록 설계했습니다.

작업 공간은 프로젝트 단위 공간과 격리된 실행 공간으로 나뉩니다. 실행 공간에는 Git worktree나 운영자 브랜치를 쓸 수 있고, 개발 서버나 미리보기 URL 같은 런타임 서비스도 관리합니다. 반복 작업은 cron, 웹훅, API로 예약할 수 있습니다. 각 실행은 추적 가능한 이슈를 만들고 담당 에이전트를 깨웁니다.

예산과 승인으로 실행을 통제합니다

비용은 회사, 에이전트, 프로젝트, 목표, 이슈, 제공자, 모델별로 추적합니다. 범위별 예산에 경고 기준과 강제 중단 한도를 설정할 수 있습니다. 한도를 넘으면 에이전트를 멈추고 대기 중인 작업을 취소합니다. 승인 정책에는 검토 단계를 둘 수 있으며, 운영자는 에이전트를 일시 정지하거나 재개하고 종료할 수 있습니다. 변경된 설정은 버전 관리와 롤백을 지원합니다.

민감 정보는 인스턴스나 회사 범위에 저장하며, 암호화된 로컬 저장소와 외부 객체 저장소를 지원합니다. 비밀 정보는 해당 실행에 명시적으로 필요하지 않으면 프롬프트에 넣지 않는다고 안내합니다. 플러그인은 별도 프로세스에서 실행하고 권한이 제한된 호스트 기능을 사용합니다. 조직 전체를 내보내고 가져올 때는 비밀 정보를 제거하고 이름 충돌을 처리합니다. 한 배포에서 여러 회사를 운영하더라도 회사별 데이터와 감사 기록을 분리합니다.

설치와 운영 환경

빠른 설치에는 Node.js 24.11 이상이 필요합니다. 로컬 개발 환경은 pnpm install과 pnpm dev로 실행하며, API 서버는 기본적으로 http://localhost:3100에서 시작합니다. 임베디드 PostgreSQL을 자동으로 만들기 때문에 별도 데이터베이스 설정 없이 시험할 수 있습니다. 운영 배포에서는 직접 관리하는 PostgreSQL을 연결할 수 있습니다. 설치 스크립트와 체크섬은 같은 출처에서 제공되므로, 독립적으로 확인할 필요가 있다면 GitHub의 특정 릴리스나 커밋에 고정한 사본을 사용하라고 안내합니다.

서버의 OpenTelemetry 추적과 서버·브라우저 Sentry 오류 수집은 선택 기능입니다. 익명 사용 통계는 기본 활성화이며 PAPERCLIP_TELEMETRY_DISABLED=1, DO_NOT_TRACK=1, 설정 파일의 telemetry.enabled: false 등으로 끌 수 있습니다. 프로젝트는 MIT 라이선스로 공개하며, 메모리·지식 기능과 데스크톱 앱, 외부 티켓 시스템 연동 등은 로드맵 항목으로 구분합니다.

원문: GitHub / 번역·요약: Trawling