Como configurar o Paperclip em um VPS: guia completo

O Paperclip é uma plataforma de orquestração de código aberto que permite construir, gerenciar e coordenar múltiplos agentes de IA em direção a um objetivo comum. Configurar isso em um VPS oferece um ambiente persistente e auto-hospedado para administrar uma empresa de agentes autônomos.

Hospedar o Paperclip no seu próprio servidor também significa que você mantém controle total sobre seus dados, configurações de agentes e custos de infraestrutura.

Para configurar o Paperclip em um VPS, você precisa preparar um servidor com recursos suficientes para manter seus agentes rodando 24 horas por dia, instalar a aplicação usando o Docker e configurar a organização dos seus agentes de IA pelo painel de controle.

Aqui está a explicação passo a passo de como configurar o Paperclip em um VPS:

• Escolha um plano VPS. Escolha um com recursos suficientes para manter seus agentes funcionando continuamente. Uma configuração com 2 núcleos vCPU, 4 GB de RAM e 50 GB de armazenamento SSD é suficiente para uma configuração básica.
• Implante o Paperclip usando o Docker. O Docker agrupa o Paperclip e todas as suas dependências em um único container, então você pode pular grande parte do trabalho manual.
• Faça login no painel do Paperclip. Acesse seu ambiente do Paperclip pelo navegador e faça login com as credenciais que você definiu durante a implantação.
• Estabeleça uma meta e defina worflows. Dê um nome à sua empresa de IA e um objetivo específico e mensurável. Esse é o alvo ao qual o trabalho de todo agente irá remontar.
• Adicione agentes com funções definidas. Construa seu organograma designando agentes para funções como CEO, CTO ou marketing, cada um com suas próprias responsabilidades e configuração de adaptadores.
• Defina orçamentos para tokens LLM. Aplique limites de gasto no nível do agente ou projeto para manter os custos da API previsíveis à medida que seus agentes começam a executar tarefas.
• Monitore seus agentes. Acompanhe o progresso das tarefas, revise os registros e identifique quaisquer configurações erradas ou ineficiências antes que se acumulem.
• Otimize e escale. Refinar as definições de funções, ajustar as linhas de reporte e aprimorar seus recursos de VPS à medida que a organização dos agentes cresce.

Se preferir aprender com vídeo, assista a este tutorial em vídeo (em inglês) para configurar o Paperclip no VPS Hostinger:

Subscribe For more educational videos! Hostinger Academy

Subscribe

1. Escolha um VPS para rodar o Paperclip

Um servidor privado virtual (VPS) é a escolha perfeita para o Paperclip, pois mantém seus agentes operando continuamente. Isso significa que seus agentes podem continuar trabalhando em tarefas, cumprindo ciclos programados e atualizando seus logs mesmo quando você estiver offline.

Um ambiente VPS também é benéfico para cargas de trabalho de IA, que consomem mais recursos do que um web app comum. Os agentes processam respostas de grandes modelos de linguagem (LLM), escrevem em um banco de dados e executam trabalhos em segundo plano simultaneamente.

Dito isso, os requisitos ainda são administráveis para setups menores. Para uma configuração básica com uma pequena equipe de agentes, configurar um VPS com 2 núcleos vCPU, 4 GB de RAM e 50 GB de armazenamento SSD é suficiente para começar, especialmente rodando no Ubuntu 22.04 ou Debian 12.

Além das especificações brutas, vale a pena priorizar a facilidade de configuração ao comparar os melhores provedores de hospedagem de clipes de papel. Procure plataformas que ofereçam templates de aplicação pré-configurados e acesso completo root SSH.

Esses recursos reduzem significativamente o tempo de configuração, simplificam o gerenciamento contínuo e ainda oferecem flexibilidade para implementar personalizações mais avançadas no nível do servidor quando necessário.

A maioria dos planos VPS para rodar Paperclip custa entre R$35 e R$180 por mês. E como o Paperclip é open source, seus únicos custos contínuos são os tokens de servidor e API dos agentes de IA que você usa.

2. Implante o Paperclip usando o Docker

Docker é uma ferramenta que empacota uma aplicação e todas as suas dependências em um conjunto de containers, que são unidades autônomas que rodam da mesma forma em qualquer servidor.

