Neste guia completo, você aprenderá como instalar o ClawdBot do zero, cobrindo macOS, Linux e Windows via WSL2. Também será mostrado como rodar o wizard de onboarding e conectar o bot aos populares WhatsApp e Telegram, tornando seu uso prático e funcional.

Se você quer aprender como instalar o ClawdBot em diferentes sistemas operacionais, este guia é para você. Vamos abordar tudo desde os pré-requisitos necessários, passando pelos passos detalhados de instalação no macOS, Linux e Windows através do WSL2, até o uso do wizard de onboarding e a integração do bot com WhatsApp e Telegram para comunicação rápida e eficiente. Prepare-se para ter seu ClawdBot funcionando completamente, facilitando suas automações e interações.
Pré-requisitos para instalar o ClawdBot
Antes de começar a instalação do ClawdBot, é importante garantir que seu sistema atenda a alguns pré-requisitos básicos para evitar problemas durante o processo. Isso inclui ter o Node.js instalado em sua versão recomendada, pois o ClawdBot depende dele para rodar. Além disso, é necessário possuir um terminal funcional para executar comandos, e no caso do Windows, ter o WSL2 configurado corretamente para permitir a execução do ambiente Linux necessário.
Outros componentes importantes são:
- Git para clonar o repositório do ClawdBot e manter seu código atualizado.
- Permissões adequadas para executar scripts no terminal.
- Conexão estável com a internet para download de pacotes e dependências.
Verifique também se seu sistema tem suporte para Python se eventualmente algum script auxiliar for usado, e certifique-se de que portas de rede estejam liberadas para comunicação, principalmente para as integrações com WhatsApp e Telegram mencionadas na sequência.
Com esses pontos verificados, seu ambiente estará pronto para iniciar a instalação do ClawdBot sem maiores contratempos.
🤖 Quer aprender a criar agentes de IA e automações como o ClawdBot?
Se você gostou de aprender como instalar o ClawdBot e quer dar o próximo passo para dominar a criação de agentes inteligentes, recomendo a Formação Agentes de IA da Hora de Codar. É um curso prático e direto ao ponto, que vai te ensinar a usar o n8n e outras ferramentas para criar agentes de IA completos, mesmo que você seja iniciante.
Além dos conteúdos técnicos, você terá acesso a projetos práticos, suporte ativo e uma comunidade engajada para trocar experiências. O melhor: todo o curso é pensado para que você consiga aplicar no mundo real e até vender seus serviços de automação.
Vale a pena conhecer para expandir suas habilidades e abrir novas oportunidades no mercado de IA e automações.
Veja mais em: https://app.horadecodar.com.br/lp/formacao-agentes-de-ia-n8n?utm_source=blog

Passo a passo da instalação no macOS e Linux
Instalar o ClawdBot no macOS e Linux pode ser feito de forma bastante similar, já que ambos sistemas possuem terminais Unix-like. O processo começa com a abertura do terminal para execução dos comandos.
- Atualize suas dependências e instale Node.js e Git, caso ainda não tenha:
sudo apt update && sudo apt upgrade -y
sudo apt install nodejs npm git
- Clone o repositório oficial do ClawdBot:
git clone https://github.com/seuusuario/clawdbot.git
cd clawdbot
- Instale as dependências do projeto:
npm install
- Após instalado, é necessário executar o wizard de onboarding para configurar o bot inicialmente. Para isso, use o comando que explicaremos na seção seguinte.
Vale lembrar que você pode precisar ajustar permissões:
chmod +x start.sh
- Para iniciar o ClawdBot, basta rodar:
npm start
Durante a execução, fique atento às mensagens do terminal para garantir que todas as dependências estejam corretas e o bot inicialize com sucesso. Este passo a passo básico cobre a instalação manual, porém há variações para facilitar dependendo do sistema e ferramentas instaladas.
Tutorial para instalar e configurar ClawdBot no Linux, macOS e Windows
Este vídeo é um tutorial completo que mostra passo a passo como instalar o ClawdBot nos sistemas macOS, Linux e Windows via WSL2. Além disso, aborda o uso do wizard de onboarding para configurar o bot e conectar suas contas WhatsApp e Telegram para comunicação eficiente. Se você está começando agora ou quer garantir que está fazendo tudo corretamente, assista e aprenda como ter seu ClawdBot funcionando do zero.
Não perca tempo, clique no vídeo e aprenda agora mesmo!
Como realizar a instalação do ClawdBot no Windows via WSL2
No Windows, instalar o ClawdBot diretamente pode ser complicado devido às diferenças no sistema operacional. Por isso, usar o Windows Subsystem for Linux 2 (WSL2) é a solução ideal para rodar o ClawdBot em um ambiente Linux dentro do Windows.
Para isso, siga os passos:
Ative o WSL2 em seu Windows seguindo a documentação oficial da Microsoft, configurando uma distribuição Linux (Ubuntu é recomendado).
Abra o terminal da distribuição instalada (Ubuntu, Debian, etc.).
Atualize o sistema e instale Node.js e Git:
sudo apt update && sudo apt upgrade -y
sudo apt install nodejs npm git
- Clone o repositório do ClawdBot:
git clone https://github.com/seuusuario/clawdbot.git
cd clawdbot
- Instale as dependências:
npm install
- Utilize o wizard de onboarding para configurar seu bot.
O uso do WSL2 oferece uma camada Linux completa e compatível, garantindo que o ClawdBot funcione sem incompatibilidades. Esse método é perfeito para quem utiliza Windows e deseja aproveitar o poder do ClawdBot sem trocar de sistema.
Dica: Atualize seu WSL2 para a versão mais recente para garantir melhor desempenho e suporte a funcionalidades.
Executando o wizard de onboarding e usando o comando clawdbot onboard –install-daemon
Após ter instalado o ClawdBot, o próximo passo essencial é configurar o bot para que ele funcione perfeitamente no seu ambiente. Para isso, o ClawdBot oferece um wizard de onboarding que guia na configuração inicial.
Para iniciar o processo, abra seu terminal e execute o comando:
clawdbot onboard –install-daemon
Esse comando inicia o assistente que:
- Configura o daemon do ClawdBot para rodar em segundo plano, garantindo que o bot fique sempre ativo.
- Permite definir configurações básicas de acesso e integrações.
- Facilita a autenticação e conexões com serviços externos.
Durante o wizard, será possível conectar o bot a contas de WhatsApp e Telegram, o que tornará a comunicação muito mais simples e prática.
Além disso, para monitorar o status e saúde do seu ClawdBot, você pode utilizar comandos úteis como:
clawdbot doctor
Este comando verifica se tudo está configurado corretamente.
Para acompanhar os logs e resolver problemas, verifique os arquivos gerados de logs ou utilize:
journalctl -u clawdbot.service
Assim, você terá controle total sobre o funcionamento do bot, detectando eventuais erros e realizando manutenções necessárias para manter seu sistema eficiente e estável.
💻 Hospede seu ClawdBot com VPS da Hostinger e garanta desempenho e estabilidade
Para quem está começando ou quer um ambiente confiável para rodar o ClawdBot e outras automações baseadas no n8n, a Hostinger oferece VPS com recursos otimizados e facilidade de instalação.
Com planos a partir de R$27,99/mês, você pode escolher servidores com até 8 núcleos de CPU e 32GB de RAM, perfeito para escalar seus bots conforme a necessidade. A Hostinger garante 99,9% de uptime e suporte 24/7 para ajudar caso precise.
Além disso, o processo de instalação do n8n já pode ser feito automaticamente, simplificando o início do seu projeto. Não deixe de usar o cupom HORADECODAR para conseguir desconto especial.
Recomendo para quem quer segurança, performance e controle total do ambiente.
Saiba mais: https://www.hostinger.com.br/horadecodar

