Paperclip: Cómo Gestionar una Empresa Unipersonal con Este Framework de Código Abierto

Paperclip es un framework open source para empresas unipersonales que orquesta agentes de IA como empleados: organigramas, presupuestos, latidos, aprobaciones de gobernanza y un registro de auditoría completo. Se ejecuta localmente con un solo comando. Los agentes hacen el trabajo; tú diriges la junta.

Prueba Apidog hoy mismo

Dirigir una empresa unipersonal en 2026 ya no significa hacerlo todo solo, sino liderar un equipo de agentes de IA que realizan las tareas mientras tú te centras en la estrategia. Paperclip es el framework open source creado para ese fin. Ofrece a los fundadores individuales un organigrama, sistema de presupuesto, capa de gobernanza y seguimiento de tareas para sus agentes de IA, todo en un panel de control autoalojado. Si además usas Apidog para diseñar, simular y probar las API con las que interactúan tus agentes, Paperclip completa la stack: Apidog define el contrato de la API, Paperclip controla los agentes que la llaman. Aquí verás cómo funciona Paperclip y cómo integrarlo en tu operación unipersonal hoy mismo.

💡Consigue Apidog (gratis) antes de tu primer latido de Paperclip. Inserta la URL de simulación en las descripciones de tareas para que los agentes construyan usando contratos perfectos: cero coste, cero sorpresas. Cambia a las API en vivo luego, con las pruebas de Apidog detectando cualquier desviación antes de que se agote el presupuesto.

<!--kg-card-begin: html-->

<!--kg-card-end: html-->

¿Qué es Paperclip y por qué importa a los usuarios de Apidog?

El lema de Paperclip lo resume: "Si OpenClaw es un empleado, Paperclip es la empresa."

Paperclip es un servidor Node.js y una interfaz React que convierte tus agentes de IA en una organización con cargos, líneas de reporte, presupuestos mensuales y objetivos estratégicos. No es un chatbot, gestor de prompts ni builder visual de flujos. Es el plano de control para una empresa autónoma.

¿Por qué es relevante este framework ahora?

La mayoría de fundadores individuales que usan agentes de IA en 2026 gestionan el caos: decenas de pestañas abiertas, sin registro de qué agente hizo qué, sin control de gastos, sin trazabilidad de tareas. Paperclip resuelve esto tratando a los agentes como empleados reales:

• Organigrama: roles, títulos y manager para cada agente.
• Tareas: cada trabajo se rastrea con estado, prioridad y asignado.
• Objetivos: cada tarea se enlaza a la misión de la empresa, dando contexto de negocio.
• Latidos: los agentes actúan según agenda, procesan tareas, reportan estado.
• Presupuestos: límites mensuales de gasto por agente; si se exceden, el agente se detiene.
• Gobernanza: tú apruebas contrataciones y decisiones clave antes de su ejecución.

Si usas Apidog para definir y simular API, Paperclip añade la orquestación que falta. Apidog especifica el contrato; Paperclip gestiona el qué, cuándo y cuánto.

Por qué los fundadores individuales eligen este framework en vez de solo Apidog

Apidog es excelente para diseñar y probar API, pero una empresa necesita más: objetivos, tareas, control de costes y auditoría. Paperclip gestiona estos procesos. Apidog + Paperclip ofrecen un sistema operativo completo para una empresa de software dirigida por humanos y ejecutada por agentes de IA.

Características clave del framework Paperclip y dónde encaja Apidog

Latidos: Bucle de activación de agentes compatible con Apidog

El latido es la unidad de ejecución de Paperclip. En cada latido, un agente:

1. Llama a GET /api/agents/me para confirmar identidad.
2. Llama a GET /api/companies/:id/issues?status=todo,in_progress para leer tareas.
3. Llama a GET /api/issues/:id para más contexto, incluyendo objetivos.
4. Realiza la tarea (escribe código, llama a API, genera contenido).
5. Llama a PATCH /api/issues/:id para actualizar estado y comentar lo realizado.

Integración con Apidog: si la tarea implica llamar a una API, el agente usa el servidor de simulación de Apidog en desarrollo y cambia al endpoint en vivo en producción sin modificar código. La validación de Apidog detecta cualquier desviación de contrato antes de que afecte la operación.

