Clipe de papel

Uso

0. SSH no servidor

Conecte-se ao seu servidor como root:

ssh root@<SERVER_IP>

Faça login usando sua senha.

1. Mude para o usuário do aplicativo

Todas as operações do Paperclip devem ser executadas sob o usuário dedicado:

su - paperclip

NÃO execute o Paperclip como root.

2. Configuração inicial (assistente de integração)

Execute a configuração interativa:

paperclipai onboard

Isso configura sua instância para o primeiro uso.

3. Inicie o clipe de papel

Inicie o aplicativo:

paperclipai run

Para mantê-lo funcionando após o logout, use ferramentas como tmux

4. Serviços padrão

Uma vez em execução (a menos que seja reconfigurado), o sistema expõe:

• Servidor API → http://127.0.0.1:3100/api
• Verificação de saúde → http://127.0.0.1:3100/api/health
• IU → http://127.0.0.1:3100

Estas são as configurações padrão e serão aplicadas a menos que você altere explicitamente a ligação, a porta ou o domínio durante a configuração.

5. Comandos úteis

# Help / CLI reference
paperclipai --help

# Diagnose issues
paperclipai doctor

# Reconfigure setup
paperclipai configure

# Print environment variables for deployment
paperclipai env

6. Acesse a IU com segurança (túnel SSH)

Na sua máquina local, execute:

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

Faça login usando as credenciais armazenadas no servidor em:

/root/.cloudzy-creds

Navegue até http://127.0.0.1:3100 em seu navegador local para acessar a interface do Paperclip.

Certifique-se de que o Paperclip esteja em execução no servidor, caso contrário, a UI e a API não estarão acessíveis.

Caminhos importantes

• Diretório inicial: /home/paperclip
• Configuração: /home/paperclip/.paperclip/instances/default/config.json
• Registros/dados: /home/paperclip/.paperclip/
• Diretório NVM: /home/paperclip/.nvm/

Notas

• Não corra paperclipai comandos como root (sempre executado sob o paperclip usuário)
• O paperclip as credenciais do usuário são armazenadas com segurança em /root/.cloudzy-creds
• Você também pode fazer login diretamente como paperclip usuário usando SSH: ssh paperclip@<SERVER_IP>
• Quando estiver logado como root, sempre mude para o usuário do aplicativo antes de executar qualquer comando do Paperclip: su - paperclip
• Correr onboard somente na primeira configuração
• Usar configure mais tarde para alterações