Como conectar o ClawdBot no WhatsApp e Telegram
Uma das funcionalidades mais cobiçadas do ClawdBot é sua capacidade de interagir diretamente pelo WhatsApp e Telegram, facilitando a automação e interação de maneira acessível para usuários comuns.
Para conectar o ClawdBot nesses serviços, durante o wizard de onboarding você será orientado a seguir passos que incluem:
- WhatsApp:
- Escanear o QR Code gerado pelo ClawdBot com o aplicativo do WhatsApp para autenticar a conta.
- O bot utiliza a API não oficial para manter a conexão ativa, portanto, seu celular precisa estar online para que o bot funcione sem interrupções.
- Telegram:
- Criar um bot no Telegram através do BotFather e obter o token de autenticação.
- Informar esse token durante o processo de configuração.
Após essas configurações iniciais, o ClawdBot estará pronto para enviar e receber mensagens, executar comandos e interagir com seus contatos automaticamente.
Vale lembrar que além do onboarding, é possível ajustar essas integrações posteriormente em arquivos de configuração ou comandos específicos para atualização.
Essa integração permite usar o ClawdBot para diversos propósitos, desde atendimento automatizado, notificações, até interações personalizadas, tudo integrado com as plataformas de mensagem mais usadas do Brasil.
Quais são os requisitos para instalar o ClawdBot no macOS, Linux e Windows (WSL2)?
Para instalar o ClawdBot, você precisa do Python atualizado (recomendado 3.8+), Git, Node.js (para integrações avançadas), acesso ao terminal (ou CMD/WSL2 no Windows), e uma conexão à internet. No Windows, é obrigatório usar o WSL2 para garantir compatibilidade total.
Como rodar o wizard de onboarding e conectar o ClawdBot ao WhatsApp ou Telegram?
Após instalar o ClawdBot e suas dependências, execute o comando ‘clawdbot setup’ ou siga as instruções do README. O wizard de onboarding irá guiá-lo na configuração inicial, onde você poderá escolher conectar o bot ao WhatsApp (via QR code) ou ao Telegram (inserindo o token do bot gerado no @BotFather).
O que fazer em caso de erro durante a instalação do ClawdBot?
Em caso de problemas, revise se todas as dependências estão instaladas corretamente (Python, Git, Node.js). Verifique as mensagens de erro no terminal para detalhes. Consulte o README oficial ou comunidades de suporte do ClawdBot. Problemas comuns incluem falta de permissões, dependências ausentes ou configurações no WSL2 no Windows.
Aprenda tudo sobre Clawdbot
Tutorial completo e gratuito para você aprender da instalação a criar seu próprio assistente pessoal de IA que roda no WhatsApp, Telegram ou Discord. Assista agora:
Conclusão
Aprender como instalar o ClawdBot em diversas plataformas é um passo importante para quem busca automatizar processos e integrar o bot com WhatsApp e Telegram, duas ferramentas essenciais para a comunicação atual. Passar por todos os pré-requisitos, realizar a instalação corretamente e utilizar o wizard de onboarding garante que seu ClawdBot funcione de forma estável e eficiente.
Além disso, contar com recursos para monitorar a saúde do bot, acompanhar logs e conectar suas contas de mensagem aumenta a produtividade e a confiabilidade do sistema. Para quem quiser ir além, a Formação Agentes de IA da Hora de Codar é uma ótima oportunidade para se aprofundar em automações e criação de agentes inteligentes.
Se deseja hospedar seu ClawdBot com qualidade e performance, a VPS da Hostinger é uma escolha natural, oferecendo estabilidade, suporte e escalabilidade a preços competitivos. Com essas dicas e recursos, você estará preparado para usar o ClawdBot com toda sua potência no dia a dia.