Paperclip AI 완벽 가이드: 설치부터 무인 AI 회사 구축까지 (AI 에이전트 오케스트레이션)

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)입니다.

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

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 주요 명령어

설정 파일 구조

Paperclip은 인스턴스별로 설정이 격리됩니다:

~/.paperclip/instances/<instance-id>/
  config.json      # 메인 설정
  .env.local       # JWT 시크릿
  master.key       # 암호화 키
  context.json     # CLI 컨텍스트 프로파일</instance-id>

주요 환경변수

트러블슈팅

핵심 정리

• 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 - npmnpm 패키지 페이지, 최신 버전 정보