Instalação do OpenClaw

Do zero ao seu primeiro agente de IA em 30 minutos

Este guia vai te levar do zero até um agente de IA funcionando no Telegram usando o OpenClaw.

---

🧩 PASSO 01 — Comprar uma VPS

Acesse: https://hostinger.com.br

Escolha:

• Plano VPS KVM
• Mínimo recomendado:
  • 4 vCPU
  • 8 GB RAM
• Sistema operacional: Ubuntu 22.04

📌 Após a compra:

• Aguarde a ativação
• Anote:
  • IP da VPS
  • Senha root (enviada por e-mail)

---

🔐 PASSO 02 — Acessar via SSH

No terminal:

ssh root@SEU-IP

💻 Sistemas:

• Windows: use PuTTY ou Windows Terminal
• Linux/Mac: terminal padrão

👉 Substitua SEU-IP pelo IP da sua VPS.

---

🔄 PASSO 03 — Atualizar o sistema

apt update && apt upgrade -y

✔ Isso garante que tudo esteja atualizado antes da instalação.

---

📦 PASSO 04 — Instalar dependências

apt install -y python3 python3-pip python3-venv git nodejs npm curl wget

📌 Instala:

• Python 3
• Node.js
• Git
• Ferramentas essenciais

---

🤖 PASSO 05 — Instalar o Claude Code

curl -fsSL https://claude.ai/install.sh | bash

👉 Depois:

• Faça login na sua conta Anthropic
• Siga as instruções na tela

---

📥 PASSO 06 — Clonar o OpenClaw

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pip3 install -r requirements.txt

✔ Isso baixa o projeto e instala as dependências Python.

---

📲 PASSO 07 — Criar bot no Telegram

Abra o Telegram e acesse o bot:

👉 Telegram

Procure por:

👉 BotFather

Execute:

/newbot

Depois:

• Escolha nome
• Escolha username
• Copie o TOKEN

⚠️ Guarde esse token — é a chave do seu bot.

---

⚙️ PASSO 08 — Configurar variáveis de ambiente

cp .env.example .env
nano .env

Configure:

TELEGRAM_BOT_TOKEN=SEU_TOKEN_AQUI
ANTHROPIC_API_KEY=SUA_API_KEY

💾 Salvar no nano:

Ctrl + O → Enter → Ctrl + X

---

▶️ PASSO 09 — Iniciar o agente

🔹 Modo simples (teste)

python3 main.py

---

🔹 Modo produção (recomendado)

npm install -g pm2
pm2 start main.py --interpreter python3 --name meu-agente
pm2 save
pm2 startup

✔ O PM2 mantém o bot sempre online (mesmo após reboot).

---

✅ PASSO 10 — Testar

• Abra o Telegram
• Envie mensagem para seu bot

🎉 Se respondeu: parabéns, seu agente está rodando!

---

🛠️ EXTRAS — Comandos úteis

# Ver logs em tempo real
pm2 logs meu-agente

# Reiniciar o agente
pm2 restart meu-agente

# Ver status
pm2 status

---

💡 Dicas importantes

• Sempre use VPS com boa RAM (IA consome bastante recurso)
• Proteja seu .env (não compartilhe tokens)
• Use pm2 para produção
• Configure firewall depois (UFW recomendado)