본문으로 건너뛰기

© 2026 Molayo

Dev.to헤드라인2026. 05. 16. 18:20

채용을 멈추고 오케스트레이션(Orchestrating)을 시작하세요: Railway에서 Paperclip으로 AI 에이전트 기업 운영하기

요약

이 글은 AI 에이전트가 인간의 개입 없이 기업 운영의 대부분을 처리하는 '제로 휴먼(zero-human)' 개념을 소개합니다. Paperclip이라는 도구는 미션, 예산, 에이전트 페르소나를 정의하면, 이 에이전트들이 정해진 일정에 따라 작업을 수행하고 결과를 보고하는 완전한 AI 오케스트레이션 플랫폼 역할을 합니다. 이를 통해 콘텐츠 제작사 같은 전문 조직을 인원수 기반이 아닌 자율적인 에이전트 시스템으로 구축할 수 있으며, Railway와 같은 관리형 호스팅 환경에 Paperclip을 배포하는 구체적인 기술 가이드도 제공합니다.

핵심 포인트

  • AI 에이전트를 활용하여 인간의 개입 없이 기업 운영(Zero-Human Company) 모델 구현 가능
  • Paperclip은 AI 노동을 위한 '인간 제어 평면'으로, 미션과 페르소나를 기반으로 에이전트 오케스트레이션을 수행함
  • 에이전트는 하트비트를 받고 작업을 가져와 LLM을 호출하며 결과를 게시하는 방식으로 작동함
  • Paperclip 배포는 Railway 같은 관리형 플랫폼에서 커스텀 Dockerfile 및 환경 변수 설정을 통해 진행됨
  • 각 에이전트는 독립적인 어댑터, 시스템 프롬프트, 작업 큐를 가지며, 다양한 LLM(Claude, Gemini 등)을 선택적으로 사용함

이 글은 alphasec.io의 교차 게시물입니다. 원문은 여기에서 확인할 수 있습니다. 1인 기업이라는 개념은 새로운 것이 아닙니다. 하지만 새로운 점은 그 사람이 실제 업무의 대부분을 수행하지 않는 1인 기업이라는 아이디어입니다. AI 에이전트(AI agents)가 그 일을 합니다. 당신은 방향을 설정하고, 역할과 예산을 정의하며, 에이전트들은 두 번 요청할 필요 없이 정해진 일정에 따라 작성, 조사, 분석, 보고 등의 실행을 처리합니다. 그리고 Paperclip과 같은 도구들은 이를 오늘 바로 실행할 수 있을 만큼 현실적으로 만들고 있습니다.

Paperclip이란 무엇일까요? Paperclip은 스스로를 "AI 노동을 위한 인간 제어 평면 (human control plane for AI labor)"이라고 설명합니다. 당신은 기업을 정의하고 — 미션, 예산, 에이전트 페르소나(personas) 세트를 부여하면 — Paperclip이 이를 운영합니다. 에이전트들은 정해진 일정에 따라 하트비트(heartbeats)를 받고, 열려 있는 작업(tasks)을 가져오며, 할당된 대규모 언어 모델 (LLM)을 호출하고, 결과를 이슈 댓글로 다시 게시합니다. 이는 사실상 모든 팀원이 AI 에이전트인 프로젝트 관리 도구입니다.

Paperclip은 대규모로 완전히 자율적인 에이전트 운영을 실행하는 실험으로 시작되었습니다 — "제로 휴먼 기업을 위한 오픈 소스 오케스트레이션 (open-source orchestration for zero-human companies)". 이는 더 넓은 개념으로 진화하고 있습니다: 인원수(headcount)가 아닌 자율 에이전트로 운영되는 기업을 구축하기 위한 완전한 에이전트 오케스트레이션 플랫폼으로 말이죠. 피벗(pivot)은 여전히 진행 중이지만, 핵심 아이디어는 이미 배포하고 탐색할 만큼 충분히 매력적입니다.

