본문으로 건너뛰기
오픈소스 전체 목록

Paperclip

  • 추천0
  • GitHub 별115K
  • 개발라이선스MIT

AI 에이전트 팀을 회사처럼 운영하는 오픈소스 오케스트레이션. 조직도 · 예산 · 거버넌스를 한 대시보드에서 다뤄요

원본:paperclipai/paperclip

요약

AI 에이전트 팀을 회사처럼 운영하는 오픈소스 오케스트레이션. 조직도 · 예산 · 거버넌스를 한 대시보드에서 다뤄요

설명

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

문서 · 빠른 시작 · GitHub · Discord · Twitter · 웹사이트

MIT 라이선스 스타 Discord Superagent가 검증한 보안 상태 Star History 순위

데모 영상 보기

Paperclip Cloud 대기자 명단에 등록하기 →

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

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

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

Paperclip은 AI 에이전트 팀이 사업을 운영하도록 조율하는 Node.js 서버와 React UI입니다. 내 에이전트를 직접 데려와 목표를 정하고, 작업과 비용을 하나의 대시보드에서 추적하세요. 에이전트마다 모델과 하니스를 고르면서도 팀의 작업, 스킬, 권한, 기록은 한곳에 모아 둘 수 있어요.

겉모습은 작업 관리 도구 같지만, 속에는 조직도, 예산, 거버넌스, 목표 정렬, 에이전트 간 협업이 들어 있습니다.

풀 리퀘스트가 아니라 사업 목표를 관리하세요.

단계예시
01목표 정하기"1위 AI 노트 앱을 만들어 월 매출 100만 달러를 달성한다."
02팀 꾸리기CEO, CTO, 엔지니어, 디자이너, 마케터 — 어떤 봇이든, 어떤 제공자든 가능합니다.
03승인하고 실행하기전략을 검토하고, 예산을 정하고, 시작하세요. 대시보드에서 지켜보면 됩니다.

함께 쓸 수 있는 에이전트

함께
쓰는
OpenClaw
OpenClaw
Claude Code
Claude Code
Codex
Codex
Cursor 및 Cursor Cloud
Cursor
+ Cloud
Gemini CLI
Gemini CLI
OpenCode
OpenCode
Pi
Pi
Hermes 및 Hermes Gateway
Hermes
+ Gateway
Grok Build
Grok Build
Kimi Code
Kimi Code

하트비트를 받을 수 있다면, 채용된 겁니다.

커스텀 프로세스, HTTP 엔드포인트, 외부 어댑터 패키지로 명단을 더 늘릴 수 있어요. 설정 방법과 기능은 어댑터 개요를 보세요.

이런 분께 Paperclip이 맞아요

  • ✅ 자율 AI 조직을 만들고 싶어요
  • ✅ 하나의 목표를 위해 여러 종류의 에이전트(OpenClaw, Codex, Claude, Cursor)를 조율해요
  • ✅ Claude Code 터미널을 20개씩 띄워 놓고 누가 무엇을 하는지 놓치고 있어요
  • ✅ 에이전트가 24시간 자율적으로 돌길 원하지만, 작업을 감사하고 필요할 때 끼어들 수도 있길 원해요
  • ✅ 비용을 모니터링하고 예산을 강제하고 싶어요
  • ✅ 에이전트 관리 과정이 작업 관리 도구를 쓰는 것처럼 느껴지길 원해요
  • ✅ 자율 사업을 휴대폰으로 관리하고 싶어요

네 가지 기둥

AI 에이전트 조직이 실제로 성과를 내려면 네 가지가 제대로 돌아가야 합니다. 작업, 조직, 훈련, 인프라예요. Paperclip은 바로 이 네 기둥을 중심으로 만들어졌어요.

