Como instalar OpenClaw e conectar Telegram
Cerca de trinta minutos do zero até ter um agente com quem você pode conversar no Telegram. Os comandos foram copiados da documentação oficial; confira se correspondem à sua versão.
O que você precisa
- Um computador ou VPS com macOS, Linux, WSL2 ou Windows
- Node 24.16+ ou Node 26 (o instalador pode adicioná-lo)
- Uma chave de API ou assinatura de um modelo, ou um modelo local
- Uma conta do Telegram
Etapas
- 1
Escolha onde ele será executado
Seu próprio laptop é suficiente para testá-lo. Para um agente sempre ativo, use um VPS pequeno ou um servidor doméstico. Não exponha a porta do gateway à internet.
- 2
Instale o OpenClaw
Execute o instalador oficial. Ele detecta seu sistema operacional, instala o Node se necessário, 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
- 3
Execute a configuração inicial e instale o serviço
Escolha Quick start para reutilizar o acesso à IA detectado ou Custom setup para seguir o fluxo completo. Depois, instale o gateway como serviço em segundo plano para que ele continue funcionando após reinicializações.
openclaw onboard # after quick start, stop the foreground gateway (Ctrl+C) and install the service openclaw gateway install
- 4
Crie um bot do Telegram e adicione-o
No Telegram, envie uma mensagem para @BotFather (confira se o identificador está correto), execute /newbot e copie o token. Adicione-o ao OpenClaw e confira o status do canal.
openclaw channels add --channel telegram --token <bot-token> openclaw channels status --probe
- 5
Aprove sua própria conta
Envie qualquer mensagem ao seu bot. Remetentes desconhecidos recebem um código de pareamento em vez de uma resposta; aprove sua conta em até uma hora.
openclaw pairing list telegram openclaw pairing approve telegram <CODE>
- 6
Reforce a segurança
Execute a auditoria de segurança integrada e mantenha o gateway atualizado. Versões anteriores à 2026.4.22 têm falhas críticas conhecidas.
openclaw security audit openclaw update --channel stable
Dicas de quem já usou
- Mantenha gateway.bind em loopback e acesse-o por SSH ou Tailscale, nunca por uma porta aberta.
- Mantenha dmPolicy em pairing para que desconhecidos que encontrem seu bot não possam usá-lo.
- Trate skills de terceiros como extensões de navegador: instale poucas e somente de fontes confiáveis.
- Configure as aprovações de exec para sempre pedir confirmação até que você confie na sua configuração.