--- title: "Como instalar o OpenClaw: guia de configuração com Telegram · AgentDots" description: "Instale o OpenClaw em um computador ou servidor pequeno sob seu controle, conclua a configuração inicial, adicione um bot do Telegram, aprove o pareamento, execute a auditoria de segurança e escreva regras permanentes." url: https://agentdots.org/pt/setup/openclaw/ lang: pt-BR --- Configuração · cerca de 30 minutos # Como instalar o OpenClaw: guia de configuração com Telegram Reserve cerca de meia hora para transformar uma máquina recém-configurada em um agente auto-hospedado que responde no Telegram e segue regras escritas por você. ## Passo a passo 1. Escolha onde ele vai funcionar Um laptop serve para testar o OpenClaw, mas um agente que você quer manter acessível a qualquer hora funciona melhor em um equipamento sempre ligado, como um servidor doméstico ou um VPS alugado, já que ele só pode responder enquanto a máquina estiver funcionando. Seja qual for sua escolha, a porta do gateway nunca deve ficar exposta à internet pública. 2. Instale o OpenClaw Use o instalador oficial correspondente ao seu sistema. Ele detecta o sistema operacional, instala o Node se estiver faltando, configura 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. Faça a configuração inicial e execute o gateway como serviço A configuração inicial oferece a opção Quick start, que reutiliza qualquer acesso a IA disponível, ou Custom setup, que mostra todas as opções. Quando terminar, encerre o gateway em primeiro plano e registre-o como serviço em segundo plano. Assim, ele volta a funcionar automaticamente após uma reinicialização. openclaw onboard # stop the foreground gateway with Ctrl+C, then run it as a service: openclaw gateway install 4. Conecte o Telegram No Telegram, abra uma conversa com @BotFather, confira atentamente o nome de usuário, envie /newbot e guarde o token fornecido. Cadastre o Telegram como canal usando esse token e execute uma verificação de status para conferir a conexão. openclaw channels add --channel telegram --token openclaw channels status --probe 5. Aprove o pareamento Envie uma mensagem ao seu bot. Em vez de responder, ele fornece um código de pareamento a remetentes desconhecidos. Procure as solicitações pendentes e aprove a sua antes de uma hora. openclaw pairing list telegram openclaw pairing approve telegram 6. Execute a auditoria de segurança e mantenha tudo atualizado Peça à própria auditoria de segurança do OpenClaw para verificar a configuração e resolva tudo o que ela apontar. Depois, instale as atualizações do canal estável. Qualquer versão lançada antes de 2026.4.22 está exposta a vulnerabilidades críticas conhecidas, então inclua os dois comandos na sua rotina. openclaw security audit openclaw update --channel stable 7. Escreva as regras permanentes Descreva suas regras em linguagem simples no arquivo AGENTS.md, no espaço de trabalho do agente, e defina limites rígidos correspondentes em ~/.openclaw/openclaw.json. Confira os nomes das chaves na documentação da sua versão. Mantenha dmPolicy em pairing e configure as aprovações de exec para perguntar sempre, até ter confiança na configuração. ## A primeira semana Trate a primeira semana como um período de teste. O gateway deve permanecer em loopback, com acesso por Tailscale ou SSH, não por uma porta exposta. Mantenha os comandos de shell sujeitos a aprovação, adicione habilidades de terceiros com moderação e apenas de publicadores conhecidos, e acompanhe diariamente o uso do modelo: um agente preso em um loop continua gastando tokens. Execute novamente a auditoria de segurança após cada alteração na configuração. ## Erros a evitar - Expor o gateway à internet em vez de manter gateway.bind definido como loopback. - Instalar uma série de habilidades de terceiros, que merecem a mesma desconfiança que extensões de navegador. - Usar uma versão desatualizada: todas as versões anteriores a 2026.4.22 têm vulnerabilidades críticas conhecidas. **OpenClaw** OpenClaw Foundation ## Antes de começar - Um computador ou servidor pequeno com Windows, macOS, Linux ou WSL2 - Node 24.16 ou mais recente, ou Node 26; se nenhum estiver instalado, o instalador pode adicionar um deles - Acesso a um modelo: uma chave de API, uma assinatura que você já paga ou um modelo local - Uma conta do Telegram para o canal de conversa ### Em seguida, defina regras Todo agente funciona melhor com limites por escrito. Crie uma lista de regras em dois minutos. [Regras →](https://agentdots.org/pt/rules/?for=openclaw) ## Configuração - [Dots](https://agentdots.org/pt/setup/dots/) - [Muse](https://agentdots.org/pt/setup/muse/) - [Gemini Spark](https://agentdots.org/pt/setup/gemini-spark/) - [Claude](https://agentdots.org/pt/setup/claude/)