Instalar OpenClaw no Umbrel: Assistente de IA 24/7 no Servidor Doméstico

Q: Posso usar o Ollama da Umbrel Store junto com uma API paga?

Sim. O config.yaml aceita provedores múltiplos, e você define o default. Uma prática comum é deixar o Ollama como padrão para tarefas simples e trocar para Claude ou GPT quando a tarefa exige mais qualidade — a troca acontece no arquivo de configuração, sem reinstalar nada.

Guia em português para instalar o OpenClaw no Umbrel com Docker e Ollama: assistente de IA rodando 24/7 em casa, sem pagar nuvem, com WhatsApp e Telegram conectados.

Sim, dá para rodar o OpenClaw no Umbrel. O caminho confiável é via Docker — o mesmo container oficial openclaw/openclaw usado na instalação com Docker — executado no terminal SSH do seu Umbrel, com o app Ollama da Umbrel Store como modelo de IA local. O resultado: um assistente que responde no WhatsApp e no Telegram 24 horas por dia, dentro da sua rede, sem mensalidade de nuvem e sem vazar dados para fora de casa.

O caminho não é um app oficial na Umbrel Store (não existe um na data deste guia), e sim o container manual ou um docker-compose.yml próprio. Este guia mostra o passo a passo completo: quando o Umbrel vale a pena, o que você precisa, a instalação em si, a conexão com o Ollama e os cuidados de segurança de expor um agente de IA na sua rede.

Resposta rápida: Umbrel vale a pena para o OpenClaw?

Situação	Vale a pena?	Por quê
Quer o assistente 24/7 sem pagar VPS	Sim	Raspberry Pi ou mini PC consome pouca energia; custo fixo de hardware, zero mensalidade
Privacidade é prioridade (dados em casa)	Sim	Mensagens, workspace e modelo local nunca saem da sua rede
Já tem Umbrel com Ollama rodando	Sim	Reaproveita o Ollama como provedor de IA; só falta o container do OpenClaw
Só quer testar rapidamente	Não	Instalar no PC com `npm` leva 5 minutos e é mais simples
Precisa de acesso externo para um time	Depende	Via Tailscale sim; expor porta pública, não (veja a seção de segurança)

Regra prática: o Umbrel resolve o problema do “meu assistente morre quando o PC desliga” sem criar o problema do “minha fatura de nuvem cresce todo mês”. Se esse é o seu caso, continue lendo.

Por que rodar o OpenClaw em um servidor doméstico

O OpenClaw é um assistente que funciona conectado a canais como WhatsApp e Telegram. Para responder a qualquer hora, o gateway precisa estar sempre de pé — daí a escolha clássica entre três hospedagens:

Hospedagem	Custo recorrente	Privacidade	Esforço
PC pessoal (local)	Só a API de IA	Máxima	Baixo, mas desliga com o PC
VPS em nuvem	R$ 30–80+/mês	Média	Médio
Servidor doméstico com Umbrel	~R$ 5–10/mês de energia	Máxima	Médio

O Umbrel é um sistema operacional de servidor doméstico baseado em Docker. Ele roda em Raspberry Pi, mini PCs e NAS, e oferece uma loja de apps com instalação em um clique para Bitcoin, Jellyfin, Home Assistant, Pi-hole e — importante para este guia — Ollama, o servidor de modelos locais.

O ponto de virada para o OpenClaw: com o app Ollama do Umbrel e o container do OpenClaw apontando para ele, você monta um assistente que responde no WhatsApp sem pagar nenhuma API externa e sem enviar o conteúdo das conversas para nuvem nenhuma. É a combinação que busca em português como “openclaw umbrel ollama”.

O que você precisa antes de começar

Umbrel instalado e acessível — no navegador via http://umbrel.local (ou o IP do servidor). Se ainda não tem, o instalador do site do Umbrel prepara Raspberry Pi ou mini PC em poucos minutos.
Acesso SSH ao Umbrel — necessário porque não há app oficial do OpenClaw na loja. No painel: Settings → Advanced → SSH, ou ssh [email protected].
2 GB de RAM livres para o container do OpenClaw (mais o que o Ollama consumir — veja abaixo).
1–2 GB de disco para o workspace ~/clawd e logs.
Uma chave de API de IA (Claude, GPT…) ou o app Ollama para rodar modelos locais como llama3.1 ou qwen2.5.
Um canal de mensagens — bot do Telegram via BotFather (mais fácil em servidor) ou número dedicado para WhatsApp.

Dica de hardware: para o OpenClaw com API em nuvem, um Raspberry Pi 4 com 4 GB já sobra. Para rodar Ollama com modelos de 7B localmente, o Raspberry Pi 5 fica no limite — o ideal é um mini PC com 16 GB de RAM. Só o OpenClaw + API de nuvem: qualquer hardware serve.

Passo a passo: instalar o OpenClaw no Umbrel

1. Instale o Ollama pela Umbrel Store (opcional, mas recomendado)

No painel do Umbrel, abra a App Store, procure Ollama e clique em instalar. Em seguida, pelo terminal SSH, baixe um modelo:

docker exec -it ollama ollama pull llama3.1:8b

Se você vai usar uma chave de API (Claude ou GPT), pode pular esta etapa — o OpenClaw funciona perfeitamente chamando a API em nuvem.

2. Crie a estrutura de arquivos

Ainda no SSH:

mkdir -p ~/apps/openclaw/clawd
cd ~/apps/openclaw

3. Crie o config.yaml

Crie o arquivo config.yaml na pasta ~/apps/openclaw. Exemplo mínimo com Ollama local:

provider:
  default: ollama
  ollama:
    baseUrl: "http://umbrel.local:11434"
    model: "llama3.1:8b"

channels:
  telegram:
    enabled: true
    token: "seu-token-do-botfather"

gateway:
  timezone: "America/Sao_Paulo"

Para usar API em nuvem em vez de Ollama, troque o bloco provider:

provider:
  default: anthropic
  anthropic:
    apiKey: "sua-chave-api"

4. Suba o container com Docker Compose

Crie o docker-compose.yml — a mesma estrutura do guia oficial de Docker, adaptada ao Umbrel:

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    volumes:
      - ./clawd:/app/workspace
      - ./config.yaml:/app/config.yaml:ro
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - TZ=America/Sao_Paulo
    healthcheck:
      test: ["CMD", "openclaw", "gateway", "status"]
      interval: 30s
      timeout: 10s
      retries: 3

Inicie e acompanhe os logs:

docker compose up -d
docker compose logs -f

O restart: unless-stopped garante que o OpenClaw volte sozinho depois de quedas de energia e reinícios do Umbrel — essencial para um servidor doméstico.

5. Rode o wizard inicial

docker exec -it openclaw openclaw onboard

O wizard configura gateway, workspace e modelo. Para conectar o WhatsApp em um servidor sem tela, acesse a interface web do gateway em http://umbrel.local:3000 de qualquer navegador da rede e escaneie o QR code pelo celular — o mesmo fluxo do guia de instalação geral. Para o Telegram, basta o token do BotFather já configurado no passo 3.

6. Teste

Envie um “oi” para o número do WhatsApp ou para o bot do Telegram. Se a resposta chegar, seu assistente 24/7 em casa está no ar.

Conectar o WhatsApp e o Telegram em modo headless

O detalhe mais comum em servidores domésticos é a conexão de canais sem interface gráfica:

