Como Instalar o Clawdbot em um VPS

Por volta de 7 min

Como Instalar o Clawdbot em um VPS

Clawdbot é um assistente pessoal de IA open-source e auto-hospedado que se conecta às suas plataformas de mensagens favoritas. Diferente dos assistentes de IA baseados em nuvem como o ChatGPT, o Clawdbot roda inteiramente na sua infraestrutura, dando a você controle total sobre seus dados e privacidade. Neste artigo, vamos guiá-lo pelo processo de instalação do Clawdbot em um VPS usando Node.js. Recomendamos usar o LightNode como seu provedor de VPS.

O que é o Clawdbot?

Clawdbot é um poderoso assistente pessoal de IA que vive dentro dos seus apps e plataformas de mensagens favoritas. Ele se conecta ao WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams, Google Chat e mais, transformando Large Language Models em um companheiro verdadeiramente pessoal e sempre disponível. Principais recursos incluem:

Suporte Multiplataforma: Funciona em mais de 10 plataformas de mensagens
Memória Persistente: Lembra suas preferências e conversas passadas ao longo do tempo
Ações Proativas: Pode executar ações, definir lembretes e enviar notificações
Auto-hospedado: Controle total sobre seus dados e privacidade
Personalizável: Extensível com skills e ferramentas
Sempre Ativo: Roda 24/7 no seu VPS ou máquina local

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

Um Servidor VPS: Você pode escolher entre vários provedores de nuvem. Recomendamos o LightNode pela excelente performance e cobertura global.
Conhecimento Básico de Linha de Comando: Familiaridade com comandos de terminal será útil.
Node.js Instalado: Certifique-se de que o Node.js 22 ou superior está instalado no seu servidor.
Requisitos Mínimos do Sistema: 2GB de RAM, 1 vCPU, 10GB de espaço em disco (4GB de RAM recomendados para uso em produção).

Por que Recomendamos o VPS LightNode

O LightNode é uma excelente escolha para hospedar o Clawdbot por vários motivos:

Benefícios Principais do LightNode

Preço Acessível: Planos a partir de $7,71/mês com cobrança por hora, permitindo testar sem compromissos de longo prazo.
40+ Localizações Globais: Data centers em 6 continentes, incluindo EUA, Europa, Ásia, Oriente Médio e África, garantindo baixa latência para usuários no mundo todo.
Alta Performance: Armazenamento NVMe SSD e CPUs de alta frequência oferecem excelente desempenho para cargas de trabalho de IA.
Garantia de Uptime de 99,95%: Infraestrutura confiável com acesso BGP local para garantir que seu assistente esteja sempre disponível.
Cobrança Flexível: Pague apenas pelo que usar com cobrança por hora, ideal para testes e escalabilidade.
Amigável para Desenvolvedores: Acesso root completo, implantação instantânea e suporte para Linux e Windows.
Snapshots Gratuitos: Um snapshot gratuito por VPS para backups e recuperação fáceis.
Bônus para Novos Usuários: Ganhe até $15 em créditos grátis no seu primeiro recarregamento.

Configuração Recomendada do LightNode para Clawdbot

Componente	Especificação	Custo Mensal
Plano	Agency	$14,70/mês
CPU	2 vCPU	-
RAM	4GB DDR4	-
Armazenamento	50GB NVMe SSD	-
Banda	2TB	-
Localização	Singapura, Hong Kong ou Silicon Valley	-

Essa configuração oferece recursos suficientes para as operações do Clawdbot e permite crescimento conforme seu uso aumenta.

Comece com o LightNode

Passo 1: Configurando seu VPS

Inicie a Instância: Faça login no LightNode e crie uma nova instância VPS. Recomendamos escolher uma localização próxima aos seus usuários principais para latência ideal. Para acesso global, Singapura ou Hong Kong são ótimas opções para usuários asiáticos, enquanto Silicon Valley funciona bem para usuários norte-americanos.
Escolha o Sistema Operacional: Selecione Ubuntu 22.04 LTS (recomendado) ou Ubuntu 24.04. Essas versões têm excelente suporte ao Node.js e são amplamente testadas.
Acesso SSH: Use um cliente SSH para acessar seu servidor:
```
ssh username@your_server_ip
```

Passo 2: Instalando o Node.js

O Clawdbot requer Node.js versão 22 ou superior. Veja como instalá-lo no Ubuntu:

# Atualizar listas de pacotes
sudo apt update

# Instalar Node.js 22 do repositório NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Verificar instalação
node --version
# Deve mostrar: v22.x.x

Alternativamente, você pode usar o NVM (Node Version Manager) para mais flexibilidade:

