Análise do OpenClaw: instalação, Docker e segurança para quem auto-hospeda

O OpenClaw é a resposta padrão quando alguém pede um agente de IA de código aberto que possa rodar por conta própria. Foi lançado em novembro de 2025, tinha 394.193 estrelas no GitHub quando verificamos em 8 de novembro de 2026 e hoje está sob uma fundação sem fins lucrativos, sem plano pago. Essa popularidade traz muita coisa: 29 canais de chat, 64 provedores de modelos e mídia e 142 plugins oficiais. Também significa que muita gente está rodando um agente com acesso ao shell no computador principal sem ter lido a documentação de segurança. Esta análise trata do que é preciso de verdade para rodá-lo.

Para quem é

O OpenClaw combina com um desenvolvedor ou um entusiasta técnico que quer um agente acessível pelo WhatsApp, Telegram, iMessage ou Slack, quer escolher (e trocar) o modelo e está disposto a cuidar da instalação. Se você não se sentiria à vontade lendo um arquivo de configuração para ativar um sandbox, os próprios mantenedores avisam que ele é arriscado para você, e uma opção mais restrita da lista abaixo é um começo melhor.

Instalação do OpenClaw: três caminhos reais

A documentação de instalação oferece três caminhos práticos:

• Script de instalação. curl -fsSL https://openclaw.ai/install.sh | bash no macOS, Linux ou WSL2, ou uma linha de PowerShell no Windows. Ele instala o Node se você não tiver e depois inicia o onboarding. É o caminho que a maioria deveria seguir.
• npm. npm install -g openclaw@latest e depois openclaw onboard --install-daemon. Útil se você já gerencia o Node por conta própria; é preciso Node 24.16+ ou 26.1+.
• Apps de desktop para macOS, Windows e Linux, além de um deploy no Railway com um clique se você quiser num servidor sem mexer em terminal.

O onboarding guia você pela escolha de um provedor de modelos e do primeiro canal. A parte trabalhosa costuma ser o canal, não a instalação: o iMessage, por exemplo, tem a própria página de configuração.

OpenClaw no Docker

Existe um caminho oficial com Docker: rode ./scripts/docker/setup.sh a partir do repositório, que pede as chaves de API, gera um token para o gateway e sobe o gateway com Docker Compose. Você pode usar a imagem pré-compilada ghcr.io/openclaw/openclaw; compilar localmente exige pelo menos 6 GB de RAM. A interface de controle fica escutando em 127.0.0.1:18789.

O ponto que a maioria não percebe: rodar o gateway no Docker não é o mesmo que colocar o agente em sandbox. A documentação do Docker diz isso claramente: o sandbox vem desativado por padrão e “não exige que o próprio Gateway rode em um contêiner”. O Docker dá a você uma instalação organizada e descartável. Sozinho, ele não decide o que as ferramentas do agente podem acessar. Isso é uma configuração separada.

Segurança do OpenClaw: o que mudar no primeiro dia

De fábrica, as ferramentas do OpenClaw rodam no host. A documentação de sandbox explica que agents.defaults.sandbox controla isso, com Docker como backend padrão e Podman, SSH, OpenShell e Crabbox como alternativas. Mesmo com o sandbox ativado, o processo do gateway continua no host, e tools.elevated é uma saída de emergência explícita que executa comandos fora dele. A documentação chama o sandbox de “não uma barreira de segurança perfeita”.

Na prática, uma base sensata fica assim:

1. Ative o sandbox (o exemplo mínimo da documentação usa mode: "non-main" com workspaceAccess: "none").
2. Negue exec na política de ferramentas se o agente não precisar de shell, e mantenha elevated desativado.
3. Trate skills de terceiros como qualquer outro código que você instala, porque uma skill roda com os acessos do agente.
4. Tenha cuidado com quais caixas de entrada você conecta. Tudo o que o agente lê, inclusive um e-mail de um desconhecido, pode tentar manipulá-lo.

Tratamos do panorama de riscos mais amplo em O OpenClaw é seguro?. Se você quer o próprio OpenClaw, mas com sandbox e aprovações de rede integrados, o NemoClaw, da NVIDIA, o envolve; veja NemoClaw vs OpenClaw.

Telemetria

O OpenClaw não é silencioso por padrão. De fábrica, ele executa uma verificação diária de atualizações que envia suas versões do OpenClaw, do sistema operacional e do Node e a arquitetura de CPU, além de uma contagem de instalações sem identificadores e relatórios de atualização. As estatísticas de recursos são opcionais. Definir update.checkOnStart: false desativa tudo, segundo a documentação de telemetria. Para a maioria de quem auto-hospeda, é um padrão aceitável; para uma máquina isolada da rede, mude a configuração.

Modelos e custos de operação

O software é gratuito; o modelo não, a menos que você rode um localmente via Ollama, LM Studio ou vLLM. Isso pesa mais no OpenClaw do que num app de chat, porque um agente funciona em loop: planeja, chama ferramentas, lê os resultados e chama de novo. O Notebookcheck relatou usuários gastando mais de US$ 100 por dia com modelos caros. Defina um limite de gastos no seu provedor antes de deixá-lo rodando, e comece as tarefas proativas e agendadas com um modelo mais barato.

Manutenção e maturidade

O desenvolvimento é muito ativo: a versão que verificamos era a v2026.11.1, e os lançamentos saem com frequência. Isso é bom para correções e ruim para o “configure e esqueça”. Planeje atualizar com regularidade, leia as notas de versão para ver mudanças de configuração e rode openclaw doctor depois das atualizações para pegar problemas de configuração (a imagem Docker roda isso para você ao iniciar). A vantagem do tamanho é que quase todo problema que você encontrar já foi enfrentado, perguntado e respondido por alguém.

Quando escolher outra coisa

• Você quer isolamento ativado por padrão: o NanoClaw roda cada agente no próprio contêiner, e o ZeroClaw traz um sandbox do sistema operacional num único binário em Rust. Veja NanoClaw vs OpenClaw e ZeroClaw vs OpenClaw.
• Você quer um agente que escreva as próprias skills: o Hermes Agent, que também pode importar sua configuração do OpenClaw. Veja Hermes Agent vs OpenClaw.
• Você quer vários bots sempre ativos, cada um com o próprio computador: o Rakazo.

Todas as opções estão na nossa página de alternativas ao OpenClaw.

Veredito

O OpenClaw é o agente de código aberto com mais estrelas da nossa lista, com um grande ecossistema de plugins, e a licença MIT sem plano pago significa que não há nenhum upsell à sua espera. Seu ponto fraco é a postura padrão: ferramentas no host, telemetria ativada e um ecossistema de skills que você mesmo precisa verificar. Configure o sandbox e a política de ferramentas antes de conectar seu e-mail, e ele é uma escolha sólida.