Home Assistant + IA: Guia Completo para Assistente Inteligente em Casa

O Home Assistant é a plataforma de automação residencial open source mais popular do mundo. Quando combinado com assistentes de IA como Claude ou GPT-4, sua casa inteligente ganha um novo nível de inteligência. Este guia mostra todas as opções disponíveis.

Por Que Integrar IA ao Home Assistant?

Assistentes de IA transformam a interação com sua casa:

Exemplo prático:

• Sem IA: “Ligar luz da sala”
• Com IA: “Deixa a sala aconchegante para assistir filme”

Opções de Integração

1. Integrações Nativas (Cloud)

O Home Assistant oferece integrações oficiais para os principais provedores:

Anthropic (Claude)

# configuration.yaml
conversation:
  - platform: anthropic
    api_key: !secret anthropic_api_key
    model: claude-sonnet-4-20250514

OpenAI (GPT-4)

conversation:
  - platform: openai_conversation
    api_key: !secret openai_api_key
    model: gpt-4-turbo

Google Generative AI (Gemini)

conversation:
  - platform: google_generative_ai_conversation
    api_key: !secret google_ai_key

Custos típicos:

• Claude: ~$3/1M tokens input, ~$15/1M output
• GPT-4 Turbo: ~$10/1M tokens input, ~$30/1M output
• Gemini Pro: ~$0.50/1M tokens

2. Modelos Locais com Ollama

Para máxima privacidade, use modelos locais:

conversation:
  - platform: ollama
    url: http://localhost:11434
    model: llama3.2

Modelos recomendados para Home Assistant:

• Llama 3.2 (3B): Leve, roda em qualquer hardware
• Mistral 7B: Bom equilíbrio qualidade/performance
• Qwen 2.5 (7B): Excelente para instruções

Requisitos de hardware:

3. MCP Server (Model Context Protocol)

A integração mais poderosa: expõe seu Home Assistant como servidor MCP para qualquer cliente compatível.

O que é MCP?

O Model Context Protocol é um padrão aberto que permite LLMs acessarem contexto externo. Com o MCP Server do Home Assistant, você pode:

• Controlar sua casa pelo Claude Desktop
• Usar Cursor IDE para gerenciar automações
• Conectar qualquer cliente MCP compatível

Configuração:

1. Vá em Configurações > Dispositivos e Serviços
2. Adicione a integração Model Context Protocol Server
3. Configure quais entidades expor

Exemplo com Claude Desktop:

1. Abra Claude Desktop e vá em Settings > Connectors
2. Adicione um Custom Connector:
   • URL: https://seu-home-assistant.duckdns.org/api/mcp
   • OAuth Client ID: https://claude.ai
3. Autorize o acesso no Home Assistant

Agora você pode pedir ao Claude:

• “Quais luzes estão acesas?”
• “Diminua a temperatura do ar para 22 graus”
• “Crie uma automação para apagar as luzes às 23h”

4. Extended OpenAI Conversation

Componente custom que estende as capacidades da integração oficial:

# Instalação via HACS
# Repositório: github.com/jekalmin/extended_openai_conversation

Recursos adicionais:

• Chamada de serviços do Home Assistant
• Criação de automações via chat
• Consulta a APIs externas
• Execução de scripts

5. Home-LLM (100% Local)

Solução completa para rodar IA localmente:

# Instalação
git clone https://github.com/acon96/home-llm
cd home-llm
# Siga o README para configuração

Vantagens:

• Zero dependência de cloud
• Privacidade total
• Sem custos recorrentes
• Funciona offline

Configuração do Assistente de Voz

Passo 1: Criar Personalidade

# Vá em Settings > Voice Assistants > Add Assistant
name: "Jarvis"
language: "pt-BR"
conversation_agent: "claude-3-sonnet"

Passo 2: Definir Instruções

Você é Jarvis, assistente de casa inteligente.
Responda de forma concisa e amigável.
Use português brasileiro.
Quando controlar dispositivos, confirme a ação.
Se não entender, peça esclarecimento.

Passo 3: Expor Entidades

Vá em Settings > Voice Assistants > Expose e selecione:

• Luzes
• Climatização
• Sensores importantes
• Fechaduras (com cuidado!)

Automações Inteligentes

Exemplo 1: Modo Cinema

automation:
  - alias: "Modo Cinema via IA"
    trigger:
      - platform: conversation
        command:
          - "modo cinema"
          - "vamos assistir filme"
          - "prepara pra filme"
    action:
      - service: scene.turn_on
        target:
          entity_id: scene.cinema

Exemplo 2: Perguntar ao Clima

automation:
  - alias: "Sugestão de roupa"
    trigger:
      - platform: conversation
        command:
          - "que roupa usar"
          - "como está o tempo"
    action:
      - service: openai_conversation.generate_response
        data:
          prompt: >
            Temperatura atual: {{ states('sensor.temperatura_externa') }}°C
            Previsão: {{ state_attr('weather.home', 'forecast')[0] }}
            Sugira uma roupa adequada.

OpenClaw + Home Assistant

O OpenClaw pode complementar o Home Assistant de várias formas:

Via MCP Tools: Configure o OpenClaw para usar ferramentas MCP que se conectam ao Home Assistant.

Via API REST:

# No OpenClaw, use web_fetch para chamar a API
curl -X POST https://seu-ha.duckdns.org/api/services/light/turn_on \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"entity_id": "light.sala"}'

Via Automações Bidirecionais:

• Home Assistant notifica OpenClaw sobre eventos
• OpenClaw responde com análises e sugestões

Segurança

Boas Práticas

1. Use HTTPS sempre

   http:
     ssl_certificate: /ssl/fullchain.pem
     ssl_key: /ssl/privkey.pem
   

2. Limite entidades expostas

   • Não exponha fechaduras por padrão
   • Revise permissões regularmente

3. Use tokens com escopo limitado

   • Crie tokens específicos para cada integração
   • Defina data de expiração

4. Monitore logs

   logger:
     default: info
     logs:
       homeassistant.components.conversation: debug
   

O Que Não Fazer

• Expor painel admin publicamente
• Usar tokens de longa duração sem necessidade
• Dar acesso total a modelos não confiáveis
• Ignorar atualizações de segurança

Comparativo de Abordagens

Próximos Passos

1. Iniciantes: Comece com a integração nativa do OpenAI ou Anthropic
2. Intermediários: Explore o MCP Server com Claude Desktop
3. Avançados: Configure Ollama + Home-LLM para privacidade total

Recursos

• Documentação oficial Home Assistant
• Integração Anthropic
• MCP Server
• Home-LLM no GitHub
• Model Context Protocol

Quer controlar sua casa de forma ainda mais inteligente? O OpenClaw pode ser seu hub central de IA, conectando Home Assistant, calendários, mensagens e muito mais.