Para o Paperclip, isso significa que você não precisa instalar Node.js manualmente, configurar um banco de dados ou definir variáveis de ambiente uma a uma.

Existem três maneiras diferentes de implantar o Paperclip com o Docker, dependendo se você já configurou um VPS antes.

Se você está configurando um novo VPS, a opção mais rápida é o modelo pré-configurado de Paperclip do Hostinger. Compre um plano pela página de hospedagem do Paperclip, siga os passos de integração e você será levado diretamente para a tela de configuração do Paperclip.

Preencha seu nome de administrador, endereço de e-mail e senha, e então, opcionalmente, adicione uma chave de API para o seu provedor de modelo de IA preferido.

Se você pular a adição de uma chave de API, o Paperclip ainda será implantado com sucesso, mas seus agentes não poderão executar tarefas até que você adicione uma chave depois pelo painel.

Depois de clicar em Implantar, o Paperclip estará funcionando no seu servidor em alguns instantes.

Se você já tem um VPS Hostinger, faça login no hPanel e navegue até o VPS → SO e o Sistema operacional do painel → . Certifique-se de que o Docker está instalado, depois encontre o Paperclip no menu do aplicativo Docker para implantá-lo.

Se você estiver em outro provedor de VPS, precisará configurar uma instância Docker primeiro, depois instalar o Paperclip usando o Docker Compose executando este comando:

docker compose -f docker-compose.quickstart.yml up –build

3. Faça login no painel do Paperclip

Se você usou o instalador de um clique do Hostinger, será direcionado diretamente para a página do Docker Manager no seu painel VPS. Localize seu projeto e clique em Abrir para abrir o painel Paperclip no seu navegador.

Alternativamente, você pode acessá-lo digitando o endereço IP do seu servidor diretamente em um navegador e adicionando a porta Paperclip:

http://203.0.113.1:3100

Substitua 203.0.113.1 pelo endereço IP real do seu servidor, enquanto a porta 3100 é o padrão do Paperclip.

Esse método funciona desde que a porta 3100 esteja aberta no seu servidor e o Paperclip esteja configurado para aceitar conexões externas – ambos gerenciados automaticamente pelo instalador de um clique do Hostinger.

Então, você será solicitado a fazer login no Paperclip. Se você usou o instalador de um clique do Hostinger, insira o endereço de e-mail e a senha que definiu durante a etapa de configuração do Paperclip.

Se você está configurando em outro VPS, talvez precise criar uma conta de administrador antes de poder fazer login.

4. Defina uma meta e fluxos de trabalho para sua empresa de IA

Logo após fazer login no Paperclip, você será solicitado a configurar sua primeira empresa de IA. Comece dando um nome e um objetivo.

Recomendamos estabelecer uma meta mesmo que tecnicamente seja opcional – é o que o trabalho de todo agente remonta.

Certifique-se de que o objetivo seja específico para tornar o resultado mais útil. Em vez de escrever “Construa um aplicativo de anotações”, mire algo como “Construa o aplicativo de anotações com IA #1 para um MRR de R$1 milhão em três meses.” Agentes funcionam melhor quando têm um objetivo claro.

Clique em Next, e você será solicitado a configurar o papel do seu primeiro agente. Por padrão, o Paperclip atribui o cargo de CEO, que é o topo do seu organigrama. A partir daí, escolha um tipo de adaptador e o modelo de IA que você prefere para executar as tarefas.

Clique em Next para continuar atribuindo tarefas para o cargo de CEO. Você encontrará um campo de descrição de tarefa onde pode escrever um prompt do sistema explicando o que o agente deve fazer e o que priorizar.

O clipe de papel estrutura os agentes usando um organograma, assim como uma empresa organiza sua equipe. Cada agente tem um papel definido, reporta-se a outro agente ou a você, e lida com um tipo específico de trabalho.

O CEO atua como o coordenador de alto nível, recebendo metas, dividindo-as em tarefas de alto nível e delegando o trabalho para baixo no organigrama.

