Clip de papel

Uso

0. SSH en el servidor

Conéctese a tu servidor como root:

ssh root@<SERVER_IP>

Inicie sesión con su contraseña.

1. Cambie al usuario de la aplicación.

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

su - paperclip

NO ejecute Paperclip como root.

2. Configuración por primera vez (asistente de incorporación)

Ejecute la configuración interactiva:

paperclipai onboard

Esto configura su instancia para el primer uso.

3. Inicie el clip

Inicie la aplicación:

paperclipai run

Para que siga funcionando después de cerrar sesión, utilice herramientas como tmux

4. Servicios predeterminados

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

• Servidor API → http://127.0.0.1:3100/api
• Control de salud → http://127.0.0.1:3100/api/health
• Interfaz de usuario → http://127.0.0.1:3100

Estas son las configuraciones predeterminadas y se aplicarán a menos que cambie explícitamente el enlace, 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. Acceda a la interfaz de usuario de forma segura (túnel SSH)

Desde su máquina local, ejecute:

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

Inicie sesión utilizando las credenciales almacenadas en el servidor en:

/root/.cloudzy-creds

Navegar a http://127.0.0.1:3100 en su navegador local para acceder a la interfaz de usuario de Paperclip.

Asegúrese de que Paperclip se esté ejecutando en el servidor; de lo contrario, no se podrá acceder a la interfaz de usuario ni a la API.

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 corras paperclipai comandos como root (siempre ejecútelos bajo el paperclip usuario)
• El paperclip Las credenciales de usuario se almacenan de forma segura en /root/.cloudzy-creds
• También puede iniciar sesión directamente como paperclip usuario que usa SSH: ssh paperclip@<SERVER_IP>
• Cuando inicie sesión como root, cambie siempre al usuario de la aplicación antes de ejecutar cualquier comando de Paperclip: su - paperclip
• Correr onboard sólo en la primera configuración
• Usar configure más tarde para cambios