Paperclip: el plano de control para equipos de agentes

Todo lo que hay que saber sobre paperclipai/paperclip: una aplicación de código abierto para organizar, supervisar y gobernar trabajo realizado por varios agentes de IA.

---

Qué es Paperclip

Paperclip es un servidor Node.js con interfaz React que funciona como plano de control para equipos de agentes. No pretende construir al agente ni sustituir su modelo: conecta agentes y entornos propios bajo una estructura común de objetivos, puestos, tareas, presupuestos, aprobaciones y registros de auditoría.

Su metáfora central es empresarial: se define una meta, se incorporan agentes con responsabilidades y se revisa su estrategia antes de ejecutar. El README afirma que puede coordinar OpenClaw, Claude Code, Codex, Cursor, agentes de consola y agentes HTTP; la condición operativa es que puedan recibir un heartbeat o señal de activación. El proyecto se diferencia así de una ventana de chat y de un constructor visual de flujos: administra una organización, no una conversación ni un único agente.

El origen: de un andamiaje a Paperclip Labs

El primer commit recuperable del historial es de 16 de febrero de 2026, firmado por Forgotten desde la cuenta forgottendev; ya contenía el andamiaje de un monorrepositorio pnpm, servidor, interfaz, Docker y PostgreSQL. GitHub fecha la creación pública del repositorio el 2 de marzo de 2026.

La fuente más clara sobre el liderazgo actual es el perfil de GitHub de Dotta (cryppadotta): se presenta como CEO de Paperclip Labs, enlaza paperclip.ing y figura como principal contribuidor por volumen en la API. El sitio y el README sitúan el problema en una fricción concreta: cuando una persona abre muchos agentes de código en paralelo, pierde estado, contexto, trazabilidad de costes y capacidad de detener ejecuciones. Paperclip responde introduciendo una jerarquía, una cola persistente y controles de aprobación.

También hay una tensión narrativa deliberada: el proyecto usa la imagen de una «empresa sin humanos», pero su documentación insiste en que una persona conserva la facultad de aprobar incorporaciones, revocar estrategia, pausar o terminar agentes. Es una propuesta de autonomía supervisada, no de eliminación verificable de la supervisión humana.

Filosofía y principios

La documentación articula cuatro pilares:

1. Trabajo agente con verificación humana: se declara la intención, los agentes trabajan y el resultado se comprueba mediante cambios, capturas o pruebas.
2. Organización y límites: organigrama, funciones, permisos, responsables y secretos delimitados por compañía.
3. Formación y evaluación: habilidades compartidas, Skill Studio, ejecuciones de prueba, evaluaciones y métricas de calidad.
4. Infraestructura operativa: entornos de ejecución de varios proveedores, aislamiento, herramientas MCP, control de costes y trazas internas.

El principio técnico que conecta esos pilares es la responsabilidad: una tarea conserva su ascendencia de meta; las ejecuciones, decisiones y llamadas de herramientas generan actividad durable; y los presupuestos pueden detener agentes. Esto describe mecanismos documentados, no una garantía de que toda salida de un agente sea correcta.

Cómo funciona

El recorrido básico es: definir una meta → crear el equipo → aprobar la estrategia y presupuestos → supervisar el tablero. Una tarea se asigna a un agente; la asignación o una programación despierta el agente; este recibe el contexto de la tarea, proyecto y compañía; la ejecución deja registros, coste, estado de sesión y resultados para revisión.

Componentes y patrones verificables:

• Tareas y organigrama: incidencias con dependencias, comentarios, archivos y bloqueos; puestos con responsable, permisos, presupuesto y línea jerárquica.
• Heartbeats y rutinas: cola persistida en base de datos, activaciones programadas, por asignación o por menciones; la ejecución incluye comprobación de presupuesto, resolución de espacio de trabajo, carga de habilidades e invocación del adaptador.
• Gobernanza: aprobaciones, políticas de ejecución, revisión de planes, pausa, reanudación o terminación de agentes y bitácora de auditoría.
• Entornos y seguridad: espacios de proyecto y aislados; secretos de instancia o compañía; el README especifica que los valores sensibles solo se proyectan a una ejecución delimitada que los necesita.
• Extensibilidad: sistema de complementos con procesos externos, capacidades delimitadas, trabajos programados, herramientas e interfaces; en la hoja de ruta figuran acceso gobernado a MCP y gestores de secretos.

Para instalarlo, el README ofrece un instalador y una prueba con npx --registry https://registry.npmjs.org paperclipai onboard --yes; para desarrollo propone pnpm install y pnpm dev. Requiere Node.js 20 o posterior y pnpm 9.15 o posterior. El modo local inicia la API en http://localhost:3100 y crea PostgreSQL embebido; en producción permite usar PostgreSQL propio.

Estado oficial y semioficial

