OpenClaw + Home Assistant: Integração Completa com Voz
Um usuário do Reddit postou recentemente sobre sua integração OpenClaw + Home Assistant. O resultado? Resolver em 5 minutos o que levaria 1 hora na UI.
Este guia mostra como replicar essa configuração.
O Que Você Consegue Fazer
Com OpenClaw conectado ao Home Assistant:
- “Investiga por que a luz da sala não está funcionando”
- “Cria uma automação para apagar tudo às 23h”
- “Quando detectar movimento na entrada, ligue a luz em 20%”
- “Liste todas as entidades com erro”
A IA entende o contexto, acessa o Home Assistant, e executa.
Exemplo Real
Do post original no Reddit:
“Minhas luzes de movimento estavam quebradas há 2 dias. Pedi para a IA investigar. Ela encontrou duas lâmpadas Hue mortas causando erros, deletou a automação quebrada, e criou uma nova com:
- Modo noturno (17h-7h): 1% brilho, 2000K
- Modo dia: 100% brilho
- Bypass durante modo soneca do bebê
- Sem triggers nos fins de semana 10-11h e 14-15h”
5 minutos de digitação vs 1 hora na interface.
Arquitetura
[Você] → [Telegram] → [OpenClaw] → [ha-mcp] → [Home Assistant]
↓
[ElevenLabs] → [Google Home]
Componentes:
- OpenClaw: Processa suas mensagens com Claude
- ha-mcp: Servidor MCP que conecta ao Home Assistant
- ElevenLabs: Converte respostas em voz (opcional)
- Google Home/Alexa: Reproduz áudio (opcional)
Passo 1: Instalar ha-mcp
O ha-mcp é um servidor MCP oficial para Home Assistant.
npm install -g ha-mcp
Passo 2: Configurar Token do Home Assistant
- No Home Assistant, vá em Perfil > Tokens de acesso
- Crie um token de longa duração
- Copie o token
Passo 3: Configurar OpenClaw
Edite ~/clawd/config.yaml:
mcp:
servers:
homeassistant:
command: ha-mcp
args:
- "--url"
- "http://192.168.1.100:8123" # IP do seu HA
- "--token"
- "SEU_TOKEN_AQUI"
Ou use variáveis de ambiente:
mcp:
servers:
homeassistant:
command: ha-mcp
env:
HASS_URL: "http://192.168.1.100:8123"
HASS_TOKEN: "${HASS_TOKEN}"
Passo 4: Reiniciar OpenClaw
openclaw gateway restart
Passo 5: Testar
Envie pelo Telegram/WhatsApp:
Liste todas as luzes da casa
Se funcionar, você verá a lista de entidades light.*.
Comandos Úteis
Diagnóstico
"Quais entidades estão com estado 'unavailable'?"
"Mostre o histórico da temperatura do quarto nas últimas 24h"
"Quais automações estão desabilitadas?"
Controle
"Liga a luz da sala em 50%"
"Ajusta o termostato para 22 graus"
"Ativa o modo cinema" (se você tiver uma cena configurada)
Automações
"Cria uma automação: quando a porta abrir depois das 18h, liga a luz de entrada por 5 minutos"
"Desabilita a automação de movimento da cozinha"
"Lista as automações que usam o sensor de presença"
Adicionando Voz (Opcional)
Para o OpenClaw falar pelas caixas de som:
1. Configurar ElevenLabs
# config.yaml
tts:
provider: elevenlabs
apiKey: "${ELEVENLABS_API_KEY}"
voice: "Rachel" # ou outra voz
2. Configurar Saída de Áudio
Para Google Home/Alexa via Home Assistant:
# SOUL.md ou config
Quando responder comandos de casa, reproduza a resposta no media_player.sala usando o serviço tts.speak.
3. Testar
"Qual a temperatura da casa?" (resposta falada pelo Google Home)
Segurança (Importante)
Sandboxing Recomendado
O autor do post original roda em container LXC isolado. Isso é prudente.
# Se usar Docker
docker run -d \
--name openclaw \
--network host \
-v ~/clawd:/app/clawd \
openclaw/openclaw:latest
Limitar Ações
No SOUL.md:
## Regras para Home Assistant
- Nunca desabilite alarmes ou câmeras sem confirmação
- Sempre confirme antes de deletar automações
- Não exponha tokens ou senhas
- Limites de temperatura: mínimo 18°C, máximo 26°C
Usuário Restrito no HA
Crie um usuário específico no Home Assistant com permissões limitadas:
- Apenas as áreas que o OpenClaw deve controlar
- Sem acesso a configurações do sistema
Custos
A integração com Home Assistant aumenta uso de tokens porque:
- Queries ao HA enviam contexto (entidades, estados)
- Automações complexas precisam de raciocínio
Estimativa para uso moderado:
- 10-20 comandos/dia → ~$3-5/mês adicional
Dica: Use Claude Haiku para comandos simples, Sonnet para automações complexas.
Troubleshooting
“Não consigo conectar ao Home Assistant”
- Verifique se a URL está acessível do servidor OpenClaw
- Confirme que o token está correto
- Veja os logs:
openclaw gateway logs -f
“Entidade não encontrada”
O OpenClaw usa entity_id exato. Peça:
"Liste todas as luzes"
E use o nome exato retornado.
“Automação não funciona”
- Verifique se o usuário do token tem permissão
- Confira no HA se a automação foi criada
- Veja os logs do HA: Developer Tools > Logs
Conclusão
OpenClaw + Home Assistant transforma sua casa inteligente em algo genuinamente inteligente. Em vez de decorar interfaces, você conversa.
A curva de aprendizado é baixa: se você já usa Home Assistant, adicionar OpenClaw leva 30 minutos.
Quer ver mais integrações? Confira: