Paperclip — Orquestación de Agentes IA

Paperclip es un servidor Node.js + UI React open-source para orquestar equipos de agentes IA como si fueran una empresa. En lugar de babysitear 20 terminales de Claude Code, defines objetivos, contratas agentes, y supervisas desde un dashboard.

Si un agente es un empleado, Paperclip es la empresa.

---

Índice de capítulos

Cap	Título	Tema
01	El problema de orquestar agentes IA	Por qué existe Paperclip y qué lo diferencia
02	Instalación y primeros pasos	NPX onboard, clone manual, Docker
03	Arquitectura y conceptos fundamentales	Company, Agent, Heartbeat, Budget, Board
04	Tu primera compañía	Crear empresa, definir goals, org chart inicial
05	Agentes y adaptadores	Claude Code, OpenClaw, Codex, HTTP, Bash
06	Heartbeats y rutinas	Agentes que trabajan solos en schedule
07	Sistema de tickets	Gestión de trabajo, delegación y trazabilidad
08	Presupuestos y gobernanza	Control de costos, Board, approval gates
09	Despliegue en producción	PostgreSQL externo, Docker, Tailscale
10	Casos avanzados y ecosistema	Multi-empresa, plugins, Clipmart, roadmap

---

¿Para quién es este tutorial?

• Desarrolladores con múltiples agentes IA y sin forma de coordinarlos
• Equipos que quieren automatización 24/7 con control de costos
• Arquitectos que diseñan flujos de trabajo autónomos con IA
• Cualquiera que haya perdido el hilo de qué agente está haciendo qué

Prerequisitos

• Familiaridad básica con Node.js y línea de comandos
• Acceso a al menos un proveedor de IA (Anthropic, OpenAI, etc.)
• Node.js 20+ y pnpm 9.15+ instalados

---

Arquitectura general

graph TD
    B[Board — El humano] --> C[Company]
    C --> CEO[Agente CEO]
    CEO --> CTO[Agente CTO]
    CEO --> CMO[Agente CMO]
    CTO --> ENG1[Ingeniero 1\nClaude Code]
    CTO --> ENG2[Ingeniero 2\nCodex]
    CMO --> MKT[Marketing\nOpenClaw]

    HB[Heartbeat Scheduler] -->|despierta| CEO
    HB -->|despierta| ENG1
    HB -->|despierta| MKT

    T[Ticket System] --> ENG1
    T --> ENG2

    BUD[Budget Control] -->|limita gasto| CEO
    BUD -->|limita gasto| ENG1