Paperclip의 네 가지 기둥
기둥대상다루는 것
에이전트형 작업 관리 — 의도를 선언하면 에이전트가 일하고, 결과는 내가 검증합니다.모든 사람, 매일작업, 승인과 검토 관문 · 먼저 움직이는 에이전트 동료 · 감사할 수 있는 루틴과 워크플로 · diff, 스크린샷, 테스트로 검증
에이전트 조직도 — 사람과 에이전트를 위한 역할, 권한, 경계.관리자사람 + 에이전트 혼합 조직도 · 책임, 위임, 전문화 · 거버넌스: 누가 무엇을 할 수 있는가 · 범위가 정해진 시크릿과 회사 경계 · 연결 권한과 책임 사용자 신원
에이전트 직원 훈련 — AI 직원을 설계하고, 훈련하고, 평가합니다.도입 담당자스킬 스튜디오와 조직 전체 공유 스킬 · 평가와 저장된 테스트 실행 · 능동 학습 루프와 품질 지표 · 에이전트 성과 평가 · 저장된 테스트 입력 · 스킬 버전 기록과 복원 · 재사용 가능한 팀 템플릿
에이전트 OS — 일이 돌아가게 하는 인프라.IT · 플랫폼제공자를 가리지 않는 런타임: 어떤 모델, 어떤 에이전트든 · 샌드박스, 연동, MCP 서버 · SSO, GRC, RBAC, 비용 통제 · 데이터 프라이버시, 내부 추적 수집, 쌓이는 데이터 가치 · 개인 · 공유 앱 연결 · 실행 기록과 선택형 추적

기능

🔌 내 에이전트 가져오기

어떤 에이전트든, 어떤 런타임이든, 하나의 조직도에 올립니다. 하트비트를 받을 수 있다면 채용된 겁니다.

🎯 목표 정렬

작업과 프로젝트를 조직의 목표에 연결합니다. 에이전트는 자기 일의 배경이 되는 목표 맥락을 받아요.

💓 하트비트

에이전트는 배정된 작업, 후속 메시지, 설정된 일정에 따라 깨어납니다. 위임은 조직도를 따라 위아래로 흘러요.

💰 비용 통제

회사, 에이전트, 프로젝트별 예산을 둡니다. 보고된 지출을 추적하고, 임계값 알림을 받고, 정해진 한도에서 작업을 멈춰요.

🏢 다중 조직

한 번의 배포에 여러 조직을 둡니다. 조직마다 작업, 에이전트, 권한, 활동 기록이 따로 있어요.

🎫 작업 스레드

대화, 계획, 막힌 점, 파일, 실행 기록이 작업에 붙어 있습니다. 작업은 에이전트에게도 사람에게도 배정할 수 있어요.

🛡️ 거버넌스

검토와 승인 단계를 설정하고, 채용을 승인하고, 필요하면 작업을 멈추거나 다시 배정하거나 중단합니다.

📊 조직도

계층, 역할, 보고 라인. 에이전트에게도 상사, 직함, 직무 기술서가 있어요.

📱 모바일 지원

어디서든 자율 사업을 모니터링하고 관리하세요.

🔗 앱과 연결

GitHub, Notion, Railway 같은 서비스를 연결하거나 내 MCP 서버를 붙입니다. 게이트웨이 동작은 허용 · 먼저 묻기 · 끔 중에서 정해요.

👥 공유 에이전트, 개인 계정

누가 연결을 쓸 수 있는지와 어떤 에이전트가 접근할 수 있는지 고릅니다. 관리형 GitHub 작업은 작업을 지시하는 사람의 계정을 쓸 수 있어요.

🧠 스킬과 스킬 스튜디오

공유 스킬을 설치하거나 직접 쓰고, 저장된 입력으로 테스트하고, 결과를 살펴보고, 이전 버전으로 되돌립니다.

📅 예약 루틴

반복 작업을 일정에 따라 돌리거나 API · 웹훅으로 실행합니다. 실행마다 작업, 담당자, 기록이 남아요.

📎 산출물과 피드백

에이전트가 만든 파일과 문서를 찾아봅니다. 지원하는 형식은 미리 보고, 문서의 특정 구절에 댓글을 남길 수 있어요.

📦 바로 쓰는 팀

역할, 스킬, 프로젝트, 루틴이 들어 있는 팀을 미리 보고 설치합니다. 런타임을 고르고 내 설정으로 바꿀 수 있어요.

실험 기능인 에이전트 채팅과 채팅 · 이메일 커넥터를 켜면 Paperclip 안에서, 그리고 Slack, Discord, Telegram, AgentMail 같은 설정된 서비스를 통해 에이전트와 대화할 수 있어요. 해당 인스턴스 설정을 켜고 써 보세요.

Paperclip이 해결하는 문제

