Fatos verificados em 29 de setembro de 2026
Edição: Português
AgentDots
O almanaque dos agentes pessoais de IA
  1. Página inicial
  2. Configuração
  3. OpenClaw
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 <bot-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 <CODE>

  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.