Cómo autoalojar Paperclip en un VPS de Contabo en 2026 | Blog de Contabo

Aprende a autoalojar Paperclip AI – la plataforma de orquestación AI de código abierto – en un VPS de Contabo en 2026, usando Ubuntu y Postgres. Al final, tendrás un VPS de Paperclip funcionando y asegurado sobre HTTPS. Entonces estarás listo para ejecutar agentes de AI como parte de tu propia plataforma de orquestación.

Paperclip es un software de orquestador AI de código abierto que te permite ejecutar una «empresa de Paperclip AI» compuesta por agentes Paperclip AI con roles, metas y presupuestos. En lugar de un solo chatbot, defines un organigrama (CEO, ingenieros, mercadólogos) y dejas que Paperclip AI coordine su trabajo en proyectos compartidos.

Los agentes se conectan a través de adaptadores, por ejemplo Claude Code u otros entornos estilo CLI, por lo que Paperclip actúa como un orquestador AI en la parte superior de tus modelos y herramientas preferidos. El código se encuentra en Paperclip GitHub, lo que significa que puedes autoalojarlo, inspeccionarlo y extenderlo en tu propia infraestructura.

Paperclip autoalojado en un VPS te da control sobre tus datos, costos y entorno de ejecución. Tú eliges dónde se ejecutan las herramientas de automatización de orquestación, qué proveedores de orquestación LLM utilizar, y cuán estrictas deberían ser tus reglas de gobernanza y presupuestos de agentes.

Contabo es una buena opción para VPS para agentes de IA porque obtienes precios predecibles, RAM y almacenamiento generosos, y centros de datos en la UE para alojamiento de agentes de IA compatibles con RGPD. Si deseas un VPS europeo para autoalojar, alojar Paperclip en un centro de datos de la UE mientras llamas a APIs externas como Claude o Hermes es sencillo.

Paperclip es una aplicación Node.js con Postgres, así que necesitas suficiente CPU/RAM para la aplicación web, la base de datos y Docker. Veamos qué necesita un servidor VPS de Paperclip AI en términos de requisitos de servidor y configuración

Para un despliegue de desarrollo o interno pequeño en Ubuntu, puedes ejecutarlo en hardware tan mínimo como:

Esto es suficiente para probar Paperclip AI con un puñado de agentes y una instancia de Postgres embebida o local. En términos de Contabo, un plan de nivel de entrada para alojamiento VPS tendrá suficientes recursos para tus planes iniciales de AI Paperclip.

Para la mayoría de los equipos, cualquier Contabo Cloud VPS es un punto de partida cómodo para Paperclip. Te da suficiente CPU, RAM y almacenamiento NVMe rápido para evaluar el Paperclip AI, construir un espacio de pruebas e incluso soportar pequeñas cargas de trabajo de equipos sin comprometer el presupuesto.

Cuando Paperclip se convierta en parte de una configuración de producción más grande y siempre activa, mudarse a un Contabo Cloud VDS S es generalmente la opción más segura a largo plazo. Los planes de VDS proporcionan recursos dedicados y un rendimiento más predecible que las instancias VPS compartidas, lo cual es importante una vez que tu plataforma de orquestación de IA esté ejecutando agentes y trabajos críticos las 24 horas.

Los pasos a continuación suponen un VPS nuevo de Ubuntu 22.04/24.04 y un nivel básico de comodidad con SSH y la línea de comandos.

Primero, necesitarás un VPS – salta este paso si ya tienes uno listo para usar. Ordena un VPS de Contabo en tu región preferida. Si el RGPD es relevante para tu caso de uso, un VPS europeo para autoalojar es una buena opción. Elige un plan que coincida con los requisitos anteriores, selecciona Ubuntu como el sistema operativo y luego conéctate desde tu máquina local:

ssh root@SERVER_IP

A partir de aquí, este VPS es tu servidor Paperclip y alojará tanto la aplicación web como la base de datos a menos que transfieras Postgres a otro lugar.

Tienes dos opciones principales para hacer funcionar Paperclip AI en tu VPS de Contabo: un npx quickstart de un solo comando para pruebas rápidas, y un despliegue de Docker para uso a largo plazo.

Inicio más rápido – npx paperclipai onboarding
Si solo quieres ver la aplicación Paperclip en acción, primero actualiza tu índice de paquetes local e instala Node.js en tu VPS de Ubuntu:

sudo apt update
sudo apt install nodejs

Confirma con Y, luego instala el administrador de paquetes Node.js:

sudo apt install npm

Confirma con Y, luego ejecuta:

npx paperclipai onboard --yes

Más detalles se pueden encontrar en la página de GitHub de Paperclip.

Ruta de producción – Paperclip con Docker en Ubuntu
Para un despliegue estable y repetible de Paperclip en tu VPS de Contabo, usa Docker y Docker Compose. Después de instalar Docker, puedes usar el archivo compose de GitHub de Paperclip y configurar tu archivo de entorno, luego arranca la pila con docker compose up -d, lo que te dará una plataforma de orquestación autoalojada de Paperclip adecuada para cargas de trabajo continuas.