Paperclip이 없을 때Paperclip이 있을 때
❌ Claude Code 탭이 20개 열려 있는데 어느 탭이 무엇을 하는지 모릅니다. 재부팅하면 전부 사라져요.✅ 작업은 티켓 기반이고, 대화는 스레드로 이어지며, 세션은 재부팅 뒤에도 유지됩니다.
❌ 봇에게 지금 하는 일을 알려 주려고 여러 곳에서 맥락을 손으로 모읍니다.✅ 맥락이 작업에서 프로젝트, 회사 목표로 이어져 흐릅니다. 에이전트는 무엇을, 왜 해야 하는지 항상 알아요.
❌ 에이전트 설정 폴더가 뒤죽박죽이고, 작업 관리 · 소통 · 에이전트 간 조율을 처음부터 다시 만들고 있어요.✅ 조직도, 티켓, 위임, 거버넌스를 바로 쓸 수 있습니다. 스크립트 더미가 아니라 회사를 운영하세요.
❌ 폭주하는 루프가 토큰 수백 달러를 낭비하고, 무슨 일인지 알기도 전에 할당량이 바닥납니다.✅ 지출 추적, 예산 알림, 자동 일시 중지로 진행 중인 작업의 비용을 통제할 수 있어요.
❌ 고객 지원, 소셜, 보고서 같은 반복 작업을 매번 손으로 시작해야 합니다.✅ 루틴이 일정에 맞춰 배정된 작업을 만들고, 결과물과 실행 기록을 확인할 수 있어요.
❌ 아이디어가 떠오르면 저장소를 찾고, Claude Code를 띄우고, 탭을 열어 두고, 옆에서 지켜봐야 합니다.✅ Paperclip에 작업을 추가하세요. 코딩 에이전트가 끝날 때까지 일하고, 관리자가 결과를 검토합니다.

Paperclip이 특별한 이유

Paperclip은 까다로운 오케스트레이션 세부 사항을 제대로 처리합니다.

원자적 작업 체크아웃.담당자는 하나, 실행 잠금으로 서로 경쟁하는 실행이 같은 작업을 가져가지 못하게 합니다.
지속되는 작업 맥락.작업, 댓글, 문서가 Paperclip에 남습니다. 지원하는 어댑터는 실행 사이에 저장된 세션을 이어 가요.
런타임 스킬 주입.에이전트가 재훈련 없이 실행 중에 Paperclip 워크플로와 프로젝트 맥락을 배울 수 있어요.
되돌릴 수 있는 거버넌스.승인 관문이 강제되고, 설정 변경은 리비전으로 남으며, 잘못된 변경은 안전하게 롤백할 수 있습니다.
책임을 묻는 연결.사람의 접근, 에이전트 자격, 게이트웨이 동작 권한은 서로 분리된 통제입니다. 호출을 한 번 승인하거나, 취소할 수 있는 규칙으로 저장하세요.
목표를 아는 실행.연결된 작업과 프로젝트는 목표 계보를 갖고 있어서 에이전트가 제목만이 아니라 "왜"를 봅니다.
옮길 수 있는 회사 템플릿.조직, 에이전트, 스킬을 내보내고 가져옵니다. 시크릿은 지우고 충돌은 처리해요.
조직 경계.회사 단위 접근 검사로 한 배포 안에서도 조직마다 작업, 에이전트, 활동이 따로 유지됩니다.

내부 구조

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    │
   └───────────┘  └───────────┘  └───────────┘  └───────────┘

시스템 구성

Identity & Access(신원과 접근) — 두 가지 배포 모드(신뢰하는 로컬 또는 인증), 사람의 역할과 권한, 에이전트 API 키, 짧게 쓰는 실행 JWT, 회사 멤버십, 초대 흐름을 갖췄어요. 책임 사용자 귀속은 위임과 지원되는 관리형 연결을 거쳐도 작업을 따라갑니다.

Org Chart & Agents(조직도와 에이전트) — 에이전트는 역할, 직함, 보고 라인, 권한, 예산을 가집니다. 어댑터 예시는 다이어그램과 같아요: Claude Code, Codex, Cursor · Gemini · bash 같은 CLI 에이전트, OpenClaw 같은 HTTP · 웹훅 봇, 외부 어댑터 플러그인. 하트비트를 받을 수 있다면 채용된 겁니다.