조직의 단위는 기업(company)입니다. 기업 내부에는 에이전트(역할, 어댑터, 하트비트 일정을 가진 페르소나), 프로젝트(projects), 그리고 이슈(issues, 작업)가 있습니다. 에이전트는 하트비트가 작동할 때 깨어나서 자신에게 할당된 것을 확인하고, 업무를 수행한 뒤 다시 잠듭니다. 미리 구축된 기업이라는 개념은 매우 강력하며, 생태계는 companies.sh를 중심으로 천천히 성장하고 있습니다 — 이는 단 한 번의 명령으로 Paperclip에 가져올 수 있는 미리 구축된 기업 정의들입니다. 외부 침투 테스트 팀, 콘텐츠 에이전시, 또는 소프트웨어 개발 숍이 AI 에이전트로 완전히 채워져 몇 초 만에 가져올 수 있다고 상상해 보십시오.

구체적인 예로, 효율적인 콘텐츠 에이전시(content agency)의 모습은 다음과 같을 수 있습니다:

에이전트 역할작업 내용빈도
편집장 (Editor in Chief)브리프(briefs)를 검토하고, 기사를 할당하며, 편집 방향을 설정합니다.매일
리서치 분석가 (Research Analyst)소스를 모니터링하고, 기사를 발굴하며, 리서치 노트를 초안 작성합니다.6시간마다
작가 (Writer)리서치 노트와 브리프를 바탕으로 포스트 초안을 작성합니다.온디맨드 (On demand)
SEO 분석가 (SEO Analyst)키워드 커버리지와 구조를 위해 초안을 검토합니다.온디맨드 (On demand)
발행인 (Publisher)최종 결과물을 포맷팅하고 스케줄링합니다.매일

모든 에이전트는 사용자가 선택한 LLM (Large Language Model)에 의해 구동됩니다. 편집장은 판단력이 중요한 결정을 위해 Claude를 사용할 수 있고, 리서치 분석가는 속도와 비용을 위해 Gemini Flash를 사용할 수 있습니다. 각 에이전트는 자신만의 어댑터(adapter), 시스템 프롬프트(system prompt), 작업 큐(task queue)를 가집니다. Paperclip은 이들을 조율(coordinated)합니다.

Railway에 Paperclip 배포하기

이 섹션에서는 인프라, TLS 및 배포를 서버 관리 없이 처리하는 관리형 앱 호스팅 플랫폼인 Railway에 Paperclip을 배포하는 방법을 다룹니다. 고정된 월 비용이 드는 VPS 접근 방식을 원하신다면, 대신 DigitalOcean 가이드를 참고하십시오.

사전 요구 사항: Railway 계정, 그리고 최소 하나 이상의 LLM 제공업체(Anthropic, OpenAI 또는 Gemini)로부터 받은 유효한 API 키.

Paperclip은 공식 Paperclip 이미지를 래핑(wrap)하는 커스텀 Dockerfile을 통해 실행됩니다. entrypoint.sh 스크립트가 첫 부팅 설정을 처리합니다. 즉, 환경 변수로부터 config.json을 작성한 다음 pnpm paperclipai run으로 제어권을 넘깁니다. 이 접근 방식은 몇 가지 명확하지 않은 문제들을 우회합니다. 첫째, Paperclip CLI의 run 명령은 --yes 또는 --no-onboard 플래그를 허용하지 않습니다(이 플래그들은 onboard에 속함). 둘째, config.json$meta.source 필드는 특정 열거형(enum) 값(onboard, configure, doctor)만 허용합니다. 셋째, 인증 모드에서 Railway의 / 경로에 대한 헬스 체크(health check)는 403을 반환하며, 이를 /api/health로 지정하더라도 역시 403을 반환합니다. 헬스 체크를 완전히 제거하고 프로세스 생존 여부(process liveness)에 의존함으로써 이 문제를 해결합니다.