Telegram é o mais simples — o token do bot é tudo o que existe; crie o bot com o @BotFather e coloque no config.yaml antes de subir o container.
WhatsApp usa QR code — escaneie pela interface web do gateway (http://umbrel.local:3000) a partir de qualquer aparelho na mesma rede. Depois de conectado, a sessão fica persistida no volume ./clawd e sobrevive a reinícios.
Sessão caiu? Reconecte pela mesma interface web. Se o problema for frequente, veja o guia WhatsApp desconecta — as causas (versão, hibernação, sessão duplicada) são as mesmas no Umbrel.

No dia a dia, você conversa com o assistente pelo celular normalmente — o uso pelo WhatsApp não muda em nada porque o gateway está em um Raspberry Pi atrás do sofá em vez de um datacenter.

Segurança: o que fazer (e não fazer) ao expor um agente em casa

Um agente de IA com acesso a arquivos e comandos exige mais cuidado quando roda 24/7. Checklist:

Não abra porta do Umbrel na internet (sem port forwarding do roteador para a porta 3000). O WhatsApp e o Telegram funcionam como conexões de saída — você não precisa de porta aberta para nada.
Use Tailscale para acesso externo — o app Tailscale existe na Umbrel Store e cria uma rede privada entre seus dispositivos. É o caminho certo para acessar o painel fora de casa.
Segredos só no config.yaml com permissão restrita (chmod 600 config.yaml), nunca em comando público ou em screenshot.
Atualize com frequência — docker compose pull && docker compose up -d para receber correções do OpenClaw.
Princípio do menor privilégio — o workspace do container é a pasta ./clawd; não monte volumes da sua inteira home nele. Para as camadas de governança do agente (o que ele pode ou não fazer), veja segurança do OpenClaw.

Problemas comuns e soluções

Sintoma	Causa provável	Correção
Container reinicia em loop	`config.yaml` inválido	`docker compose logs -f` para ver o erro de YAML; valide indentação
Respostas demoram muito ou falham	Ollama sobrecarregado	Use modelo menor (`llama3.1` em vez de `8b`) ou troque por API de nuvem
`connection refused` no Ollama	Nome de host errado	Confirme `http://umbrel.local:11434`; teste no navegador da rede
Ollama não executa ferramentas	Modelo local sem suporte a tool calling	Veja o guia de Ollama e ferramentas
WhatsApp cai depois de horas	Sessão/hardware	Guia WhatsApp desconecta
Sem resposta após queda de energia	Container não voltou	`docker compose up -d`; confirme `restart: unless-stopped`

Umbrel vs. as outras formas de rodar o OpenClaw

Já cobrimos as demais rotas em profundidade — o Umbrel é mais um caminho, não uma substituição:

Instalação no PC (npm) — a porta de entrada de 5 minutos; comece por aqui antes de migrar para servidor.
Docker geral — mesmo container; o Umbrel só adiciona a camada de gerenciamento de servidor doméstico.
Nuvem/VPS — quando o time precisa de acesso compartilhado ou a casa não tem energia/ internet estáveis.
Uso pelo celular — a mesma recomendação daquele guia vale aqui: gateway sempre ligado no servidor, consumo pelo WhatsApp/Telegram.

Se depois de instalado você quiser extrair mais do assistente, o guia de uso como agente de IA mostra como transformar o canal conectado em rotinas reais de trabalho.

Perguntas frequentes

Existe app oficial do OpenClaw na Umbrel Store?

Não, na data deste guia. A forma recomendada de rodar o OpenClaw no Umbrel é via Docker, com o container oficial openclaw/openclaw e um docker-compose.yml próprio, conforme o passo a passo acima. A vantagem é que você recebe a mesma imagem oficial usada em qualquer instalação Docker.

Preciso de um Raspberry Pi 5 para rodar OpenClaw no Umbrel?

Não necessariamente. O OpenClaw em si roda em um Raspberry Pi 4 com 4 GB se você usar API de IA em nuvem (Claude, GPT). O gargalo é o Ollama: modelos locais de 7B pedem 8 GB de RAM e ficam mais confortáveis em um mini PC com 16 GB. Para apenas API em nuvem, qualquer hardware compatível com o Umbrel serve.

O OpenClaw no Umbrel funciona sem internet?

O gateway local continua rodando, mas o WhatsApp e o Telegram dependem de conexão com a internet para entregar mensagens. Com Ollama como provedor, a parte de IA funciona offline — ou seja, sua casa pode ficar offline que o histórico, o workspace e o modelo local permanecem intactos; apenas as mensagens param até a conexão voltar.

Quanto custa rodar o OpenClaw 24/7 em casa?

Além do hardware (a partir de ~R$ 400 em um Raspberry Pi usado), o custo contínuo é de energia: um Raspberry Pi ligado o mês inteiro consome algo na faixa de R$ 5 a 15, dependendo da tarifa. Com Ollama local, não há custo de API. Com API de nuvem, você paga por uso, como em qualquer instalação.

Como acesso o painel do OpenClaw fora de casa?

Instale o app Tailscale pela Umbrel Store e no seu celular. Isso cria uma rede privada segura entre os dispositivos, sem abrir portas no roteador. Evite port forwarding direto para a porta 3000 — não é necessário para WhatsApp/Telegram e expõe o gateway a ataques.

O WhatsApp conectado no servidor doméstico desliga se o servidor reiniciar?

Não, se a configuração estiver correta. A sessão do WhatsApp fica persistida no volume ./clawd e o restart: unless-stopped traz o container de volta após reinícios. Se a desconexão for frequente, as causas são geralmente as mesmas de qualquer instalação — veja o guia de WhatsApp desconecta.

Posso usar o Ollama da Umbrel Store junto com uma API paga?

Sim. O config.yaml aceita provedores múltiplos, e você define o default. Uma prática comum é deixar o Ollama como padrão para tarefas simples e trocar para Claude ou GPT quando a tarefa exige mais qualidade — a troca acontece no arquivo de configuração, sem reinstalar nada.

Vale migrar do PC para o Umbrel logo no início?

Não. Instale primeiro no seu computador com o guia de 5 minutos, valide qual tarefa o assistente resolve para você e só depois migre para o servidor 24/7. A migração é simples: copie a pasta ~/clawd para o volume do container no Umbrel e ajuste o config.yaml.

O Umbrel transforma o OpenClaw em infraestrutura de casa: sempre ligado, dentro da sua rede e sem mensalidade. Se quiser ir além do passo a passo com acompanhamento estruturado, conheça o curso do OpenClaw em português — e para receber os próximos guias de instalação e automação, acompanhe os recursos do site.