Work & Task System(작업 시스템) — 이슈는 회사 · 프로젝트 · 목표 · 상위 작업 링크, 실행 잠금이 있는 원자적 체크아웃, 일급 시민인 차단 의존성, 댓글, 문서, 첨부, 작업 산출물, 라벨, 받은편지함 상태를 가집니다. 작업 전체를 검색하고, 문서 리비전을 검토하고, 위치가 고정된 피드백을 남길 수 있어요.

Heartbeat Execution(하트비트 실행) — DB 기반 깨우기 대기열이 병합, 예산 확인, 워크스페이스 해석, 시크릿 주입, 스킬 로딩, 어댑터 호출을 맡습니다. 실행은 로그, 사용량 기록, 어댑터별 세션 상태를 남겨요. 지원되는 실패는 한도 안에서 복구하고, 사람이 처리해야 하는 경우는 드러냅니다.

Workspaces & Runtime(워크스페이스와 런타임) — 프로젝트 저장소와 워크스페이스, 선택형 격리 실행 워크스페이스(git 워크트리, 운영자 브랜치), 런타임 서비스(개발 서버, 미리보기 주소)가 있어요. 샌드박스 제공자는 로컬 호스트를 넘어 실행을 확장합니다. 사용 가능 여부는 설정한 환경과 어댑터에 따라 달라요.

Governance & Approvals(거버넌스와 승인) — 이사회 승인 워크플로, 검토 · 승인 단계가 있는 실행 정책, 결정 추적, 예산 하드 스톱, 에이전트 일시 중지 · 재개 · 종료. 설정된 작업 검토가 완료를 통제하고, 연결 동작 승인이 도구 게이트웨이를 거치는 호출을 통제해요.

Budget & Cost Control(예산과 비용 통제) — 회사, 에이전트, 프로젝트, 목표, 이슈, 제공자, 모델별 토큰 · 비용 추적. 경고 임계값과 하드 스톱이 있는 범위별 예산 정책을 둡니다. 집행은 기록된 지출을 기준으로 하므로 사용량 보고와 진행 중인 작업 때문에 중단이 늦어질 수 있어요.

Routines & Schedules(루틴과 일정) — cron, 웹훅, API 트리거로 반복 작업을 만듭니다. 동시 실행과 따라잡기 정책도 있어요. 루틴 실행마다 추적되는 이슈가 만들어지고 배정된 에이전트가 깨어나서, 손으로 시작할 필요가 없습니다.

Plugins(플러그인) — 프로세스 밖 워커, 권한으로 제한되는 호스트 서비스, 작업 스케줄링, 도구 노출, UI 확장을 갖춘 인스턴스 전체 플러그인 시스템이에요. 포크하지 않고 Paperclip을 확장하세요.

Secrets & Storage(시크릿과 저장소) — 회사 시크릿과 사람별 시크릿 값, 암호화된 자격 증명 저장, 로컬 또는 S3 호환 파일 저장소, 첨부, 작업 산출물. 시크릿 참조가 일반 에이전트 설정에 값을 복사하지 않고도 권한 있는 실행에 자격 증명을 공급합니다.

Activity & Events(활동과 이벤트) — 변경 동작, 하트비트 상태 변화, 비용 이벤트, 승인, 댓글, 작업 산출물이 영구 활동 기록으로 남아서 운영자가 무슨 일이 왜 일어났는지 감사할 수 있어요.

Company Portability(회사 이식성) — 에이전트, 스킬, 선택적으로 프로젝트 · 루틴 · 작업 · 첨부가 담긴 조직 패키지를 미리 보고, 내보내고, 가져옵니다. 참조된 시크릿 값은 빠지지만, 일반 환경 변수 값과 로컬 경로는 남아 있을 수 있으니 공유하기 전에 패키지를 검토하세요. 패키지는 운영 설정을 공유하는 용도이고, 인스턴스 전체 복구는 백업을 씁니다.

Paperclip이 아닌 것

그냥 챗봇이 아닙니다.대화는 작업, 계획, 결정, 산출물에 붙어 있습니다. 실험 기능인 에이전트 채팅은 배정된 작업으로 일을 넘길 수 있어요.
에이전트 프레임워크가 아닙니다.에이전트를 어떻게 만들라고 말하지 않습니다. 에이전트로 이루어진 회사를 어떻게 운영하는지 알려 드려요.
그냥 워크플로 빌더가 아닙니다.루틴은 역할, 목표, 예산, 거버넌스가 있는 조직 안에서 돌아갑니다.
프롬프트 관리자가 아닙니다.에이전트가 자기 프롬프트, 모델, 런타임을 가져옵니다. Paperclip은 그들이 일하는 조직을 관리해요.
에이전트 하나에 묶이지 않습니다.에이전트 하나로 시작해서 공유 스킬, 위임, 검토가 있는 팀으로 키우세요.
코드 리뷰 전용이 아닙니다.코딩과 PR 리뷰 옆에서 리서치, 운영, 콘텐츠 같은 일도 함께 다룹니다.

