OpenClaw (caranguejo-do-mar) é, atualmente, o projeto open source de agentes de IA com a maior velocidade de crescimento no GitHub, permitindo-te instalar na tua própria máquina um assistente privado de IA com disponibilidade permanente, e falar com ele através de apps de mensagens que já usas habitualmente, como Telegram, WhatsApp, Discord, etc.
Este tutorial começa do zero e leva-te da instalação à configuração, até ao envio da tua primeira mensagem — demora cerca de 10 minutos no total.
O que é OpenClaw? E em que é diferente do ChatGPT?
O ChatGPT é uma ferramenta de perguntas e respostas: tu fazes uma pergunta e ele dá-te uma resposta; depois de a conversa terminar, acaba aí. O OpenClaw é um agente de IA: entregas-lhe uma tarefa e ele pensa por si, chama ferramentas, executa ações — verificar o teu Gmail, ver o teu calendário, pesquisar na web, escrever código — e depois mostra-te os resultados.
A diferença mais importante é: o OpenClaw corre na tua própria máquina e os dados ficam totalmente sob teu controlo, não sendo enviados para quaisquer servidores de terceiros. Ele próprio não inclui um modelo de IA; precisas de fornecer tu o teu API Key (Anthropic Claude, OpenAI GPT, Google Gemini, etc. — todos são suportados). Os custos do modelo são pagos diretamente por ti ao fornecedor.
Preparação antes da instalação
Requisitos do sistema
macOS, Linux, ou Windows (recomenda-se usar WSL2, pois é mais estável)
Node.js 22.14 ou superior (recomenda-se Node 24)
Pelo menos um conjunto de API Key de modelos de IA
Instalar o Node.js
Primeiro, confirma se está instalado e se a versão é suficiente:
node -v
Se a versão for inferior a v22.14 ou ainda não estiver instalado, escolhe o método de instalação de acordo com o teu sistema:
Obter AI model API Key
O OpenClaw suporta vários fornecedores de modelos. As três opções mais comuns são as seguintes:
Anthropic Claude: vai a console.anthropic.com para criares uma conta e adicionares uma chave na página API Keys. Claude Sonnet 4.x é atualmente a opção mais popular.
OpenAI GPT: vai a platform.openai.com para criares um API Key.
Google Gemini: vai a aistudio.google.com para obteres gratuitamente um API Key.
Copia o API Key e deixa-o guardado; mais tarde será necessário colá-lo durante a instalação.
Primeiro passo: instalar o OpenClaw
No macOS e no Linux basta um único comando:
curl -fsSL | bash
No Windows, os utilizadores devem executar no PowerShell:
iwr -useb | iex
Após a instalação, confirma que o comando pode ser usado:
openclaw --version
Segundo passo: executar o guia Onboarding
Executa o comando abaixo para iniciar o assistente de configuração interativo, fazendo também com que o OpenClaw arranque em segundo plano como um serviço do sistema:
openclaw onboard --install-daemon
O assistente vai perguntar-te, em sequência, algumas coisas:
Escolher o fornecedor do modelo: escolhe o fornecedor de que obtiveste o API Key agora (Anthropic, OpenAI, Google, etc.)
Colar o API Key: cola a chave que acabaste de copiar
Escolher o modelo: recomenda-se escolher o modelo principal mais recente (por exemplo, claude-sonnet-4-5)
Escolher o modo de instalação: para principiantes, escolhe QuickStart; ele usará valores predefinidos para concluir toda a configuração
O processo todo demora cerca de 2 minutos; na maioria das opções, basta premir Enter para aceitar os valores predefinidos.
Terceiro passo: confirmar que o Gateway está em execução
openclaw gateway status
Se vires que o Gateway está a escutar na porta 18789, significa que a instalação foi bem-sucedida.
Abre o browser para experimentar a interface de controlo:
openclaw dashboard
O browser abrirá o Control UI; aqui podes enviar diretamente mensagens ao assistente de IA para confirmares que tudo está a funcionar corretamente.
Quarto passo: integrar com Telegram (a forma mais rápida de começar)
O Telegram é o canal de comunicação oficial mais completo suportado pelo OpenClaw, e a configuração é também a mais simples: basta um único Bot Token.
4-1 Pedir um Bot Token ao BotFather
Abre o Telegram, procura e abre @BotFather (confirma que o ícone azul ao lado indica que é oficial)
Envia /newbot
Segue as instruções para introduzires o nome do Bot (nome a mostrar) e a conta do Bot (tem de terminar em bot, por exemplo my_ai_assistant_bot)
O BotFather vai dar-te um Token, com um formato como 123456789:AAGxxxxxxxxxxxxxxxxx; copia-o
4-2 Configurar o Token
Edita o ficheiro de configuração do OpenClaw (caminho predefinido
~/.openclaw/config.json5
) e adiciona a configuração do Telegram:
{ channels: { telegram: { enabled: true, botToken: “Cole aqui o teu Token”, dmPolicy: “pairing”, }, }, }
4-3 Reiniciar o Gateway e emparelhar
openclaw gateway restart openclaw pairing list telegram
Em seguida, no Telegram, procura o Bot que acabaste de criar e envia-lhe qualquer mensagem; receberás um código de emparelhamento. Executa:
openclaw pairing approve telegram <código de emparelhamento>
Depois de concluído, envia uma mensagem no Telegram para o teu Bot e receberás a resposta do assistente de IA.
Perguntas frequentes (FAQ)
O que fazer se houver erro na versão do Node?
Executa
node -v
para confirmares a versão. Se for inferior a v22.14, reinstala o Node.js de acordo com a tabela acima. Se estiveres a usar macOS e tiveres Homebrew instalado, executa brew upgrade node para atualizares.
O Gateway não consegue iniciar?
Executa
openclaw gateway status
para veres a mensagem de erro. A causa mais comum é a porta 18789 estar ocupada, ou o formato do API Key estar incorreto. Podes executar openclaw configure para voltares a configurar.
Como mudar o API Key?
Executa
openclaw configure
, e no passo Model/Auth volta a configurar.
O Token vai ficar a ser queimado continuamente?
Por predefinição, o OpenClaw só chama a API quando recebe uma mensagem; não consome Token sem motivo. Mas se ativares algumas Skills automáticas ou tarefas agendadas, recomenda-se configurar, na área de administração do fornecedor do modelo, um limite máximo mensal de consumo, para evitar despesas acidentais.
O que fazer a seguir
Integrar Gmail e Google Calendar, para que o assistente te ajude a gerir e-mails e compromissos
Instalar Skills para expandir as capacidades do assistente (pesquisa na web, execução de código, gestão de memória, etc.)
Deploy na cloud: manter o caranguejo-do-mar online 24 horas através do Cloudflare Tunnel (tutorial avançado, a ser lançado brevemente)
Este artigo, guia completo de instalação do OpenClaw (caranguejo-do-mar IA) 2026: montar um assistente privado de IA do zero e integrá-lo com Telegram, apareceu pela primeira vez em Cadeia de Notícias ABMedia.
