Paperclip AI: qué es y cómo orquestar Claude Code, Codex y Cursor como un solo equipo

AI Dev Tools — General
, , , , , , ,
1

Paperclip
Paperclip1464×824 145 KB

Paperclip AI es un orquestador open source que convierte a Claude Code, Codex y Cursor en un solo equipo, con organigrama, presupuestos por agente y aprobaciones. Lo instalas en tu propia infraestructura, tiene licencia MIT y no requiere cuenta de Paperclip. Su última versión estable es v2026.916.0, publicada el 16 de septiembre con 503 commits.

Al momento de publicar esta nota (28 de septiembre de 2026), el repositorio sumaba 91.9K estrellas y 15.8K forks, y ese mismo día agregó 3.2K estrellas en GitHub Trending.

¿Qué es Paperclip AI?

Paperclip (también buscado como Paperclip IA) es un servidor en Node.js con una interfaz en React que coordina un equipo de agentes de IA hacia un objetivo de negocio. El README lo resume en una línea: si OpenClaw es un empleado, Paperclip es la empresa.

Parece un gestor de tareas. Por debajo, modela una organización completa:

  • Una empresa con un objetivo. El ejemplo del quickstart es construir una app de notas hasta llegar a USD 1M de MRR.
  • Agentes con roles. Un CEO, un CTO, ingenieros y marketers, cada uno con cargo, jefe directo, permisos y presupuesto.
  • Tareas que cargan toda su cadena de objetivos, así el agente ve por qué hace algo, no solo el título del ticket.
  • Heartbeats. Los agentes se despiertan según un calendario o por eventos (una asignación, una @-mención), revisan su trabajo y actúan.

El primer uso típico: creas una empresa, contratas un agente CEO y apruebas la estrategia que propone. A partir de ahí empieza a crear tareas en el tablero.

El README es igual de explícito sobre lo que Paperclip no es:

  • no es un chatbot
  • no es un framework de agentes
  • no es un constructor de flujos drag-and-drop
  • no es un gestor de prompts
  • no es una herramienta de code review

No construye agentes. Gestiona la organización en la que trabajan tus agentes, lo que en inglés se conoce como multi-agent orchestration o AI agent orchestration.

¿Qué agentes puedes conectar a Paperclip?

Paperclip funciona con cualquier agente que pueda “recibir un heartbeat”. La referencia oficial de adaptadores lista actualmente:

  • Claude Code
  • Codex
  • Gemini CLI
  • Cursor (local y en la nube)
  • OpenCode
  • Pi
  • Hermes (local y gateway)
  • Grok
  • Kimi Code
  • OpenClaw Gateway

También tiene adaptadores genéricos de Process y HTTP, más un SDK para escribir los tuyos. La ejecución en sandbox se soporta mediante proveedores como e2b, Cloudflare, Daytona, Modal y Kubernetes autoalojado.

Si leíste nuestra cobertura de OpenClaw o de Hermes Agent, esta es la capa que va por encima de ellos. Hermes es un adaptador integrado desde la versión v2026.626.0.

¿Paperclip o OpenClaw: cuál necesitas?

No tienes que elegir, porque Paperclip usa a OpenClaw, Claude Code y compañía. El FAQ del proyecto lo responde de forma directa: Claude Code u OpenClaw hacen el trabajo, y Paperclip convierte a varios de ellos en una organización con presupuestos, objetivos, gobernanza y responsabilidad.

El README traza la línea con claridad. Con un solo agente, probablemente no necesitas Paperclip. Con veinte, sí.

Su tabla de “problemas que resuelve” parece el diario de cualquiera que usa agentes en serio:

  • veinte pestañas de Claude Code abiertas sin saber cuál hace qué
  • sesiones que se pierden al reiniciar
  • contexto que hay que volver a explicar a mano cada vez
  • un loop descontrolado que quema el presupuesto de tokens del día antes de que alguien lo note

También responde la pregunta obvia de por qué no conectar tus agentes a Trello o Asana. La coordinación tiene sutilezas que un gestor genérico no resuelve:

  • quién tiene tomada una tarea
  • cómo persisten las sesiones
  • cómo se aplica el límite de gasto

Paperclip resuelve el checkout de tareas y el control de presupuesto de forma atómica, así dos agentes no pueden trabajar el mismo ticket a la vez. Si ya probaste un enfoque más liviano como oh-my-claudecode, que orquesta dentro de Claude Code, Paperclip juega en otra escala: varios proveedores, varias personas y varias empresas en una misma instancia.

¿Cómo controlas el costo de un sistema multiagente?

El control de costos es donde Paperclip se gana su lugar para quien firma la factura:

  • Presupuesto mensual por agente. Cuando un agente llega a su límite, se detiene.
  • Avisos antes del corte. Las políticas de presupuesto pueden advertir al cruzar un umbral, antes del corte definitivo.
  • El exceso queda contenido. Si se pasa el límite, los agentes se pausan y el trabajo en cola se cancela automáticamente.
  • Seguimiento detallado. El consumo de tokens y costos se desglosa por empresa, agente, proyecto, objetivo, issue, proveedor y modelo.

La documentación oficial da su propia estimación de lo que pagarás a tu proveedor de modelos:

  • entre USD 5 y 20 para probar el producto
  • entre USD 20 y 100 al mes para una empresa activa

Son cifras del propio proveedor, no medidas por nosotros. La documentación también recomienda definir presupuestos por agente y por empresa antes de activar los heartbeats.

¿Paperclip AI es gratis?

Sí, el software es gratuito y open source (MIT). Lo alojas tú y no necesitas una cuenta de Paperclip.