빠른 시작

오픈소스, 셀프 호스팅이고 Paperclip 계정은 필요 없어요. 안내를 따라 첫 에이전트를 설정하세요.

에이전트에게 Paperclip 설치를 맡기세요

설치 안내를 에이전트에게 건네 주세요.

직접 설치하기

Node.js 24.11 이상이 설치되어 있다면:

npx paperclipai@latest onboard --yes

CLI는 npm 캐시에서 실행되고, 인스턴스 설정과 데이터는 로컬에 남습니다.

관리형 설치, 버전 고정, 카나리 · git ref 설치, 업데이트, 롤백, 서비스 관리, 삭제는 설치 안내를 보세요.

CEO 에이전트까지 이미 초기화된 격리 수동 테스트 인스턴스가 필요하면 test-drive를 쓰세요. 포그라운드에서 돌고, 서비스를 설치하거나 첫 작업을 만들지 않으며, 설정이 성공한 뒤에만 브라우저를 엽니다.

ANTHROPIC_API_KEY=... npx paperclipai test-drive
OPENAI_API_KEY=... npx paperclipai test-drive --harness codex
OPENROUTER_API_KEY=... npx paperclipai test-drive \
  --harness opencode \
  --model openrouter/anthropic/claude-sonnet-4.5

--data-dir 없이 실행하면 매번 고유한 임시 폴더가 보존되고, 그 절대 경로가 시작할 때 출력됩니다. 하나를 다시 쓰려면 --data-dir을, 초기화된 인스턴스를 열지 않고 두려면 --no-browser를 넘기세요. 연결된 Git 워크트리에서 실행하면 test-drive가 그 워크트리에서의 작업 실행도 켭니다. 자격 증명과 재사용 동작은 test-drive 안내를 보세요.

문제 해결: 사설 npm 레지스트리 .npmrc

paperclipai(또는 비슷한 패키지)에서 E404가 나고, 전역 ~/.npmrc로 사설 npm 레지스트리(예: GitHub Packages)를 쓰고 있다면 npx가 공개 npm 레지스트리가 아니라 그 사설 레지스트리에서 paperclipai를 찾고 있을 수 있습니다.

진단:

npm config get registry

해결 방법(운영체제 공통, 이 명령에만 공개 npm 레지스트리를 쓰도록 강제):

npx --registry https://registry.npmjs.org paperclipai@latest onboard --yes

이 빠른 시작 경로는 이제 가장 빠른 첫 실행을 위해 신뢰하는 로컬 루프백 모드가 기본이에요. 대신 인증 · 비공개 모드로 시작하려면 바인드 프리셋을 직접 고르세요.

npx paperclipai@latest onboard --yes --bind lan
# 또는:
npx paperclipai@latest onboard --yes --bind tailnet

이미 Paperclip을 설정했다면 onboard를 다시 실행해도 기존 설정이 그대로 유지됩니다. 설정을 바꾸려면 npx paperclipai configure를 쓰세요.

직접 설치하려면:

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

UI와 API가 http://localhost:3100에서 시작됩니다. 내장 PostgreSQL 데이터베이스가 자동으로 만들어져서 따로 설정할 것이 없어요.

요구 사항: Node.js 24.11+, pnpm 9.15+

로컬 Claude · Codex 구독 로그인에는 Paperclip 호스트에 Python 3와 해당 제공자 CLI도 필요합니다. Docker 이미지에는 들어 있어요.

소스 개발은 활성화된 경우(셀프 호스팅 기본값) 네이티브 Paperclip Runner도 빌드합니다. Rust 툴체인을 설치하거나, 호환되는 미리 빌드된 러너를 PAPERCLIP_RUNNER_BINARY로 지정하세요.

FAQ

Q: 이 프로젝트는 계속 관리되나요, 아니면 방치된 쓰레기인가요?