Paperclip은 Railway에서 두 가지 데이터베이스 구성을 지원합니다:

  • 임베디드 PostgreSQL (Embedded PostgreSQL, 단일 서비스) — DATABASE_URL을 설정하지 마십시오.

Paperclip은 내장된 데이터베이스를 실행합니다. 낮은 비용(월 약 $5-6)으로, 평가 및 소규모 팀에 적합합니다. 배포하려면 Paperclip (Lite) 원클릭 스타터 템플릿(one-click starter template)을 실행하십시오.

외부 PostgreSQL (두 개의 서비스) — Railway Postgres 애드온(addon)을 추가하고 DATABASE_URL${{Postgres.DATABASE_URL}}에 연결하십시오. 더 견고하며, 프로덕션(production) 환경에 권장됩니다. 월 약 $10-12의 비용이 발생합니다. 배포하려면 Paperclip 원클릭 스타터 템플릿을 실행하십시오.

배포 후 설정 및 연결

Railway는 에지(edge)를 통해 트래픽을 내부 포트 3100으로 라우팅하므로, 공개 URL에서 별도의 포트 설정이 필요하지 않습니다. 서비스가 실행되면 관리자 초대 URL(admin invite URL)이 서비스 로그에 나타납니다. Railway 대시보드에서 배포된 서비스로 이동 → View logs → Deploy logs를 선택한 후 'invite'를 검색하십시오.

=========================================
Paperclip deployed

URL: https://paperclip.yourdomain.com
Invite URL: https://paperclip.yourdomain.com/invite/pcp_bootstrap_...

URL을 열어 Paperclip의 네이티브 설정 화면을 통해 관리자 계정을 생성하십시오. 단일 사용자 모드(single-user mode)의 경우, 서비스 변수(Variables)에 PAPERCLIP_AUTH_DISABLE_SIGN_UP=true를 추가하고 다시 배포하여 추가 등록을 차단할 수 있습니다.

몇 가지 어댑터(adapters)는 환경 변수(environment variables)를 통해 즉시 작동하며, 대화형 로그인(interactive login)이 필요하지 않습니다:

ProviderAdapter in PaperclipEnvironment Variable
Anthropicclaude_localANTHROPIC_API_KEY
OpenAIopencode_localOPENAI_API_KEY
Geminiopencode_localGEMINI_API_KEY

Gemini의 경우, 어댑터로 opencode_local을 선택하고 에이전트 설정에서 모델(예: gemini-2.5-flash)을 선택하십시오. gemini_local 어댑터는 대화형 OAuth가 필요하므로 Railway 컨테이너(container)에서는 작동하지 않습니다. 마찬가지로, codex_local 어댑터는 헤드리스(headless) 상태에서 완료할 수 없는 WebSocket 기반 인증이 필요하므로, OpenAI 모델의 경우 opencode_local을 사용하십시오.

다음 단계

여기서 다룬 배포는 시작일 뿐입니다. Paperclip이 깔끔하게 실행되고, 에이전트(agents)가 연결되어 작업을 받을 준비가 되었습니다.

진정으로 흥미롭고 (즐거운) 부분은 그 위에 무엇을 구축하느냐에 달려 있습니다. GitHub 저장소에는 고정 비용 서버(fixed-cost server)를 선호하는 경우를 위해 단일 스크립트 VPS 배포가 포함된 digitalocean/ 폴더도 포함되어 있습니다. 저는 companies.sh 개념에 매료되었으며, 후속 작업으로 목적에 맞게 구축된 에이전트 기업(purpose-built agent company)을 탐구하고 있습니다. 즉, 보안 권고(security advisories)를 모니터링하고, IOC(침해 지표) 및 TTP(전술, 기법, 절차)를 추출하며, 탐지 규칙(detection rules)을 생성하는 위협 인텔리전스(threat intelligence) 팀을 구축하는 것입니다. 이것이 흥미롭게 들린다면, 다음 내용이 이어질 것입니다.

AI 자동 생성 콘텐츠

본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0