🦞 OpenClaw Trader Pro
Forex · Por Dan Machado · 2026

Setup da Ponte HTTP MT5 + OpenClaw (Tutorial Completo)

Setup completo da ponte HTTP MT5 + OpenClaw pra automação forex. Passo a passo testado.

OpenClaw não fala MT5 nativamente — MT5 usa MQL5, protocolo proprietário. Pra conectar, usa-se uma ponte HTTP: um Expert Advisor (EA) no MT5 abre endpoint REST local que o OpenClaw chama. Este guia cobre o setup completo.

Arquitetura

┌──────────────┐         ┌──────────────┐         ┌────────────┐
│  OpenClaw    │  HTTP   │   MT5 + EA   │  MQL5   │   Broker   │
│  (VPS Linux) │────────▶│ (VPS Windows)│────────▶│   (Exness, │
│              │         │              │         │   ICMarkets│
└──────────────┘         └──────────────┘         └────────────┘

Dois VPSs (ou mesmo VPS com Wine no Linux): Linux pro OpenClaw, Windows pro MT5 (MT5 oficialmente roda em Windows).

Pré-requisitos

  • Conta em broker MT5 (Exness, IC Markets, etc.)
  • MT5 instalado e logado num VPS Windows (ou Wine no Linux)
  • OpenClaw instalado em VPS Linux
  • Expert Advisor (EA) que expõe HTTP endpoint

Passo 1 — Escolher VPS pra MT5

MT5 precisa rodar continuamente. Opções:

  • Windows VPS dedicado (Contabo, OVH): US$ 8-15/mês. Mais simples.
  • VPS oferecido pelo broker: Exness, IC Markets oferecem free VPS se você tiver depósito mínimo. Boa latência.
  • Wine no Linux: tecnicamente possível mas com bugs ocasionais. Não recomendado.

Pra simplicidade, opte por broker VPS se você tem volume pra qualificar (geralmente US$ 1000+ depósito).

Passo 2 — Instalar Expert Advisor HTTP

Várias opções de EA HTTP open-source disponíveis. O padrão usado pelo nosso guia:

  1. Baixe o EA de openclaw-community/mt5-http-bridge (exemplo — verifique repo atual)
  2. Copie OpenClaw_Bridge.ex5 pra MQL5/Experts/ do MT5
  3. Reabra MT5, arraste o EA pra um gráfico (qualquer par)
  4. Configure as propriedades:
    • Port: 8080 (ou outra)
    • Auth token: gere string aleatória forte
    • Allowed IPs: IP do VPS OpenClaw
  5. Habilite "Allow live trading" e "Allow DLL imports" nas configs do MT5

Passo 3 — Permitir tráfego no firewall do Windows VPS

No Windows VPS, abrir porta 8080 só pro IP do OpenClaw VPS:

# PowerShell como Admin
New-NetFirewallRule -DisplayName "OpenClaw Bridge" `
  -Direction Inbound -Protocol TCP -LocalPort 8080 `
  -RemoteAddress IP_DO_OPENCLAW_VPS `
  -Action Allow

Passo 4 — Configurar OpenClaw skill

openclaw skill install @openclaw/skill-mt5-bridge

Config:

# ~/.openclaw/config.yml
mt5_bridge:
  url: "http://IP_DO_VPS_WINDOWS:8080"
  auth_token: "${MT5_BRIDGE_TOKEN}"
  timeout_ms: 5000

Passo 5 — Testar a conexão

No OpenClaw, faça um get_account_info:

openclaw chat "verifique o saldo da minha conta MT5"

Esperado: retorno com saldo, equity, margin. Se erro:

  • Connection refused: firewall bloqueando ou EA não rodando
  • Auth failed: token errado
  • Timeout: latência alta entre VPSs — considere colocá-los na mesma região

Passo 6 — Primeiro trade de teste

Em conta demo (configurável no broker), envie ordem mínima:

openclaw chat "abra long de 0.01 lot em EUR/USD com SL 50 pips e TP 100 pips"

Verifique no MT5:

  • Ordem aparece no Trade tab
  • Valores corretos (lot, SL, TP)
  • Logs do OpenClaw mostram sucesso

Segurança crítica

  1. Auth token forte: mínimo 32 caracteres alfanuméricos
  2. IP whitelist no EA: só aceita do IP do OpenClaw VPS
  3. HTTPS se possível: use reverse proxy (Caddy, nginx) pra TLS
  4. Logs detalhados: bridge deve logar toda request
  5. Rate limit no EA: max X requests por minuto, pra prevenir bug

Latência típica

End-to-end OpenClaw → trade no broker:

  • OpenClaw decisão: 1-3s (LLM call)
  • HTTP request a MT5: 50-200ms
  • MT5 → broker: 50-300ms (depende do broker)
  • Total: 1.5-3.5s

Não é HFT. Pra estratégias com horizonte de minutos+ é OK. Pra scalping ms — esquece.

Troubleshooting comum

  • "Trade is disabled": habilite Algorithmic Trading no MT5 (Tools → Options → Expert Advisors)
  • "Insufficient margin": conta sem margem — deposite ou reduza lot
  • "Market closed": verifique horário de funcionamento do par (forex tem janela 24/5)
  • "Invalid stops": SL/TP muito perto do preço atual — broker tem min distance
  • EA crashed: MT5 logs em Toolbox → Experts. Reinicie.

Alternativas à ponte HTTP

  • cTrader Open API: alguns brokers oferecem cTrader que tem API REST nativa, mais simples
  • MT5 Python API (oficial): permite Python falar com MT5 diretamente, sem HTTP. Útil em alguns setups.
  • cAlgo: plataforma própria pra automatização que substitui MT5/MQL5 inteiramente

Próximas leituras

Setup feito, próximo é estratégia. Mas lembre: setup técnico ≠ lucratividade. 🦞