---
title: "OpenClaw + Home Assistant: Integração Completa com Voz"
url: "https://openclaw.ia.br/blog/openclaw-home-assistant-integracao-completa/"
markdown_url: "https://openclaw.ia.br/blog/openclaw-home-assistant-integracao-completa.MD"
description: "Como integrar OpenClaw com Home Assistant para automação residencial inteligente. Controle por voz, memória persistente, e exemplos reais de uso."
date: "2026-01-31"
author: ""
---

# OpenClaw + Home Assistant: Integração Completa com Voz

Como integrar OpenClaw com Home Assistant para automação residencial inteligente. Controle por voz, memória persistente, e exemplos reais de uso.


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](https://github.com/voska/ha-mcp) é um servidor MCP oficial para Home Assistant.

```bash
npm install -g ha-mcp
```

## Passo 2: Configurar Token do Home Assistant

1. No Home Assistant, vá em Perfil > Tokens de acesso
2. Crie um token de longa duração
3. Copie o token

## Passo 3: Configurar OpenClaw

Edite `~/clawd/config.yaml`:

```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:

```yaml
mcp:
  servers:
    homeassistant:
      command: ha-mcp
      env:
        HASS_URL: "http://192.168.1.100:8123"
        HASS_TOKEN: "${HASS_TOKEN}"
```

## Passo 4: Reiniciar OpenClaw

```bash
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

```yaml
# 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:

```yaml
# 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.

```bash
# Se usar Docker
docker run -d \
  --name openclaw \
  --network host \
  -v ~/clawd:/app/clawd \
  openclaw/openclaw:latest
```

### Limitar Ações

No SOUL.md:

```markdown
## 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"

1. Verifique se a URL está acessível do servidor OpenClaw
2. Confirme que o token está correto
3. 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"

1. Verifique se o usuário do token tem permissão
2. Confira no HA se a automação foi criada
3. 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:
- [Integração com Gmail](/integracoes/gmail/)
- [Integração com Google Calendar](/integracoes/google-calendar/)
- [Todas as integrações](/integracoes/)