Paperclip

Beta: Paperclip está en desarrollo temprano. Esta plantilla y el software pueden presentar problemas inesperados.

Paperclip es una plataforma de orquestación para coordinar múltiples agentes de IA (Claude, Codex, Cursor, OpenClaw, etc.) para operar negocios autónomos. Proporciona un servidor Node.js con una interfaz React para gestionar equipos de agentes, asignar objetivos, rastrear trabajo y monitorear costos.

Primeros pasos

1. Despliegue la plantilla y espere a que el servicio se inicie.
2. Abra el Terminal de Zeabur (servicio Paperclip).
3. Cree la primera cuenta de administrador:

   pnpm paperclipai auth bootstrap-ceo
   

4. Copie la URL de invitación de la salida y ábrala en su navegador para registrarse.
5. Inicie sesión en su herramienta de IA preferida — Codex o Claude Code (consulte Autenticación de agentes IA más abajo).
6. Al crear un agente, establezca Working directory en una ruta bajo /home/node/ (ej. /home/node/workspaces/my-project).
7. Haga clic en Test now para ejecutar la verificación del adaptador. Un resultado exitoso muestra hello probe succeeded.
8. Después de la configuración, establezca PAPERCLIP_AUTH_DISABLE_SIGN_UP en true en las variables de entorno de Zeabur para evitar registros no autorizados.

Autenticación de agentes IA

Actualmente solo se admite login en Terminal. La autenticación por variables de entorno (OPENAI_API_KEY / ANTHROPIC_API_KEY) aún no funciona.

Herramienta	Login en Terminal
Codex	runuser -u node -- codex login --device-auth
Claude Code	runuser -u node -- claude login

Notas

• Use siempre el prefijo runuser -u node -- al ejecutar herramientas CLI en el Terminal. Ejecutar como root causará problemas de permisos.
• Autenticación de dispositivo Codex: Habilite "Enable device code authorization for Codex" en ChatGPT Security Settings antes de ejecutar el comando de inicio de sesión.
• Advertencia OPENAI_API_KEY is not set: Esta advertencia puede ignorarse de forma segura si se autenticó mediante codex login.

Notas importantes

• Almacenamiento persistente: Solo los datos bajo /home/node/ sobreviven a los reinicios. Todas las demás rutas son efímeras.
• Directorio de trabajo: No use /app — contiene el código fuente de Paperclip y se sobrescribirá en actualizaciones. Use siempre rutas bajo /home/node/ (persistente).
• Control de registro: Establezca PAPERCLIP_AUTH_DISABLE_SIGN_UP en true después de crear su cuenta de administrador. Cambie temporalmente a false cuando necesite invitar nuevos usuarios, luego vuelva a true.

Registro de cambios

2026-03-16 — Lanzamiento inicial

• Plantilla de Zeabur para la plataforma de orquestación de agentes IA Paperclip
• Servicios: PostgreSQL 17 + Paperclip (imagen preconstruida zeabur/paperclip, amd64 + arm64)
• El script de inicio genera automáticamente config.json en el primer arranque
• El servidor se ejecuta como usuario node mediante runuser (requerido para Claude Code CLI)
• Un único volumen persistente en /home/node/
• Herramientas CLI preinstaladas: claude-code, codex, opencode-ai

Enlaces

• Documentación
• GitHub