Organigrama y Jerarquía de Objetivos; Apidog como capa de API

La jerarquía de Paperclip es: empresa → equipo → agente → tarea. Un agente recibe toda la cadena de objetivos para entender el contexto estratégico.

En este esquema, Apidog es la capa de especificación de API. Defines servicios en Apidog, publicas servidores de simulación, y los agentes referencian esos endpoints en las tareas. Cambias la API, actualizas la spec en Apidog y los agentes trabajan con el nuevo contrato automáticamente.

Aplicación de presupuestos: controlando el gasto en tu flujo Apidog

Cada agente tiene un budgetMonthlyCents. Al alcanzar el límite (spentMonthlyCents), deja de aceptar tareas: sin excepciones. Así puedes asignar, por ejemplo, $20/mes y asegurarte de nunca excederlo.

Combinado con simulaciones de Apidog, puedes correr sprints completos de agentes (cero coste de tokens) antes de pasar a IA en vivo. Prototipado gratis; producción bajo presupuesto.

Configuración de Paperclip como framework unipersonal con Apidog {#setup}

Inicio local sin configuración; Apidog se conecta de inmediato

Arranca Paperclip con un solo comando:

npx paperclipai onboard --yes

Esto levanta una base de datos PostgreSQL embebida, genera clave de cifrado, aplica migraciones e inicia el servidor en http://localhost:3100.

Luego, en la UI:

1. Crea tu empresa y define el objetivo principal:
   

   Construir la herramienta de monitoreo de API impulsada por IA #1 para alcanzar $1M MRR.
   

2. Crea tu primer agente, por ejemplo, "Ingeniero de Backend" con adaptador claude_local:
   

   {
     "adapterType": "claude_local",
     "adapterConfig": {
       "model": "claude-opus-4-6",
       "maxTokens": 4096
     },
     "budgetMonthlyCents": 2000
   }
   

3. Asigna tareas apuntando al servidor de simulación de Apidog. Añade en la descripción la URL de colección de Apidog para que el agente tenga el contrato de la API como contexto.

Conectando simulaciones de Apidog a tareas de agentes

Las descripciones de tareas en Paperclip aceptan markdown enriquecido. Incrusta la URL base de simulación de Apidog así:

## Tarea: Añadir paginación al endpoint /users

**Base de simulación de Apidog:** http://localhost:4523/m1/123456/users
**Criterios de aceptación:**
- El endpoint acepta parámetros de consulta `page` y `limit`
- Devuelve un envoltorio `{ data: [], total: 0, page: 1 }`
- Cobertura de pruebas unitarias para casos extremos (page=0, limit>100)

El agente consulta la simulación de Apidog, verifica la respuesta, implementa y reporta resultado.

Ejecutando agentes, tareas y latidos en Paperclip + Apidog

Gestión de problemas vía CLI

Controla el ciclo de vida de tareas desde la CLI:

# Crea una tarea para implementar un endpoint definido en Apidog
pnpm paperclipai issue create \
  --company-id <id> \
  --title "Implementar el endpoint POST /webhooks según la especificación de Apidog" \
  --description "Ver colección de Apidog: http://localhost:4523/..."

# Consulta el estado de la tarea
pnpm paperclipai issue list --company-id <id> --status in_progress

# Libera la tarea si un agente se atasca
pnpm paperclipai issue release <issue-id>

Todos los cambios quedan registrados en el log inmutable, para trazabilidad total.

Gobernanza y aprobaciones integradas con Apidog

Como "junta directiva", apruebas contrataciones y estrategias antes de que los agentes las ejecuten:

# Revisar aprobaciones pendientes
pnpm paperclipai approval list --company-id <id>

# Aprobar contratación de un nuevo agente
pnpm paperclipai approval approve <approval-id> \
  --decision-note "Aprobado. Usar la simulación de Apidog para el primer sprint."

Los agentes proponen; tú decides.

Pruebas, gobernanza y control de costos en tu stack Paperclip + Apidog

Ejecutando el set de pruebas de Paperclip + Apidog

Paperclip incluye pruebas unitarias (Vitest) y E2E (Playwright):

# Ejecutar pruebas unitarias
pnpm test:run

# Ejecutar E2E
pnpm test:e2e

# Verificar estado del servidor y simulación de Apidog
curl http://localhost:3100/api/health

El set cubre lógica de negocio: transiciones de estado, aplicación de presupuesto, ciclo de latidos y autenticación. Si agregas un nuevo adaptador de IA, ejecuta las pruebas para validar la orquestación.

En empresas unipersonales, esto es crítico: tus pruebas unitarias y de contrato (Apidog) son tu red de seguridad.

Stack de calidad en tres capas: Paperclip + Apidog + pruebas unitarias

Patrón recomendado:

1. Apidog define el contrato de la API y ejecuta pruebas de contrato automáticas en cada push.
2. Los issues de Paperclip contienen criterios de aceptación referenciando la spec de Apidog.
3. Las pruebas unitarias (Vitest) validan que la implementación cumple ambos.

Así, un founder individual obtiene la misma calidad que un equipo con revisión por pares, pero sin reuniones.

Conclusión

Paperclip es el framework open source para convertirte en una empresa unipersonal productiva. Incluye organigramas, controles presupuestarios, gobernanza, alineación de objetivos, latidos y registro de auditoría para gestión de agentes IA: autoalojado, open source, bajo tu control.

Si ya usas Apidog para diseñar y probar API, Paperclip completa tu stack. Apidog gestiona el contrato de la API; Paperclip controla quién la usa, cuándo y bajo qué condiciones. Juntos, tienes una arquitectura de empresa unipersonal lista para producción desde el día uno: tus simulaciones de Apidog impulsan el desarrollo de agentes, tus pruebas de contrato validan las salidas y la gobernanza de Paperclip asegura que nada se ejecuta sin tu aprobación.

Comienza:

• Arranca localmente: npx paperclipai onboard --yes
• Abre la UI en http://localhost:3100, crea una empresa y define tu primer objetivo
• Añade un agente con presupuesto de $20/mes y apunta a tu servidor de simulación de Apidog
• Ejecuta pnpm test:run para verificar las pruebas antes del primer latido de producción
• Aprueba la primera tarea, observa el trabajo del agente, revisa el registro de auditoría

La empresa unipersonal ya no es solo una metáfora. Con Paperclip y Apidog, es arquitectura.

Preguntas Frecuentes

¿Qué es Paperclip?

Paperclip es un framework de empresa unipersonal open source: servidor Node.js + UI React que orquesta agentes de IA con organigrama, presupuestos, latidos y gobernanza. Es el plano de control para dirigir una empresa de software con agentes, no humanos.

¿Cómo se integra Paperclip con Apidog?

Apidog define los contratos de API para tus agentes. Inserta las URLs de simulación de Apidog en las descripciones de tareas de Paperclip. Los agentes usan esas simulaciones en desarrollo, y las pruebas de contrato de Apidog validan la implementación final. Paperclip orquesta; Apidog define la API.

¿Paperclip sirve para una empresa unipersonal real?

Sí. La configuración local (npx paperclipai onboard --yes) no requiere infraestructura adicional. Los límites de presupuesto evitan gastos descontrolados. El sistema de latidos automatiza trabajo recurrente. La integración con Tailscale te permite gestionar agentes desde el móvil. Escala de local a nube sin cambios.

¿Cómo ejecuto pruebas unitarias?

Ejecuta pnpm test:run para las pruebas unitarias (Vitest) o pnpm test:e2e para E2E (Playwright). La verificación con curl http://localhost:3100/api/health confirma que el servidor está activo.

¿Qué agentes de IA soporta Paperclip?

Paperclip soporta Claude (local y vía OpenClaw), Codex, Cursor, Gemini, OpenCode y cualquier agente que hable HTTP o corra como proceso local. El sistema de adaptadores es abierto: si tu agente responde a latidos, puede ser contratado.

¿Paperclip es open source?

Sí. Licencia MIT, mantenimiento activo en github.com/paperclipai/paperclip. El SDK de plugins, adaptadores y definiciones de skills están en NPM bajo @paperclipai/*.