Paperclip es software de código abierto con licencia MIT, atribuido en el README a Paperclip Labs, Inc. La página oficial presenta compatibilidad con Claude, Codex, Gemini, Cursor, Hermes, OpenClaw, Pi y OpenCode, y el README nombra adaptadores de Claude Code, Codex, Cursor, Bash y HTTP. Esa compatibilidad es una declaración del proyecto, no una certificación de Anthropic, OpenAI, Google, Cursor, Nous Research ni OpenClaw.

Durante esta investigación no se recuperó evidencia de que Paperclip haya sido aceptado en un mercado oficial de alguno de esos proveedores ni de un aval formal de un fabricante. Su posición práctica es la de capa independiente y agnóstica de proveedores; sus 75 mil estrellas y la existencia de adaptadores de terceros muestran adopción de facto, pero no constituyen un estándar formal ni una aprobación del proveedor.

El ecosistema

Repositorios de Paperclip Labs

La API de GitHub de la organización devuelve los siguientes repositorios relacionados, con sus estrellas al momento de la consulta:

• paperclipai/companies — plantillas o compañías para Paperclip; 814 estrellas.
• paperclipai/hermes-paperclip-adapter — adaptador para ejecutar Hermes Agent como empleado administrado; 25 estrellas. La versión de NousResearch/hermes-paperclip-adapter alcanzaba 1.778 estrellas en la búsqueda de GitHub consultada.
• paperclipai/companies-tool — herramienta npx companies; 41 estrellas.
• paperclipai/clipmart — mercado para comprar y vender compañías de agentes; 76 estrellas.
• paperclipai/paperclip-docs y paperclipai/docs — documentación; 12 y 7 estrellas, respectivamente.
• paperclipai/pr-reviewer — interfaz de triaje de solicitudes de cambios; 13 estrellas.

El código principal contiene además directorios evals, skills y skills-releases/paperclip; el README documenta Skill Studio, tienda de habilidades y evaluaciones como piezas del producto, no como repositorios separados.

Comunidad, puertos y extensiones

• gsxdsm/awesome-paperclip — catálogo comunitario de complementos de Paperclip; 830 estrellas. Es la lista enlazada por el README para descubrir complementos.
• aronprins/paperclip-desktop — envoltorio Electron no oficial para macOS que empaqueta el servidor @paperclipai/server; 559 estrellas. Su descripción anuncia Windows y Linux como futuros, por lo que no debe interpretarse como cliente oficial multiplataforma.
• aronprins/paperclip-company-playbook — guía práctica para configurar una compañía de agentes; 196 estrellas.
• Yesterday-AI/paperclip-plugin-company-wizard — complemento para crear compañías desde plantillas modulares; 161 estrellas.
• gcampton/Agent-Pixels — implementación de complemento con cámaras de seguridad para Paperclip; 91 estrellas.
• mvanhorn/paperclip-plugin-telegram — bot bidireccional de Telegram con notificaciones, comandos, aprobación/rechazo y enrutamiento de respuestas; 85 estrellas.
• penclipai/paperclip-cn — bifurcación en chino; 68 estrellas. También se recuperaron las traducciones coreanas yong076/paperclip-ko (5 estrellas) y TripleHwang/paperclipKR (3 estrellas). Son bifurcaciones comunitarias, no localizaciones publicadas por Paperclip Labs.

Las cifras anteriores proceden de la API de GitHub y pueden cambiar; nombrar un proyecto aquí no acredita seguridad, mantenimiento ni compatibilidad actual.

Números del repo

Medición: 3 de agosto de 2026, API y página de GitHub.

Métrica	Valor
Estrellas	75.464
Bifurcaciones	14.054
Suscriptores reales	373
Commits	3.420
Incidencias abiertas indicadas por la API	4.989
Lenguaje principal	TypeScript
Licencia	MIT
Creación del repositorio	2 de marzo de 2026
Última publicación	v2026.722.0, 22 de julio de 2026

Los contribuidores principales devueltos por la API fueron cryppadotta (2.359 contribuciones), devinfoley (319), nickyleach (107), dependabot[bot] (99), mvanhorn (30), stubbi (28) y zvictor (28). GitHub mostraba 3.420 commits en la página de historial. El campo watchers_count de la respuesta general duplica las estrellas; por eso se informa subscribers_count como suscriptores reales. El campo open_issues_count puede incluir solicitudes de cambios abiertas, por lo que no equivale necesariamente a incidencias exclusivamente.

La versión v2026.722.0 añade acceso a secretos limitado a cada ejecución y agentes locales en Windows, según sus notas de publicación. La edición v2026.720.0 incorporó Skill Studio, una cola de atención, decisiones, búsqueda y recuperación de ejecuciones. Son cambios declarados por el propio proyecto.

Cómo contribuir

La guía de contribución prescribe buscar primero incidencias y solicitudes de cambios relacionadas para evitar duplicados. Para un cambio pequeño pide una modificación focalizada, pruebas y CI en verde, uso de la plantilla y puntuación 5/5 de Greptile; para una modificación grande solicita discutir primero la dirección en el canal #dev de Discord.

