--- title: "Instalar OpenClaw no Umbrel: Assistente de IA 24/7 no Servidor Doméstico" url: "https://openclaw.ia.br/blog/instalar-openclaw-umbrel-servidor-domestico/" markdown_url: "https://openclaw.ia.br/blog/instalar-openclaw-umbrel-servidor-domestico.MD" description: "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." date: "2026-10-02" author: "OpenClaw Brasil" --- # Instalar OpenClaw no Umbrel: Assistente de IA 24/7 no Servidor Doméstico 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](/instalacao/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](/instalacao/) 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](/canais/whatsapp/) e [Telegram](/canais/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](/hospedagem/local/)) | Só a API de IA | Máxima | Baixo, mas desliga com o PC | | VPS em [nuvem](/hospedagem/cloud/) | 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 umbrel@umbrel.local`. - **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: ```bash 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: ```bash 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: ```yaml 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`: ```yaml 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](/instalacao/docker/), adaptada ao Umbrel: ```yaml 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: ```bash 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 ```bash 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](/instalacao/). 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](https://t.me/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](/troubleshooting/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](/como-usar/claude-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](/seguranca-openclaw-respondendo-preocupacoes/). ## 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](/blog/ollama-openclaw-nao-executa-ferramentas/) | | WhatsApp cai depois de horas | Sessão/hardware | Guia [WhatsApp desconecta](/troubleshooting/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)](/instalacao/)** — a porta de entrada de 5 minutos; comece por aqui antes de migrar para servidor. - **[Docker geral](/instalacao/docker/)** — mesmo container; o Umbrel só adiciona a camada de gerenciamento de servidor doméstico. - **[Nuvem/VPS](/hospedagem/cloud/)** — quando o time precisa de acesso compartilhado ou a casa não tem energia/ internet estáveis. - **[Uso pelo celular](/blog/openclaw-android-como-usar-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](/blog/como-usar-openclaw-agente-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](/troubleshooting/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](/instalacao/), 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](/curso/) — e para receber os próximos guias de instalação e automação, acompanhe os [recursos do site](/recursos/).