Paperclip orquestación de agentes de IA: el repositorio paperclipai/paperclip ofrece un servidor Node.js y una interfaz React para dirigir un equipo de agentes de IA como se dirige un gestor de tareas, con organigrama, presupuestos y validaciones. Mostraba unas 103 000 estrellas a mediados de octubre de 2026. El propio proyecto se resume así: «Si OpenClaw es un empleado, Paperclip es la empresa».
Para un equipo de operaciones, el interés está en otra parte que la metáfora: en cuanto una decena de agentes trabajan en paralelo, ya no se sabe quién hizo qué, cuánto costó ni qué agente tiene derecho a tocar qué. Paperclip pretende responder a esas tres preguntas (actividad, costes, permisos). Este artículo presenta lo que dice el repositorio, cómo instalarlo según el README y cómo supervisar una flota de agentes así.
La información procede del README y de la documentación del proyecto. span.observer no ha instalado Paperclip: la imagen y el esquema siguientes proceden del repositorio.
Paperclip orquestación de agentes de IA: lo que dice el repositorio
- Licencia: MIT. El archivo LICENSE indica «Copyright (c) 2025 Paperclip AI», mientras que el pie de página de GitHub menciona «Paperclip Labs, Inc.»; el nombre de la entidad varía según la página.
- Tecnología: servidor Node.js (24.11 o posterior) e interfaz React, con una base de datos PostgreSQL integrada en local.
- Última versión: v2026.1012.0, publicada el 12 de octubre de 2026, tras v2026.1005.0 y v2026.1001.0: una versión cada una o dos semanas.
- Posicionamiento: «no es un framework de agentes» (el README): tus agentes (Claude Code, Codex, Cursor, Gemini CLI, OpenClaw, procesos o webhooks personalizados) siguen siendo lo que son, y Paperclip los organiza como una empresa con objetivos, roles y presupuestos.
- Oferta comercial: el README también remite a una lista de espera para «Paperclip Cloud»; el software autoalojado no exige cuenta.

El esquema del repositorio agrupa las funciones en cuatro pilares: tareas y validaciones, organigrama y permisos, formación y evaluación de los agentes, e infraestructura (ejecución multiproveedor, sandbox, SSO, control de costes, historial de ejecuciones y trazado «opt-in»).
Instalar Paperclip según el README
Paso 1 — Lanzar la incorporación
npx paperclipai@latest onboard --yes
El README precisa que el comando se ejecuta desde la caché de npm y que la configuración y los datos se quedan en local. Por defecto, el inicio rápido usa el modo «local de confianza» en el bucle local. Para arrancar en modo autenticado, elige un ajuste preconfigurado de enlace:
npx paperclipai@latest onboard --yes --bind lan
# o
npx paperclipai@latest onboard --yes --bind tailnet
Si Paperclip ya está configurado, volver a lanzar onboard conserva la configuración; npx paperclipai configure permite modificarla.
Paso 2 — Probar sin comprometer nada
El README describe test-drive: una instancia de prueba aislada, ya inicializada con un agente «CEO», que se queda en primer plano y no crea ningún servicio ni una primera tarea.
ANTHROPIC_API_KEY=... npx paperclipai test-drive
Paso 3 — O desde el código fuente
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev
La interfaz y la API arrancan en http://localhost:3100, con una base de datos PostgreSQL integrada. Requisitos: Node.js 24.11 y pnpm 9.15 o posteriores. Para un uso duradero, el README aconseja apuntar a tu propio PostgreSQL y describe un despliegue con Docker.
Bajo el capó
El README publica un esquema de arquitectura: un único servidor reúne la identidad y los accesos, las tareas, la ejecución por «heartbeat», la gobernanza, el organigrama, los espacios de trabajo, los plugins, el presupuesto, las rutinas, los secretos, la actividad y los eventos.

