Paperclip

Uso

0. SSH al servidor

Conéctate a tu servidor como root:

ssh root@<SERVER_IP>

Inicia sesión con tu contraseña.

1. Cambia al usuario de la aplicación

Todas las operaciones de Paperclip deben ejecutarse bajo el usuario dedicado:

su - paperclip

NO ejecutes Paperclip como root.

2. Configuración inicial (asistente de configuración)

Ejecuta la configuración interactiva:

paperclipai onboard

Esto prepara tu instancia para el primer uso.

3. Iniciar Paperclip

Lanza la aplicación:

paperclipai run

Para mantenerla activa tras cerrar sesión, usa herramientas como tmux

4. Servicios predeterminados

Una vez en ejecución (salvo que se reconfigure), el sistema expone:

• Servidor API → http://127.0.0.1:3100/api
• Comprobación de estado → http://127.0.0.1:3100/api/health
• Interfaz → http://127.0.0.1:3100

Estos son los ajustes predeterminados y se aplicarán a menos que cambies explícitamente el binding, el puerto o el dominio durante la configuración.

5. Comandos útiles

# Help / CLI reference
paperclipai --help

# Diagnose issues
paperclipai doctor

# Reconfigure setup
paperclipai configure

# Print environment variables for deployment
paperclipai env

6. Accede a la interfaz de forma segura (tunelización SSH)

Desde tu máquina local, ejecuta:

ssh -L 3100:127.0.0.1:3100 paperclip@<SERVER_IP>

Inicia sesión con las credenciales almacenadas en el servidor en:

/root/.cloudzy-creds

Ve a http://127.0.0.1:3100 en tu navegador local para acceder a la interfaz de Paperclip.

Asegúrate de que Paperclip esté en ejecución en el servidor; de lo contrario, la interfaz y API no serán accesibles.

Rutas importantes

• Directorio de inicio: /home/paperclip
• Configuración: /home/paperclip/.paperclip/instances/default/config.json
• Registros/datos: /home/paperclip/.paperclip/
• Directorio NVM: /home/paperclip/.nvm/

Notas

• No ejecutes paperclipai comandos como root (ejecútalos siempre con el usuario paperclip usuario)
• El paperclip Las credenciales del usuario se almacenan de forma segura en /root/.cloudzy-creds
• También puedes iniciar sesión directamente como el usuario paperclip usando SSH: ssh paperclip@<SERVER_IP>
• Cuando estés conectado como root, cambia siempre al usuario de la aplicación antes de ejecutar cualquier comando de Paperclip: su - paperclip
• Ejecuta onboard solo en la configuración inicial
• Usa configure más adelante para aplicar cambios