Como instalar o OpenClaw e conectar o Telegram
Reserve cerca de meia hora para ir de uma máquina recém-configurada a um agente que responde você no Telegram. Os comandos mostrados vêm da documentação oficial, então compare-os com a versão que você instalar.
O que você precisa
- Um computador ou VPS com macOS, Linux, WSL2 ou Windows
- Node 24.16+ ou Node 26, que o instalador pode adicionar para você
- Uma chave de API ou assinatura de um modelo, ou um modelo local
- Uma conta do Telegram
Passo a passo
-
Escolha uma máquina e crie um bot
Um notebook serve para testar, mas um agente que fica sempre ligado deve rodar em um VPS pequeno ou em um servidor doméstico, e a porta do gateway nunca deve ficar aberta para a internet. No Telegram, envie uma mensagem para @BotFather depois de conferir cuidadosamente o nome de usuário, execute /newbot e copie o token fornecido.
-
Instalar o OpenClaw
Execute o instalador oficial para o seu sistema. Ele detecta o sistema operacional, adiciona o Node se estiver faltando, instala o OpenClaw e inicia a configuração inicial.
# macOS / Linux / WSL2 curl -fsSL https://openclaw.ai/install.sh | bash # Windows (PowerShell) iwr -useb https://openclaw.ai/install.ps1 | iex
-
Concluir a configuração inicial e instalar o serviço do gateway
Escolha Quick start para reutilizar o acesso à IA detectado ou Custom setup para configurar todas as opções. Quando a configuração inicial terminar, pare o gateway em execução no primeiro plano e instale-o como serviço em segundo plano para que ele reinicie após uma reinicialização.
openclaw onboard # after the quick start, stop the foreground gateway (Ctrl+C), then: openclaw gateway install
-
Adicionar o canal do Telegram
Adicione o Telegram como canal usando o token do seu bot. Depois, verifique o status do canal para confirmar que a conexão está funcionando.
openclaw channels add --channel telegram --token <bot-token> openclaw channels status --probe
-
Aprove seu pareamento
Envie qualquer mensagem para o seu bot. Remetentes desconhecidos recebem um código de pareamento em vez de uma resposta. Liste as solicitações pendentes e aprove o seu código em até uma hora.
openclaw pairing list telegram openclaw pairing approve telegram <CODE>
-
Faça uma auditoria e atualize
Execute a auditoria de segurança integrada e atualize pelo canal estável. Versões anteriores à 2026.4.22 têm vulnerabilidades críticas conhecidas, então não continue usando uma delas.
openclaw security audit openclaw update --channel stable
Primeiras coisas a fazer após a configuração
- Mantenha dmPolicy em pairing para impedir que desconhecidos que encontrem seu bot o utilizem.
- Configure as aprovações de exec para sempre pedir confirmação até confiar na sua configuração.
- Repita regularmente a auditoria de segurança e a atualização.
Erros comuns
- Expor a porta do gateway em vez de manter gateway.bind no loopback e se conectar por SSH ou Tailscale.
- Instalar muitas skills de terceiros. Trate-as como extensões de navegador e adicione apenas algumas, de fontes em que você confia.
- Esquecer que um agente preso em um loop continua consumindo tokens do modelo.