Lo que pagas es el uso de modelos: tu API key de Anthropic u OpenAI, o tu suscripción existente de Claude o Codex. Desde la versión v2026.916.0, esas credenciales se pueden conectar mediante el nuevo sistema de Connections.

Las notas de versión también mencionan un Paperclip Cloud alojado. Al momento de publicar esta nota, no encontramos precios públicos para ese servicio.

¿Cómo instalar Paperclip AI?

Necesitas Node.js 24.11 o superior. El camino recomendado descarga el instalador y verifica su checksum antes de ejecutarlo:

curl -fsSLO https://paperclip.ing/install.sh
curl -fsSLO https://paperclip.ing/install.sh.sha256
if command -v sha256sum >/dev/null 2>&1; then
  sha256sum -c install.sh.sha256
else
  shasum -a 256 -c install.sh.sha256
fi
bash install.sh

El instalador:

  • se asegura de que haya una versión compatible de Node.js
  • instala un CLI gestionado paperclipai en ~/.paperclip/cli
  • inicia el onboarding interactivo
  • opcionalmente, instala Paperclip como servicio en segundo plano en sistemas Linux y macOS compatibles

Para probarlo sin instalar nada de forma permanente:

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

Ese camino arranca en modo local de confianza (loopback), la forma más rápida de tener un primer run. Para usarlo en modo autenticado dentro de tu red o tu tailnet, elige un preset de bind de forma explícita:

paperclipai onboard --yes --bind lan
# o:
paperclipai onboard --yes --bind tailnet

Desde el código fuente necesitas Node.js 24.11+ y pnpm 9.15+:

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

Esto levanta el servidor de la API en http://localhost:3100, con una base PostgreSQL embebida que se crea automáticamente. Para producción, lo apuntas a tu propio Postgres.

Para usar el adaptador de Claude Code, Claude Code tiene que estar instalado en la misma máquina.

¿Paperclip funciona en Windows?

En parte, y depende de qué pieza hablemos.

  • Los agentes locales corren de forma nativa en Windows. Desde la versión v2026.722.0, Claude, Codex, Gemini y los agentes ACP personalizados se ejecutan de forma nativa en Windows además de Linux.
  • La instalación gestionada del CLI y el ciclo de vida del servicio están documentados para Linux, macOS, contenedores y WSL.
  • El script de instalación es Bash. En Windows, las rutas realistas son WSL o el camino con npx teniendo Node.js 24.11+ instalado.

¿Qué trae la versión v2026.916.0?

La versión del 16 de septiembre se centra en credenciales y en alcance.

Ya disponible:

  • Las credenciales de IA pasan a Connections. Las suscripciones de Claude y Codex, las API keys y las cuentas compartidas se vuelven cuentas gestionadas con permisos. Siguen a la persona responsable durante la contratación de agentes y la ejecución de tareas. El mismo agente puede correr con la suscripción de una persona y con la API key de otra.
  • El acceso a GitHub pasa a identidades por persona. Identidades respaldadas por una GitHub App reemplazan un único token compartido.

Experimental (desactivado por defecto o detrás de un flag):

  • bandejas de correo AgentMail para agentes
  • conectores de chat nativos para Slack, Discord, Telegram y Microsoft Teams, más iMessage mediante Photon
  • Agent Chat dentro de la app
  • el motor de ejecución Paperclip Runner

Cambios incompatibles que conviene conocer:

  • Se elimina el modo de ejecución de “perfiles de modelo barato”.
  • X-Forwarded-Host ahora solo se respeta si viene de un proxy de confianza. Si corres Paperclip detrás de un reverse proxy, confirma que TRUST_PROXY esté configurado.

¿Qué debe revisar un equipo de seguridad antes de desplegarlo?

Hay dos puntos clave para cualquiera que ponga Paperclip en un servidor compartido.

  • Actualiza a v2026.916.0. Antes de esta versión, los endpoints de la API de agentes devolvían en texto plano las credenciales almacenadas a cualquier llamada con permiso para leer el agente, incluido el propio agente (PR #9860). La versión nueva pasa todas las respuestas por una capa que las redacta, y el propio proyecto describe el comportamiento anterior como una filtración.
  • La telemetría viene activada por defecto. El proyecto afirma que no envía información personal, prompts, rutas de archivos ni secretos, y que hashea las referencias a repositorios privados. Puedes desactivarla con PAPERCLIP_TELEMETRY_DISABLED=1 o DO_NOT_TRACK=1. Se desactiva automáticamente cuando CI=true.

En gobernanza, los controles que un CTO esperaría ya están:

  • puertas de aprobación
  • configuración versionada con rollback
  • secretos acotados por agente
  • propuestas de secretos que un humano debe aprobar
  • un registro de actividad inmutable que atribuye cada cambio a un actor

¿Qué todavía no está disponible?

Al momento de publicar esta nota, el roadmap público marca como aún no entregados:

  • Memory/Knowledge
  • una app de escritorio (la documentación apunta a una no oficial de la comunidad)
  • colas de trabajo
  • traer tu propio sistema de tickets (Asana, Linear o Jira como puerta de entrada)
  • Connected Apps con un clic

Los despliegues en la nube figuran como parcialmente entregados.

¿Vale la pena Paperclip AI?

Si usas un solo agente, Paperclip es sobrecarga. Si ya llegaste al punto en que varios agentes corren en paralelo entre distintos proveedores, te da las piezas que de otra forma construirías mal por tu cuenta:

  • un tablero de tareas que los agentes no pueden reservar dos veces
  • presupuestos con corte automático
  • aprobaciones
  • un registro de auditoría

Es la respuesta open source más completa que hemos visto hasta ahora a una pregunta que ya nos hicimos: ¿la orquestación importa más que el modelo?