AI 에이전트 하나를 잘 쓰는 시대를 넘어, 여러 에이전트를 하나의 팀처럼 조율하는 시대가 오고 있습니다. Paperclip은 OpenClaw, Claude Code, Codex, Cursor 같은 다양한 AI 에이전트를 채용하고, 목표를 부여하고, 예산을 관리하고, 작업을 모니터링하는 오픈소스 AI 에이전트 오케스트레이션 플랫폼입니다. 슬로건이 이를 잘 요약합니다: "OpenClaw이 직원이라면, Paperclip은 회사다." GitHub에서 41,000개 이상의 스타를 받은 이 프로젝트의 소개부터 Windows, Ubuntu, macOS별 설치 방법까지 정리합니다. Paperclip이란? Paperclip은 Node.js 서버와 React UI로 구성된 AI 에이전트 조율 플랫폼입니다. 단일 에이전트 도구가 아니라, 여러 에이전트를 팀으로 묶어 비즈니스 목표를 달성하게 하는 관리 계층(Control Plane)입니다. 항목 내용 프로젝트 paperclipai/paperclip 라이선스 MIT (완전 오픈소스) GitHub 스타 41,200+ 런타임 Node.js 20+, pnpm 9.15+ 데이터베이스 내장 PostgreSQL (자동 설정) UI React 기반 대시보드 지원 에이전트 OpenClaw, Claude Code, Codex, Cursor, Bash, HTTP 에이전트 Paperclip이 하는 것과 하지 않는 것 하는 것 하지 않는 것 다중 에이전트 팀 조율 챗봇 기능 회사 미션 → 목표 → 작업 분해 드래그 앤 드롭 워크플로우 빌더 에이전트별 예산 관리 프롬프트 매니저 조직도, 역할, 보고 라인 코드 리뷰 도구 전체 감사 추적 (불변 로그) 단일 에이전트 프레임워크 거버넌스 (승인, 오버라이드, 종료) 에이전트 프레임워크 가이드 핵심 기능 목표 정렬(Goal Alignment): 모든 작업이 회사 미션으로 추적됩니다. 에이전트는 "무엇(what)"뿐 아니라 "왜(why)"도 이해합니다 스케줄 실행: 하트비트 기반 활성화로 에이전트가 자율적으로 스케줄에 따라 작동합니다 비용 관리: 에이전트별 월간 예산을 설정하여 토큰 비용 폭주를 방지합니다 멀티 컴퍼니: 단일 배포로 무제한 격리된 회사를 운영할 수 있습니다 감사 추적: 모든 도구 호출, 결정, 응답이 불변 로그로 기록됩니다 거버넌스: 사람이 채용 승인, 전략 오버라이드, 에이전트 종료를 제어합니다 런타임 스킬 주입: 재학습 없이 에이전트가 워크플로우와 프로젝트 컨텍스트를 런타임에 학습합니다 사전 요구사항 모든 OS 공통: Node.js 20+ pnpm 9.15+ (수동 설치 시) PostgreSQL은 내장되어 별도 설치 불필요 Windows 설치 방법 1: npx 원커맨드 설치 (권장) Node.js 20+가 설치되어 있다면 한 줄이면 됩니다: npx paperclipai onboard --yes 대화형 설정 마법사가 실행되며, 내장 PostgreSQL이 자동으로 구성됩니다. 방법 2: 글로벌 CLI 설치 npm install -g paperclipai paperclipai onboard 방법 3: 소스에서 빌드 git clone https://github.com/paperclipai/paperclip.git cd paperclip pnpm install pnpm dev Node.js 미설치? nodejs.org에서 LTS 버전을 다운로드하거나, winget install OpenJS.NodeJS.LTS로 설치하세요. Ubuntu(Linux) 설치 방법 1: npx (권장) # Node.js 20+ 설치 (없는 경우) curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs # Paperclip 설치 및 온보딩 npx paperclipai onboard --yes 방법 2: 소스에서 빌드 # pnpm 설치 npm install -g pnpm # 소스 클론 및 실행 git clone https://github.com/paperclipai/paperclip.git cd paperclip pnpm install pnpm dev 서버가 http://localhost:3100에서 시작됩니다. 방법 3: 글로벌 CLI npm install -g paperclipai paperclipai onboard macOS 설치 방법 1: npx (권장) # Node.js 20+ 설치 (없는 경우) brew install node@20 # Paperclip 설치 및 온보딩 npx paperclipai onboard --yes 방법 2: 소스에서 빌드 brew install pnpm git clone https://github.com/paperclipai/paperclip.git cd paperclip pnpm install pnpm dev 방법 3: 글로벌 CLI npm install -g paperclipai paperclipai onboard CLI 주요 명령어 명령어 설명 paperclipai onboard 대화형 초기 설정 마법사 paperclipai run Paperclip 서버 부트스트랩 및 실행 paperclipai doctor 시스템 진단 및 복구 paperclipai configure 설정 섹션 업데이트 paperclipai env 배포용 환경변수 출력 paperclipai auth bootstrap-ceo 첫 관리자 초대 링크 생성 paperclipai heartbeat run --agent-id 특정 에이전트 하트비트 실행 (스트리밍 로그) paperclipai allowed-hostname 허용 호스트네임 추가 설정 파일 구조 Paperclip은 인스턴스별로 설정이 격리됩니다: ~/.paperclip/instances// config.json # 메인 설정 .env.local # JWT 시크릿 master.key # 암호화 키 context.json # CLI 컨텍스트 프로파일 주요 환경변수 변수 용도 PAPERCLIP_HOME 홈 디렉터리 오버라이드 PAPERCLIP_INSTANCE_ID 멀티 인스턴스 구분용 ID PAPERCLIP_CONFIG 설정 파일 경로 직접 지정 트러블슈팅 증상 해결 방법 Node.js 버전 부족 node --version으로 확인, 20+ 필요. nvm이나 brew로 업그레이드 pnpm 미설치 npm install -g pnpm 또는 corepack enable pnpm 포트 3100 충돌 설정에서 포트 변경 또는 기존 프로세스 종료 PostgreSQL 연결 실패 paperclipai doctor로 진단. 내장 PostgreSQL은 자동 관리됨 설정 문제 paperclipai configure로 재설정 핵심 정리 Paperclip은 여러 AI 에이전트를 하나의 팀으로 조율하는 오픈소스 오케스트레이션 플랫폼 OpenClaw, Claude Code, Codex, Cursor 등 모든 에이전트를 통합 관리 목표 정렬, 예산 관리, 감사 추적, 거버넌스를 대시보드 하나에서 제어 모든 OS에서 한 줄로 설치: npx paperclipai onboard --yes 내장 PostgreSQL로 별도 DB 설치 불필요 MIT 라이선스, GitHub 41K+ 스타, 셀프호스팅 전용 참조 링크 paperclipai/paperclip - GitHub 공식 저장소 (README, 소스 코드, 이슈 트래커) Paperclip CLI 공식 문서 CLI 명령어, 설정 파일, 환경변수 레퍼런스 Paperclip 공식 사이트 프로젝트 소개, 기능 개요 paperclipai - npm npm 패키지 페이지, 최신 버전 정보