Toda solicitud debe usar la plantilla, explicar el razonamiento, cambio, verificación, riesgos y modelo empleado; debe enlazar incidencias públicas o describir el problema en la propia solicitud. Exige pasar lint, comprobación de tipos, pruebas y compilación. La guía también advierte que las funcionalidades no coordinadas pueden cerrarse por coherencia de hoja de ruta; sugiere construir extensiones mediante el sistema de complementos cuando proceda.

Cómo lo recibió la comunidad

La evidencia externa recuperada es limitada y debe leerse con esa limitación:

• El envío de Hacker News 47277096, publicado por eclipxe el 6 de marzo de 2026, obtuvo 6 puntos y 1 comentario. FeelTheAGI2 afirmó haberlo usado durante varios días y elogió específicamente la interfaz. Es una apreciación individual temprana, no un consenso.
• En la página oficial, Numman Ali valora que el sistema cubra funciones de negocio y el diseño de interfaz; John Holloway destaca la orquestación de agentes para desarrollo, contenido, mercadotecnia, control de calidad, investigación y difusión. Son testimonios seleccionados por la empresa, por lo que sirven como señales de uso declaradas pero no como reseñas independientes.
• La objeción concreta recuperada procede del hilo 48578387, enviado por khelavastr tras el cierre de una pregunta sobre integración OpenClaw–Paperclip. Tuvo 4 puntos y 2 comentarios. theamk sostuvo que el cierre tenía sentido porque la pregunta no estaba relacionada con lenguajes de programación; uberman lo consideró irónico. La crítica se refiere a la adecuación del canal de soporte, no a una evaluación técnica del producto, pero evidencia una dificultad práctica para hallar un foro apropiado para esa consulta.

No se recuperó una discusión independiente extensa que permita generalizar satisfacción, rendimiento o seguridad. Las cifras de estrellas tampoco sustituyen ese tipo de evaluación.

Paperclip frente a otras propuestas

Propuesta	Coincidencia verificable	Diferencia verificable
OpenClaw	Paperclip declara que puede incorporar OpenClaw como agente.	Paperclip se presenta como la compañía que organiza agentes; OpenClaw aparece como uno de los empleados o entornos que puede coordinar.
Claude Code y Codex	El README los enumera como agentes de código compatibles.	Son entornos o agentes que ejecutan trabajo; Paperclip aporta organigrama, tareas, presupuesto, aprobación y auditoría alrededor de ellos.
zeenie-ai/OpenCompany	Su descripción de GitHub se presenta como una IA auto-mejorable para dirigir un negocio; ambos apuntan a compañías ejecutadas por agentes.	La fuente recuperada permite constatar ese posicionamiento, pero no una comparación técnica detallada; Paperclip documenta explícitamente adaptadores, presupuestos, auditoría y complementos.
zesthq/bizbox	Se describe como orquestación de código abierto para compañías nativas de IA.	La fuente solo permite comparar el objetivo general; no se recuperó documentación suficiente para afirmar equivalencia de características.

La comparación responsable depende del alcance: para coordinar varios agentes existentes bajo controles administrativos, Paperclip tiene mecanismos explícitos. Para un único agente o una automatización puntual, la propia documentación afirma que probablemente no sea necesario.

Casos de uso y a quién puede ayudar este repositorio

• Personas que coordinan varios agentes de código pueden usar el organigrama, tareas con contexto persistente y trazas para sustituir sesiones aisladas de Claude Code, Codex o Cursor por trabajo asignado y revisable.
• Equipos que operan trabajo recurrente de asistencia, contenido, informes o investigación pueden configurar rutinas, activaciones programadas y políticas de concurrencia; cada ejecución se convierte en una tarea rastreable que despierta al agente responsable.
• Responsables de plataforma, seguridad u operaciones pueden beneficiarse de presupuestos con límites duros, secretos delimitados, aprobaciones, pausas, auditoría, compañías aisladas y conexión gobernada a herramientas MCP.
• Organizaciones que experimentan con distintas pilas de agentes pueden preservar la elección del agente y del proveedor mientras centralizan metas, permisos y costes. Antes de delegar acciones sensibles, el uso razonable exige revisar la configuración del adaptador, las políticas, las credenciales y las pruebas del entorno propio.

Recursos

• Repositorio: https://github.com/paperclipai/paperclip
• Documentación e instalación: https://paperclip.ing/docs y https://github.com/paperclipai/paperclip/blob/master/doc/INSTALLING.md
• Skills oficiales: https://github.com/paperclipai/paperclip/tree/master/skills
• Complementos y ecosistema: https://github.com/gsxdsm/awesome-paperclip
• Reviews y conversaciones: https://news.ycombinator.com/item?id=47277096 y https://news.ycombinator.com/item?id=48578387
• Comunidad/Discord: el README y el sitio oficial enlazan una comunidad de Discord; no se recuperó una URL pública verificable durante esta consulta.

---

Nota: este artículo combina el README, la guía de contribución, la página oficial y las notas de versión de Paperclip, la API y página de GitHub y la API de Hacker News, consultadas el 3 de agosto de 2026. Las cifras cambian con el tiempo.