A: Paperclip은 Paperclip 팀이 관리합니다. 지금까지 2,700개가 넘는 풀 리퀘스트를 머지했어요.

Q: 일반적인 구성은 어떤 모습인가요?

A: 로컬에서는 Node.js 프로세스 하나가 내장 Postgres와 로컬 파일 저장소를 관리합니다. 운영 환경에서는 내 Postgres를 연결하고 원하는 방식으로 배포하면 돼요. 프로젝트, 에이전트, 목표를 설정하면 나머지는 에이전트가 알아서 합니다.

원격 접속은 Tailscale 같은 사설 네트워크 바인드와 인증 모드를 쓰거나, Docker로 지속 서버를 배포하세요. 배포 모드와 Docker 안내를 보세요.

Q: 회사를 여러 개 운영할 수 있나요?

A: 네. 하나의 배포에서 회사 단위 데이터와 접근 검사를 갖춘 여러 조직을 운영할 수 있어요.

Q: OpenClaw나 Claude Code 같은 에이전트와는 무엇이 다른가요?

A: Paperclip은 그 에이전트들을 씁니다. 조직도, 예산, 목표, 거버넌스, 책임 체계를 갖춘 회사로 그들을 엮어 줘요.

Q: OpenClaw를 Asana나 Trello에 연결하면 되는데 왜 Paperclip을 써야 하나요?

A: 에이전트 오케스트레이션에는 미묘한 부분이 많아요. 누가 작업을 체크아웃했는지 조율하고, 세션을 유지하고, 비용을 모니터링하고, 거버넌스를 세우는 일을 Paperclip이 대신 해 줍니다.

(자체 티켓 시스템 연결은 로드맵에 있어요)

Q: 에이전트는 계속 돌아가나요?

A: 에이전트는 배정된 작업과 후속 메시지가 있을 때 깨어납니다. 선택형 타이머 하트비트를 켜면 주기적으로 할 일을 확인하고, 루틴은 자기 일정에 따라 반복 작업을 만들어요. OpenClaw처럼 외부에서 돌고 있는 에이전트를 연결할 수도 있습니다. 멘션만으로는 작업이 배정되거나 다른 에이전트가 깨어나지 않아요.

개발

pnpm dev              # 전체 개발 (API + UI, 감시 모드)
pnpm dev:once         # 파일 감시 없는 전체 개발
pnpm dev:server       # 서버만
pnpm dev:mobile       # 휴대폰 · 태블릿용으로 미리 빌드한 UI를 :3101에서 제공 (/api → :3100 프록시)
pnpm dev:both         # `pnpm dev`와 `pnpm dev:mobile`을 함께 실행
pnpm build            # 전체 빌드
pnpm typecheck        # 타입 검사
pnpm test             # 가벼운 기본 테스트 (Vitest만)
pnpm test:watch       # Vitest 감시 모드
pnpm test:e2e         # Playwright 브라우저 테스트
pnpm db:generate      # DB 마이그레이션 생성
pnpm db:migrate       # 마이그레이션 적용

pnpm test는 Playwright를 돌리지 않습니다. 브라우저 테스트는 따로 두고, 해당 흐름을 작업하거나 CI에서만 보통 돌려요.

전체 개발 가이드는 doc/DEVELOPING.md를 보세요.