# Instalar NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# Instalar Node.js 22
nvm install 22
nvm use 22

# Verificar instalação
node --version

Passo 3: Instalando o Clawdbot

Existem vários métodos de instalação disponíveis. Escolha o que melhor se adapta às suas necessidades.

Método 1: Script Oficial de Instalação (Recomendado para Iniciantes)

O script instalador é o método mais fácil e gerencia automaticamente as dependências:

# Baixar e executar o instalador
curl -fsSL https://clawd.bot/install.sh | bash

Esse comando irá:

Detectar seu sistema operacional
Garantir que o Node.js 22+ esteja instalado
Instalar o Clawdbot globalmente via npm
Configurar os caminhos necessários
Executar o comando doctor para verificar a instalação

Método 2: Instalação Global via npm

Para usuários confortáveis com npm:

# Instalar Clawdbot globalmente
npm install -g clawdbot@latest

# Ou usando pnpm (mais rápido)
pnpm add -g clawdbot@latest

# Verificar instalação
clawdbot --version

Método 3: Instalar a partir do Código-Fonte (Para Desenvolvedores)

# Clonar o repositório
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Instalar dependências
pnpm install

# Construir a interface
pnpm ui:build

# Construir o projeto
pnpm build

# Executar o assistente de configuração
./dist/entry.js onboard --install-daemon

Método 4: Instalação via Docker (Opcional)

Para implantação em container:

# Clonar o repositório
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Executar o script de configuração Docker
./docker-setup.sh

Passo 4: Executando o Assistente de Configuração

Após a instalação, execute o assistente para configurar o Clawdbot:

# Iniciar o assistente interativo
clawdbot onboard --install-daemon

O assistente irá guiá-lo por:

Configuração do Gateway: Escolha modo gateway local ou remoto e configure a porta do gateway (padrão: 18789).
Configuração de Autenticação: Configure seu provedor de modelo de IA.
- Anthropic (Claude): chave API ou OAuth (recomendado)
- OpenAI (ChatGPT/Codex): chave API
- Outros Provedores: endpoints personalizados e chaves API
Configuração dos Canais: Configure plataformas de mensagens:
- WhatsApp: login via QR code
- Telegram: token do bot do @BotFather
- Discord: token do bot do Portal de Desenvolvedores Discord
- Slack: OAuth ou token do bot
Instalação do Serviço: Instale o Gateway como serviço em segundo plano (systemd no Linux).
Identidade do Agente: Configure a personalidade e comportamento padrão do seu assistente.

Passo 5: Iniciando o Gateway

Após completar o assistente, o Gateway deve iniciar automaticamente. Você pode verificar o status com:

# Verificar status do gateway
clawdbot gateway status

# Visualizar logs
clawdbot logs --follow

# Verificar saúde
clawdbot health

Início Manual (se o serviço não estiver rodando)

# Iniciar gateway em primeiro plano
clawdbot gateway --port 18789 --verbose

Gerenciando o Serviço

# Iniciar o serviço
systemctl --user start clawdbot-gateway.service

# Parar o serviço
systemctl --user stop clawdbot-gateway.service

# Reiniciar o serviço
systemctl --user restart clawdbot-gateway.service

# Habilitar serviço para iniciar no boot
systemctl --user enable clawdbot-gateway.service

# Visualizar logs do serviço
journalctl --user -u clawdbot-gateway -f

Passo 6: Acessando o Painel de Controle

A interface de controle do Clawdbot é acessível pelo navegador:

http://your_server_ip:18789/

Se você configurou autenticação durante o assistente, será necessário fornecer o token do gateway para acessar o painel.

Acesso Remoto via Túnel SSH

Para acesso remoto seguro:

# Configurar túnel SSH da sua máquina local
ssh -N -L 18789:127.0.0.1:18789 username@your_server_ip

# Então acesse localmente
http://localhost:18789/

Passo 7: Conectando seu Primeiro Canal

Para conectar o WhatsApp:

# Gerar e exibir QR code
clawdbot channels login

# Escaneie com o WhatsApp:
# Configurações → Dispositivos Conectados → Conectar um dispositivo

Após escanear, seu WhatsApp estará conectado ao Clawdbot.

Crie um bot enviando mensagem para @BotFather no Telegram
Siga as instruções para criar um novo bot
Copie o token do bot fornecido
Adicione o bot ao Clawdbot:

clawdbot channels add --channel telegram --token "seu_token_do_bot_aqui"

Discord

Acesse o Portal de Desenvolvedores do Discord
Crie uma nova aplicação
Ative o bot na aba "Bot"
Copie o token do bot
Convide o bot para seu servidor Discord com as permissões apropriadas
Adicione ao Clawdbot:

