Paperclip es un marco de empresa unipersonal de código abierto que orquesta agentes de IA como empleados: organigramas, presupuestos, programación de latidos, aprobaciones de gobernanza y un registro de auditoría completo. Un solo comando lo pone en marcha localmente. Sus agentes hacen el trabajo; usted dirige la reunión de la junta.
Dirigir una empresa unipersonal en 2026 ya no significa hacerlo todo usted mismo, significa dirigir un equipo de agentes de IA que realizan el trabajo mientras usted se mantiene enfocado en la estrategia. Paperclip es el marco de empresa unipersonal de código abierto creado para hacerlo realidad. Ofrece a los fundadores individuales un organigrama, un sistema de presupuesto, una capa de gobernanza y un seguimiento de tareas para sus agentes de IA, todo en un panel de control autoalojado. Si también utiliza Apidog para diseñar, simular y probar las API con las que interactúan sus agentes, Paperclip completa la pila: Apidog posee el contrato de la API, Paperclip posee los agentes que la llaman. Esta guía explica exactamente cómo funciona Paperclip y cómo integrarlo en una operación unipersonal a partir de hoy.
¿Qué es Paperclip y por qué el marco de empresa unipersonal es importante para los usuarios de Apidog?
El lema de Paperclip lo dice directamente: "Si OpenClaw es un empleado, Paperclip es la empresa."
Paperclip es un servidor Node.js y una interfaz de usuario React que convierte su colección de agentes de IA en una organización estructurada con títulos, líneas de reporte, presupuestos mensuales y objetivos estratégicos. No es un chatbot, un gestor de prompts o un constructor de flujos de trabajo de arrastrar y soltar. Es el plano de control para una empresa autónoma.
He aquí por qué este marco de empresa unipersonal es importante ahora mismo.
La mayoría de los fundadores individuales que utilizan agentes de IA en 2026 están gestionando el caos. Veinte pestañas de Claude Code abiertas. Sin registro de qué agente tocó qué archivo. Sin límite en el gasto de tokens. Sin forma de saber si el agente terminó la tarea o alucinó una finalización. Paperclip soluciona todo esto tratando a los agentes de la misma manera que una empresa real trata a sus empleados:
- Organigrama — los agentes tienen roles, títulos y un gerente
- Problemas / tareas — cada pieza de trabajo se rastrea con estado, prioridad y asignado
- Objetivos — cada tarea se remonta a la misión de la empresa para que los agentes siempre sepan el porqué
- Latidos — los agentes se activan según un horario, revisan su bandeja de entrada de tareas, hacen el trabajo, informan
- Presupuestos — límites mensuales de gasto de tokens por agente; cuando alcanzan el límite, se detienen
- Gobernanza — usted aprueba las contrataciones de agentes y las decisiones estratégicas importantes antes de que se ejecuten
Para los equipos que utilizan Apidog para definir y simular las API que sus agentes llaman, Paperclip añade la capa de orquestación que falta. Apidog le dice al agente cuál es el contrato de la API. Paperclip le dice al agente qué trabajo hacer, cuándo hacerlo y cuánto puede gastar.
Por qué los fundadores individuales están eligiendo este marco de empresa unipersonal en lugar del enfoque solo con Apidog
Apidog es excepcional en el diseño y las pruebas de API de forma aislada. Pero el diseño de API es solo una capa para ejecutar un producto. Paperclip maneja el proceso circundante: descomposición de objetivos, asignación de tareas, seguimiento del progreso, visibilidad de costos y registro de auditoría. Juntos, Apidog + Paperclip brindan a un fundador individual un sistema operativo completo para una empresa de software donde los humanos establecen la dirección y los agentes de IA ejecutan.
Características principales del marco de empresa unipersonal de Paperclip y dónde encaja Apidog
Latidos: El bucle de activación de agentes compatible con Apidog
El latido es la primitiva de ejecución central de Paperclip. En cada latido, un agente:
- Llama a
GET /api/agents/mepara confirmar su identidad - Llama a
GET /api/companies/:id/issues?status=todo,in_progresspara leer su bandeja de entrada de tareas - Llama a
GET /api/issues/:idpara obtener el contexto completo, incluida la ascendencia del objetivo principal - Hace el trabajo (escribe código, llama a API, genera contenido)
- Llama a
PATCH /api/issues/:idcon una actualización de estado y un comentario explicando lo que hizo
Aquí es donde brilla la integración con Apidog. Si la tarea implica llamar a una API externa, digamos, extraer datos de clientes para generar un informe semanal, el agente accede a un servidor de simulación de Apidog durante el desarrollo y luego cambia al endpoint en vivo en producción sin cambiar una sola línea de código. La validación de solicitudes de Apidog detecta cualquier desviación en el contrato de la API antes de que silenciosamente interrumpa el trabajo de un agente.
Organigrama y Jerarquía de Objetivos Apidog como capa de API
La jerarquía de objetivos de Paperclip fluye de empresa → equipo → agente → tarea. Un agente al que se le asigna una tarea siempre recibe su cadena de ancestros para que un agente junior sepa que está escribiendo una publicación de blog como parte de "aumentar el tráfico SEO" como parte de "alcanzar $1M MRR". Este contexto evita que los agentes optimicen localmente a expensas del objetivo más amplio.
Dentro de esta jerarquía, Apidog sirve como la capa de especificación de API. Usted define sus servicios internos en Apidog, publica servidores de simulación para cada uno, y los agentes referencian esos endpoints de Apidog en sus descripciones de tareas. Cuando la API cambia, actualiza la especificación de Apidog, vuelve a generar la simulación y cada agente descendente obtiene el nuevo contrato automáticamente.
Aplicación del presupuesto Deteniendo el gasto descontrolado en su flujo de trabajo de Apidog
Cada agente en Paperclip tiene un campo `budgetMonthlyCents`. Cuando el `spentMonthlyCents` del agente alcanza ese límite, deja de aceptar tareas. Sin anulaciones, sin excepciones. Para una empresa unipersonal que opera con austeridad, esta es la característica que hace posible todo lo demás: puede asignar a un agente un presupuesto de $20 al mes y saber con certeza que nunca lo excederá.
Cuando combina esto con los servidores de simulación de Apidog, puede ejecutar un sprint completo de trabajo de agentes contra simulaciones (costo cero de tokens) antes de cambiar a proveedores de IA en vivo. La creación de prototipos es gratuita; la producción está presupuestada.
Configurando Paperclip como su marco de empresa unipersonal con Apidog {#setup}
Inicio local sin configuración Apidog se conecta inmediatamente
Poner Paperclip en funcionamiento es un solo comando:
npx paperclipai onboard --yes
Esto arranca una base de datos PostgreSQL incrustada, genera una clave maestra de cifrado, aplica todas las migraciones de la base de datos e inicia el servidor en `http://localhost:3100`. No se requiere Docker, no se necesitan servicios externos.
Una vez en funcionamiento, abra la interfaz de usuario, cree una empresa y defina su primer objetivo:
"Construir la herramienta de monitoreo de API impulsada por IA #1 para alcanzar $1M MRR."
Luego cree su primer agente, por ejemplo, un agente "Ingeniero de Backend" que utiliza el adaptador `claude_local`:
{
"adapterType": "claude_local",
"adapterConfig": {
"model": "claude-opus-4-6",
"maxTokens": 4096
},
"budgetMonthlyCents": 2000
}
Dirija las tareas del agente a su servidor de simulación de Apidog. En la descripción de la tarea, haga referencia a la URL de la colección de Apidog para que el agente tenga el contrato completo de la API disponible como contexto.
Conectando las simulaciones de Apidog a las tareas del agente
En Paperclip, las descripciones de las tareas son un markdown enriquecido con el contexto completo del ancestro. Puede incrustar su URL base de simulación de Apidog directamente:
## 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 lee esto, llama a la simulación de Apidog para verificar la forma de respuesta actual, escribe la implementación y reporta con un comentario.
Ejecutando Agentes, Tareas y Latidos en el Marco de Empresa Unipersonal de Paperclip con Apidog
Gestionando Problemas a Través del Pipeline Paperclip Apidog
La CLI de Paperclip le da control total sobre el ciclo de vida de las tareas sin abrir la interfaz de usuario:
# Crea una tarea para que un agente implemente un nuevo endpoint definido por 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/..."
# Comprobar el estado de la tarea
pnpm paperclipai issue list --company-id <id> --status in_progress
# Libera una tarea si un agente se atasca
pnpm paperclipai issue release <issue-id>
Cada cambio de estado se registra en el registro de actividad inmutable para que siempre sepa exactamente qué agente tocó una tarea y qué dijo.
Gobernanza y Aprobaciones en el Marco de Empresa Unipersonal Integrado con Apidog
El modelo de gobernanza de Paperclip lo coloca en el rol de la junta directiva. Antes de que cualquier agente sea contratado o cualquier estrategia importante sea aprobada, Paperclip puede requerir su aprobación explícita:
# Revisar aprobaciones pendientes
pnpm paperclipai approval list --company-id <id>
# Aprobar la 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."
Esto evita que el marco de empresa unipersonal se convierta en un desastre de autonomía. Los agentes proponen; usted decide.
Pruebas, Gobernanza y Control de Costos en su Pila de Marco de Empresa Unipersonal Paperclip + Apidog
Ejecutando el conjunto de pruebas unitarias de Paperclip Apidog
Paperclip se distribuye con un completo conjunto de pruebas unitarias impulsado por Vitest y pruebas de extremo a extremo impulsadas por Playwright. Ejecutarlas es sencillo:
# Ejecutar todas las pruebas unitarias
pnpm test:run
# Ejecutar pruebas de extremo a extremo
pnpm test:e2e
# Verificación de estado — verificar que el servidor y la simulación de Apidog son accesibles
curl http://localhost:3100/api/health
El conjunto de pruebas unitarias cubre la lógica de negocio central: transiciones de estado de problemas, aplicación del presupuesto, ciclo de vida de ejecución de latidos y autenticación de agentes. Cuando añade un adaptador personalizado para conectar un nuevo proveedor de IA, la ejecución del conjunto de pruebas unitarias confirma que el comportamiento de orquestación existente no ha cambiado.
En un marco de empresa unipersonal, esto importa más que en un equipo tradicional. No tiene un revisor de código. El conjunto de pruebas unitarias y sus pruebas de contrato de Apidog son su red de seguridad.
La Pila de Calidad de Tres Capas: Paperclip + Apidog + Pruebas Unitarias
Un patrón de calidad práctico para fundadores individuales:
- Apidog define el contrato de la API y ejecuta pruebas de contrato automatizadas en cada push
- Los problemas de Paperclip contienen criterios de aceptación que referencian la especificación de Apidog
- Las pruebas unitarias (Vitest) validan que la implementación coincide con ambos
Este enfoque de tres capas significa que un fundador individual obtiene la misma garantía de calidad que un equipo de cinco personas tendría de la revisión por pares, sin las reuniones.
Conclusión
Paperclip es el marco de empresa unipersonal de código abierto que convierte a un fundador individual en una empresa. Aporta organigramas, controles presupuestarios, gobernanza, alineación de objetivos, programación de latidos y un registro de auditoría completo a la gestión de agentes de IA: todo autoalojado, todo de código abierto, todo suyo.
Para los desarrolladores que ya utilizan Apidog para diseñar y probar API, añadir Paperclip completa la pila. Apidog gestiona lo que hace la API. Paperclip gestiona quién la llama, cuándo, por qué y a qué coste. Juntos forman un marco de empresa unipersonal que es de grado de producción desde el primer día: sus servidores de simulación de Apidog impulsan el desarrollo de agentes, sus pruebas de contrato de Apidog validan la salida de los agentes, y la capa de gobernanza de Paperclip garantiza que ningún agente realice una acción que usted no haya aprobado.
Comience:
- Inicie localmente:
npx paperclipai onboard --yes - Abra la interfaz de usuario en
http://localhost:3100, cree una empresa y defina su primer objetivo - Añada un agente con un presupuesto de
$20/mesy apúntelo a su servidor de simulación de Apidog - Ejecute
pnpm test:runpara verificar que el conjunto de pruebas unitarias pasa antes de su primer latido de producción - Apruebe la primera tarea, observe el trabajo del agente, revise el registro de auditoría
La empresa unipersonal ya no es una metáfora. Con Paperclip y Apidog, es una arquitectura.
Preguntas Frecuentes
¿Qué es Paperclip? Paperclip es un marco de empresa unipersonal de código abierto, un servidor Node.js y una interfaz de usuario React que orquesta agentes de IA con organigramas, presupuestos, programación de latidos y gobernanza. Es el plano de control para dirigir una empresa de software con agentes de IA en lugar de empleados humanos.
¿Cómo se integra Paperclip con Apidog? Apidog define los contratos de API con los que trabajan sus agentes. Usted incrusta las URL de simulación de Apidog en las descripciones de las tareas de Paperclip, los agentes llaman a esas simulaciones durante el desarrollo y las pruebas de contrato de Apidog validan la implementación final. Paperclip gestiona la orquestación; Apidog gestiona la especificación de la API.
¿Es Paperclip adecuado para una verdadera empresa unipersonal? Sí. La configuración local sin configuración (npx paperclipai onboard --yes) no requiere infraestructura. Los límites de presupuesto evitan costes descontrolados. El sistema de latidos maneja el trabajo recurrente automáticamente. La integración con Tailscale le permite gestionar sus agentes desde su teléfono. Escala de local a la nube con la misma configuración.
¿Cómo ejecuto las pruebas unitarias? Ejecute pnpm test:run para el conjunto de pruebas unitarias de Vitest, o pnpm test:e2e para las pruebas de extremo a extremo de Playwright. Una verificación de estado contra http://localhost:3100/api/health confirma que el servidor se está ejecutando correctamente antes de realizar las pruebas.
¿Qué agentes de IA soporta Paperclip? Paperclip soporta Claude (local y a través de OpenClaw), Codex, Cursor, Gemini, OpenCode y cualquier agente que hable HTTP o se ejecute como un proceso local. El sistema de adaptadores está abierto: si su agente puede recibir un latido, puede ser contratado.
¿Es Paperclip de código abierto? Sí. Paperclip tiene licencia MIT y se mantiene activamente en github.com/paperclipai/paperclip. El SDK de complementos, los paquetes de adaptadores y las definiciones de habilidades se publican como paquetes NPM con ámbito bajo @paperclipai/*.