Dos mecanismos cuentan para la fiabilidad: el «checkout» atómico de las tareas (un solo agente por tarea, con bloqueos de ejecución) y las paradas de presupuesto («hard stops»).
Supervisar un equipo de agentes Paperclip
Un orquestador concentra los riesgos: decide quién trabaja, con qué secretos y a qué precio. Las medidas de coste de un agente de IA y de barreras de seguridad (guardrails) se aplican, por tanto, dos veces: a nivel de cada agente y a nivel del orquestador.
El menú Audit: actividad, ejecuciones, costes, presupuestos
La documentación describe una página Audit con cinco pestañas: Activity, Runs, Costs, Budgets y Timeline.
- Activity: cada modificación (estado de una tarea, comentario, contratación, pausa de un agente, aprobación, gasto) se registra con el actor, la acción, la entidad, los detalles y la marca de tiempo. Un interruptor permite conservar solo las acciones de agentes.
- Costs: por cada llamada, Paperclip registra el agente, el modelo, el número de tokens y el coste en dólares, agregados por agente y por mes natural UTC. La documentación precisa que el importe retenido es el facturado tras el descuento de caché, y que los tokens en caché se cuentan aparte.
- Budgets: umbrales por empresa, agente o proyecto. Según la documentación, se registra una advertencia al 80 % y el agente se pone en pausa automáticamente al 100 %.
El README matiza la parada: se apoya en el gasto registrado, y el retraso en la declaración del uso o el trabajo en curso pueden retrasarla. Un tope de presupuesto es una barrera de seguridad, no una garantía al céntimo.
¿Y OpenTelemetry?
En el README y en las páginas de documentación consultadas, no he encontrado una exportación OpenTelemetry documentada. El proyecto menciona un sistema de plugins («seguimiento personalizado» como ejemplo) y un historial de ejecuciones con trazado «opt-in». Si necesitas trazas en tu backend, comprueba la documentación de los plugins y de la API (costes, actividad) antes de prometer un dashboard: si no, consulta la API de costes y de actividad, e instrumenta los propios agentes como en la observación de los agentes MCP.
Cómo comprobar que funciona
- Un agente de prueba recibe una tarea: la pestaña Activity muestra el cambio de estado, la pestaña Runs la ejecución y la pestaña Costs una línea de coste para el modelo usado.
- Un presupuesto deliberadamente bajo dispara la alerta al 80 % y luego la pausa al 100 %: comprueba que el incidente aparece en Budgets.
- El total mensual de Paperclip es coherente con la consola del proveedor de modelos, salvo el descuento de caché.
Límites y puntos abiertos
- Crecimiento y juventud. Más de 100 000 estrellas y versiones semanales: la atención es masiva, pero la estabilidad de las interfaces está por demostrar. Varias funciones del README están marcadas como «experimentales» (Agent Chat, conectores de mensajería).
- Afirmaciones del README. El texto presume de orquestar «negocios autónomos»; ningún resultado cifrado es verificable desde el repositorio. El propio proyecto responde a la pregunta «¿está mantenido?» citando más de 2 700 solicitudes de fusión aceptadas: es una declaración del proyecto.
- Permisos de los agentes. El modo por defecto es «local de confianza»; los agentes invocados (Claude Code, Codex, shell) conservan sus propios permisos en la máquina. La orquestación no es aislamiento: combínala con un runtime aislado como NVIDIA OpenShell.
- Gastos reales. La documentación avisa de que los agentes hacen llamadas reales y facturadas; fija un presupuesto antes de automatizar.
Buenas prácticas
- Empieza con
test-drivey un presupuesto bajo; amplía después. - Mantén el modo local de confianza para un equipo personal; si no, usa el modo autenticado y una red privada.
- Da a cada agente un presupuesto y unos secretos distintos, y revisa la pestaña Activity cada semana.
- Exporta con regularidad costes y actividad a tu herramienta de monitorización, y crea alertas sobre la diferencia entre el gasto de Paperclip y la factura del proveedor.
- Trata un agente en bucle como un incidente de fiabilidad, sin buscar culpables.
Preguntas frecuentes
¿Paperclip sustituye a OpenClaw o a Claude Code?
No. Según el README, Paperclip usa esos agentes y los organiza en equipo. Consulta nuestro artículo sobre OpenClaw.
¿Es gratis Paperclip?
El código tiene licencia MIT y el autoalojamiento no pide cuenta. Las llamadas a los modelos las factura tu proveedor; se anuncia una oferta en la nube con lista de espera.
¿Dónde se guardan los datos?
En local, un proceso Node.js gestiona una base de datos PostgreSQL integrada y un almacenamiento de archivos local; en producción, el README propone tu propio PostgreSQL.
Conclusión
Paperclip responde a una necesidad real: hacer legible una flota de agentes, con una actividad auditable y presupuestos. Sigue siendo un proyecto de crecimiento muy fuerte, cuyas funciones evolucionan rápido y cuyas afirmaciones conviene releer en el repositorio. Trátalo como un servicio con privilegios: presupuestos bajos, aislamiento de los agentes y revisión periódica de la pestaña Audit.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni a los proyectos citados. Las marcas citadas pertenecen a sus propietarios. Las herramientas evolucionan rápido: comprueba los comandos y las opciones en su documentación oficial (docs.paperclip.ing).