Você pode pedir ao CEO que contrate agentes específicos para funções, como um agente CTO para tarefas técnicas, um agente de Marketing para conteúdo e divulgação, um agente de pesquisa para coleta de informações, e assim por diante. Especifique essas necessidades no seu pedido inicial do sistema para o agente CEO.

Depois disso, clique em Next para revisar o resumo da sua organização. Se tudo parecer certo, clique em Create & Open Issue para finalizar a configuração.

Isso cria sua organização e abre a primeira tarefa do agente CEO, que é o ponto de partida para todo o trabalho que vem a seguir.

5. Adicione outros agentes de IA com as funções que você precisa

Após lançar sua primeira edição, você será redirecionado para o painel do Paperclip, onde pode assistir o agente CEO da IA executar seu primeiro batimento cardíaco. Funcionará de acordo com a meta da empresa que você estabeleceu e a tarefa que você deu anteriormente.

Existem duas maneiras de adicionar agentes à sua organização. Se você incluiu uma estrutura organizacional no prompt do sistema do seu CEO, ela gerará automaticamente pedidos de contratação – eles aparecerão na Inbox do seu painel Paperclip, onde você pode aprovar os que se encaixam na sua configuração.

Alternativamente, você pode adicionar agentes manualmente clicando no botão mais (+) no menu Agents, que permite configurar cada agente do zero usando parâmetros personalizados como tipo de adaptador, modelo de prompt, modelo e capacidades.

A rota manual é especialmente útil se você quiser diferentes funções rodando em adaptadores diferentes – por exemplo, um Backend Engineer no Claude Code e um Frontend Engineer no Gemini CLI.

Comece criando no máximo de três a cinco agentes – um coordenador e dois a quatro especialistas – para que você possa depurar facilmente e ganhar confiança antes de adicionar complexidade.

6. Defina seus orçamentos de tokens LLM

Toda vez que um agente executa uma tarefa, ele usa tokens – a unidade de medida para o uso da API do LLM. Esses tokens têm um custo, então, em uma configuração multiagente movimentada, as despesas podem se acumular rapidamente, especialmente se os agentes de IA caírem em loops ou repetirem o trabalho desnecessariamente.

O Paperclip resolve isso com um sistema orçamentário embutido que permite definir limites de gastos com LLMs no nível do agente ou projeto, em toda a organização.

Para definir um limite de uso, abra o agente ou projeto e navegue até a aba Budget. A partir daí, insira o valor desejado no campo Budget (USD) e clique em Update Budget para aplicá-lo.

Recomendamos começar com limites conservadores durante os testes, ajustando-os conforme você aprende quanto custa cada tipo de tarefa.

Você pode acompanhar isso diretamente pelo seu painel do Paperclip, que mostra uma divisão em tempo real do uso do token por agente. Revise regularmente nos primeiros dias para identificar quais agentes estão mais ativos – e identificar aqueles que estão usando tokens de forma ineficiente.

7. Monitore seus agentes de IA

Cada agente do Paperclip funciona em um cronograma acelerado: ele acorda em intervalos definidos, revisa suas tarefas atuais e objetivos da empresa, decide o que fazer a seguir, executa, registra seus resultados e então fica parado até o próximo ciclo.

O intervalo padrão para um agente CEO é de 30 a 60 minutos. Você também pode acionar um batimento cardíaco manualmente nas configurações do agente se quiser que ele aja imediatamente sem esperar pelo próximo ciclo programado.

O principal local para monitorar seus agentes é a seção de Issues do painel, que mostra todas as tarefas da sua organização – a quem ela está designada, seu status e como ela se relaciona com o objetivo da sua empresa.

Clique em qualquer edição para ler o raciocínio do agente, as chamadas de ferramentas e o registro completo do que ele fez durante aquele batimento cardíaco.

Enquanto isso, o painel principal do Paperclip oferece uma visão geral da sua organização: agentes ativos, atividade recente e consumo de orçamento em um relance.

Se algo der errado – um agente travar, parar de progredir ou produzir resultados de baixa qualidade – os registros de batimentos cardíacos são o primeiro lugar a verificar.

Causas comuns de erros ou saída de baixa qualidade no Paperclip incluem descrições vagas de tarefas, chaves de API faltando ou um agente tentando delegar para outro agente que não possui as capacidades necessárias.