clawdbot channels add --channel discord --token "seu_token_do_bot_discord"

Passo 8: Configurando a Segurança de Mensagens Diretas (DM)

Por padrão, o Clawdbot usa um modo de pareamento para mensagens diretas, ou seja, remetentes desconhecidos recebem um código de pareamento e suas mensagens não são processadas até serem aprovadas.

# Listar solicitações de pareamento pendentes
clawdbot pairing list whatsapp

# Aprovar uma solicitação de pareamento
clawdbot pairing approve whatsapp <código_de_pareamento>

# Ver solicitações aprovadas
clawdbot pairing list whatsapp --approved

Você pode modificar esse comportamento no arquivo de configuração em ~/.clawdbot/clawdbot.json.

Passo 9: Testando sua Configuração

Envie uma mensagem de teste para verificar se está tudo funcionando:

# Enviar mensagem de teste
clawdbot message send --to +15555550123 --message "Olá do Clawdbot!"

# Ou testar via Telegram
clawdbot message send --to @seu_usuario_telegram --message "Olá!"

Alternativamente, envie uma mensagem diretamente para seu WhatsApp/Telegram/Discord conectado, e seu assistente Clawdbot deverá responder.

Passo 10: Configurando Nginx (Opcional)

Para uso em produção, recomendamos configurar um proxy reverso com Nginx para melhorar a segurança e gerenciar certificados SSL.

Instalar Nginx

sudo apt install -y nginx

Configurar Nginx

Edite o arquivo de configuração do Nginx:

sudo nano /etc/nginx/sites-available/clawdbot

Adicione a seguinte configuração:

server {
    listen 80;
    server_name your-domain.com;  # Substitua pelo seu domínio

    location / {
        proxy_pass http://localhost:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

Habilitar a Configuração

# Criar link simbólico
sudo ln -s /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/

# Testar configuração do Nginx
sudo nginx -t

# Reiniciar Nginx
sudo systemctl restart nginx

Adicionar SSL com Certbot (Recomendado)

# Instalar Certbot
sudo apt install -y certbot python3-certbot-nginx

# Obter certificado SSL
sudo certbot --nginx -d your-domain.com

# O Certbot configurará automaticamente o Nginx com SSL

Após isso, seu Clawdbot estará acessível em:

https://your-domain.com/

Solução de Problemas Comuns

Gateway Não Inicia

Se o gateway não iniciar:

# Verificar erros de configuração
clawdbot doctor

# Ver logs detalhados
journalctl --user -u clawdbot-gateway -n 50

Erros de Memória Insuficiente

Em VPS com 2GB de RAM, você pode encontrar erros de falta de memória durante atualizações. Adicione um arquivo swap:

# Criar arquivo swap de 2GB
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Tornar swap persistente
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Porta Já em Uso

Se a porta 18789 já estiver em uso:

# Descobrir o que está usando a porta
sudo lsof -i :18789

# Ou usar uma porta diferente
clawdbot gateway --port 18889

Bot Não Responde

Se seu bot não estiver respondendo:

Verifique o status do Gateway: clawdbot gateway status
Confirme a configuração dos canais: Certifique-se de que os tokens estão corretos e os canais ativados
Cheque a autenticação: Verifique se as chaves API são válidas
Revise os logs: clawdbot logs --follow para procurar mensagens de erro

Atualizando o Clawdbot

Para atualizar para a versão mais recente:

# Reexecutar o instalador
curl -fsSL https://clawd.bot/install.sh | bash

# Ou atualizar via npm
npm update -g clawdbot@latest

# Reiniciar o gateway
clawdbot gateway restart

# Verificar saúde
clawdbot health

Conclusão

Instalar o Clawdbot em um VPS é um processo simples que lhe proporciona um assistente de IA poderoso, auto-hospedado e acessível em múltiplas plataformas de mensagens. Com os preços acessíveis, cobertura global e infraestrutura de alta performance do LightNode, você pode implantar seu assistente pessoal de IA com confiança.

Seguindo este guia, você deverá ter o Clawdbot rodando no seu VPS em cerca de 20-30 minutos, oferecendo um companheiro de IA sempre disponível que respeita sua privacidade e dá controle total sobre seus dados.

Para personalizações avançadas e recursos adicionais, consulte a documentação oficial na página do Clawdbot no GitHub e explore as discussões da comunidade para mais insights e dicas.

Recursos Adicionais

Documentação Oficial do Clawdbot
Repositório GitHub do Clawdbot
LightNode VPS - Provedor VPS Recomendado
Comunidade Clawdbot no Discord
Skills Marketplace - Expanda seu assistente com skills adicionais