로드맵

  • ✅ 플러그인 시스템 (예: 지식 베이스, 커스텀 추적, 큐 등 추가)
  • ✅ OpenClaw / 클로 스타일 에이전트 직원 지원
  • ✅ companies.sh — 조직 전체 가져오기 · 내보내기
  • ✅ 쉬운 AGENTS.md 설정
  • ✅ 스킬 매니저, 스킬 스튜디오, 스킬 스토어
  • ✅ 예약 루틴
  • ✅ 더 나은 예산 관리
  • ✅ 에이전트 검토와 승인
  • ✅ 여러 사람 사용자
  • ✅ 클라우드 / 샌드박스 에이전트 (e2b, Cloudflare, Daytona, Modal, Novita, boxd, 셀프 호스팅 Kubernetes)
  • ✅ 산출물과 작업 결과물
  • ✅ 심층 계획 (계획 모드, 리비전이 있는 계획, 계획 승인)
  • ✅ 강제되는 결과 (워치독, 복구 동작, 검토 관문)
  • ✅ MCP 도구 게이트웨이와 앱 (통제된 도구 접근)
  • ✅ 에이전트별 접근이 있는 시크릿 매니저
  • ✅ 활동 로그와 동작 귀속
  • ✅ 스스로 치유하는 실행과 자동 복구
  • ✅ 에이전트 평가와 피드백
  • ✅ 연결된 앱
  • ✅ 개인 · 공유 AI 계정
  • ✅ 공유 에이전트가 개인 GitHub 신원 사용
  • ✅ 스킬 버전 기록과 복원
  • ✅ 문서 댓글과 리비전 기록
  • ✅ 회사 전체 검색
  • ✅ 다중 모델 · 다중 하니스 팀
  • 🟡 메모리 / 지식
  • ⚪ MAXIMIZER MODE
  • ⚪ 작업 큐
  • ⚪ 자기 조직화
  • ⚪ 자동 조직 학습
  • 🟡 에이전트 채팅
  • 🟡 클라우드 배포
  • ⚪ 데스크톱 앱
  • ⚪ 자체 티켓 시스템 연결 (Asana / Linear / Jira를 진입로로)

짧은 로드맵 미리보기예요. 전체 로드맵은 ROADMAP.md에서 보세요.

커뮤니티와 플러그인

플러그인과 더 많은 자료는 awesome-paperclip에서 찾아보세요.

관측성

Paperclip은 서버용 선택형 OpenTelemetry 자동 계측(트레이스만)을 제공합니다. OTEL_EXPORTER_OTLP_ENDPOINT를 설정하면 켜지고, 표준 OTEL_EXPORTER_OTLP_PROTOCOL 환경 변수로 grpc, http/protobuf, http/json을 지원해요. @opentelemetry/api는 일반 서버 의존성이고, SDK · 자동 계측 · 익스포터 패키지는 선택형 피어 의존성이라 트레이싱을 쓰고 싶을 때만 설치하면 됩니다. 설치 명령과 전체 환경 변수 참고는 doc/observability.md를 보세요.

Paperclip은 서버와 브라우저용 선택형 Sentry 오류 모니터링도 제공합니다. 브라우저에서 켜려면 SENTRY_DSN_FRONTEND를, 서버에서 켜려면 SENTRY_DSN_BACKEND를 설정하세요. 각 변수는 선택 사항이고, 기존 SENTRY_DSN 변수도 어느 쪽이든 대체값으로 계속 동작합니다. 지원하는 서버 SDK 버전은 @sentry/node@10.71.0이며 서버용 선택형 피어 의존성이므로 오류 모니터링을 쓰고 싶을 때만 설치하세요. 브라우저 SDK인 @sentry/browser도 같은 정확한 버전에 고정돼 있어요. 설치 명령, 개인정보 설정, 기본 수집 항목 전체는 doc/observability.md를 보세요.

텔레메트리

Paperclip은 제품이 어떻게 쓰이는지 이해하고 개선하려고 익명 사용 텔레메트리를 수집합니다. 개인 정보, 이슈 내용, 프롬프트, 파일 경로, 시크릿은 절대 수집하지 않아요. 비공개 저장소 참조는 전송 전에 설치별 솔트로 해시됩니다.

방출하는 텔레메트리 이벤트를 바꾸는 기여자는 텔레메트리 데이터 계약(Telemetry Data Contract)을 따라야 합니다. 생성된 계약에 아직 없는 자체 이벤트를 제안할 때는 텔레메트리 워크플로(Telemetry Workflow)를 따르세요.

텔레메트리는 기본으로 켜져 있고, 다음 중 어느 방법으로든 끌 수 있어요.

방법설정
환경 변수PAPERCLIP_TELEMETRY_DISABLED=1
표준 관례DO_NOT_TRACK=1
CI 환경CI=true이면 자동으로 꺼짐
설정 파일Paperclip 설정에서 telemetry.enabled: false 지정

기여하기

기여는 언제나 환영합니다. 자세한 내용은 기여 가이드를 보세요.

함께할 분을 찾고 있어요

커뮤니티

라이선스

MIT © 2026 Paperclip Labs, Inc

Star History

Star History 차트


MIT 라이선스로 공개된 오픈소스입니다. 에이전트를 지켜보는 일이 아니라 일을 끝내는 일을 하고 싶은 사람들을 위해 만들었어요.

저장소: paperclipai/paperclip

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0