Por defecto, Paperclip utiliza una instancia PostgreSQL embebida cuando no se establece DATABASE_URL, por lo que puedes completar tu primera ejecución sin tocar bases de datos en absoluto. Este modo sin configuración es perfecto para desarrollo local y evaluación rápida, pero no está diseñado para alojamiento VPS de producción a largo plazo donde la fiabilidad y la observabilidad importan más.

Para un despliegue de Postgres VPS de producción en tu servidor Contabo, deberías ejecutar una instancia de PostgreSQL 17+ dedicada y apuntar Paperclip a ella a través de DATABASE_URL. Puedes instalar un servidor Postgres autoalojado directamente en el mismo VPS de Ubuntu o en un VPS de base de datos separado, luego usar una cadena de conexión como postgres://usuario:contraseña@host:5432/nombredatabase para que el software de orquestación persista todos los datos de la empresa, agentes y auditoría en ese Postgres externo en lugar de la base de datos embebida.

Con Postgres listo, obtén el código más reciente de Paperclip GitHub en tu VPS de Contabo. Un patrón común en Ubuntu es:

cd /opt
git clone https://github.com/paperclipai/paperclip.git
cd paperclip

Paperclip lee la mayoría de las configuraciones de despliegue de variables de entorno, a menudo administradas a través de un archivo .env o la configuración env de tu plataforma de contenedores. Como mínimo, establece una DATABASE_URL apuntando a tu instancia de Postgres autoalojada, más secretos de autenticación y claves opcionales de API de LLM (por ejemplo ANTHROPIC_API_KEY para Claude o otras claves de proveedores) para que los adaptadores de tu agente AI Paperclip puedan hablar con modelos externos mientras que la plataforma de orquestación AI en sí se mantenga completamente autoalojada en tu VPS.

Si estás usando Docker, inicia la aplicación Paperclip ejecutando

docker compose up -d

en el repositorio clonado en tu VPS de Contabo. Los contenedores arrancarán la interfaz web, los trabajadores en segundo plano y cualquier servicio de soporte definido en el archivo compose.

Para la ruta de npx paperclipai onboarding, el servidor local se inicia automáticamente una vez que el onboarding termina, por lo que no necesitas un comando adicional de despliegue de paperclip. Se ejecutará por defecto en localhost y la conexión solo funcionará con un túnel SSH. Ten en cuenta que el servidor se ejecutará en primer plano, y ambos comandos paperclipai onboard y paperclipai run requerirán que la terminal permanezca activa. También pueden ejecutarse como un servicio.

Una vez que tu servidor Paperclip esté funcionando en Ubuntu, protégelo con un firewall y HTTPS para que tus agentes AI autoalojados y el panel no estén expuestos más de lo necesario. En un VPS de Contabo, la pila típica es UFW para el firewall del host más Nginx como proxy inverso frente a la aplicación Paperclip en el puerto 3100.

Comienza habilitando UFW y permitiendo solo SSH, HTTP y HTTPS:

apt install -y ufw
ufw allow ssh
ufw allow http
ufw allow https
ufw enable

A continuación, instala Nginx y configúralo como un proxy inverso que reenvíe tu dominio a Paperclip en http://localhost:3100, de modo que los usuarios nunca vean el puerto interno. Finalmente, agrega un certificado gratuito de Let’s Encrypt con Certbot (certbot –nginx -d tu-dominio.ejemplo) para servir tu plataforma de orquestación Paperclip autoalojada a través de HTTPS, manteniendo el tráfico a tu plataforma encriptado mientras se ejecuta en tu VPS de Contabo.

Además de UFW en el propio servidor, Contabo también incluye un firewall a nivel de red gratuito que puedes administrar desde el Customer Control Panel. Desde allí, defines reglas de tráfico (por ejemplo, permitiendo solo HTTP/HTTPS y SSH a tu servidor Paperclip) antes de que las conexiones lleguen a tu VPS, lo que añade otra capa de protección sin costo adicional.

Puedes acceder al panel a través de SSH en localhost de tu máquina local. El MOTD guiará al usuario a través de la configuración.

Dentro del panel, defines tu “empresa” y creas agentes con diferentes roles y adaptadores. Por ejemplo, podrías comenzar con un agente de paperclip AI estilo CEO conectado a Claude a través de MCP, luego agregar agentes de ingeniería que tomen tickets de la tabla.

Ejecutar esto en Contabo en 2026 significa que puedes escalar tu VPS para agentes de AI a medida que crecen las necesidades, ya sea actualizando el nivel del VPS o separando Postgres a su propio VPS de Postgres. El resultado es una plataforma de orquestación que controlas completamente, en lugar de un SaaS cerrado donde no puedes ajustar el uso de recursos o los flujos de datos.

Paperclip más un VPS de Contabo te ofrece una forma práctica de experimentar con Paperclip AI hoy y crecer hacia implementaciones más serias con el tiempo. Obtienes un software de orquestación de código abierto que orquesta agentes como una empresa, y una infraestructura que puedes redimensionar o mover cuando cambien tus requisitos.

Elige un Contabo VPS o VDS que se ajuste a tu carga de trabajo proyectada, sigue los pasos de Ubuntu mencionados anteriormente, y estarás listo para alojar Paperclip para proyectos de IA reales en lugar de demos de juguete.