8. Otimize e escale seu setup

À medida que sua organização de clipes de papel cresce, melhorar a qualidade do workflow se resume a objetivos mais claros e melhores definições de funções.

Se um agente está produzindo resultados pouco úteis, revise a descrição do cargo, adicione responsabilidades mais específicas e inclua exemplos de como é um bom trabalho.

Se as tarefas estiverem sendo descartadas ou roteadas incorretamente, revise suas linhas de relatório e certifique-se de que sua lógica de delegação ainda se mantém.

No lado técnico, talvez você precise escalar sua infraestrutura VPS conforme o uso cresce, então monitore regularmente o uso de CPU e RAM pelo seu painel de controle.

Se o uso permanecer consistentemente acima de 70-80%, é um bom sinal para fazer upgrade para o próximo nível. A maioria dos provedores permite que você escale sem inatividade ou perda de dados, então você pode ajustar os recursos gradualmente.

Por fim, espere que sua estrutura evolua. Após uma ou duas semanas de uso real, padrões começam a surgir – alguns papéis podem estar sobrecarregados, certos agentes podem se sobrepor, ou objetivos podem se mostrar amplos demais para delegar de forma eficaz. Trate isso como esperado, não como fracasso. Revise seus logs, observe como o trabalho realmente flui e ajuste sua configuração de acordo.

Melhores práticas para configurar o Paperclip

Os passos acima fazem o Paperclip funcionar. Essas práticas ajudam a funcionar bem ao longo do tempo:

• Escreva seu próprio prompt para sistema. Ao adicionar agentes de IA e definir suas tarefas, escreva seus próprios prompts para melhorar a qualidade do resultado. Siga as melhores práticas de engenharia dos prompts ao escrevê-lo – inclua as responsabilidades do agente, como ele deve abordar as decisões e como é um bom resultado para seu papel.
• Teste um workflow antes de construir outro. Defina um único objetivo, deixe seus agentes trabalharem por ele de ponta a ponta e revise o resultado antes de adicionar mais agentes ou metas. Fluxos de trabalho paralelos são mais difíceis de resolver quando algo dá errado.
• Revise os registros cedo e com frequência. As primeiras 48 horas são as mais informativas. Os agentes rapidamente revelam configurações incorretas, papéis pouco claros e chaves de API ausentes. Ler os registros nessa janela economiza muito tempo depois.
• Mantenha as metas atualizadas. Cada tarefa criada pelos seus agentes remonta ao objetivo ativo – um objetivo ultrapassado significa que seus agentes continuam trabalhando em algo que você não se importa mais. Acesse Objectives no seu painel de Paperclip para editar a meta da empresa ou adicionar uma nova.
• Use solicitações de aprovação como um ciclo de feedback. Se os pedidos do CEO não corresponderem ao que você esperava, geralmente é um sinal de que o objetivo ou o pedido do sistema precisa ser mais específico.
• Faça backup do seu diretório de dados. A estrutura de organização do seu Paperclip, histórico de agentes e logs de auditoria ficam em um único diretório de dados no seu servidor. Faça backup regularmente, especialmente antes de atualizar o Paperclip ou mudar a configuração do seu VPS.
• Documente a estrutura da sua organização. À medida que sua equipe de agentes cresce, mantenha um registro simples do que cada agente faz, qual adaptador ele usa e para quais objetivos ele contribui. Isso facilita muito revisitar a configuração depois de algumas semanas fora ou incorporar outra pessoa para gerenciá-la.

Para saber mais sobre como usar o Paperclip depois que sua configuração estiver estável, confira nosso guia de casos de uso do Paperclip.

Todo o conteúdo dos tutoriais deste site segue os rigorosos padrões editoriais e valores da Hostinger.

O autor

Ricardo Neto

Esse é Ricardo, o Tradutor e YouTuber da Hostinger Brasil, presente na empresa desde muito cedo tem conhecimento avançado sobre Hospedagem de Sites. Formado em Desenvolvimento de Jogos, teve uma oportunidade em 2015 de começar uma longa jornada de sucesso e parceria com a Hostinger Brasil.

Mais de Ricardo Neto