OpenClaw: o que é e como funciona o agente de IA pessoal open source

Escrito pela Redação IAZona · Revisado por Jadher Felisberto

OpenClaw é o agente de IA pessoal open source criado por Peter Steinberger que roda localmente, tem memória persistente e executa tarefas autônomas. Saiba como instalar e usar.

Pontos principais

OpenClaw ultrapassou 247 mil estrelas e 47 mil forks no GitHub em menos de 90 dias após lançamento em novembro de 2025.
Mercado de IA agêntica deve saltar de 1% em 2024 para 33% em 2028, segundo Gartner, com 82% das organizações planejando integração.
Agente roda localmente na porta 18789, suporta 10 canais de mensagem e é compatível com Claude, GPT-4, Gemini e modelos locais.

Imagine um assistente que não espera você fazer uma pergunta: ele monitora seus e-mails, negocia contratos, organiza arquivos e dispara scripts enquanto você dorme, tudo rodando no seu próprio computador, sem nenhum dado saindo para servidores de terceiros. Isso é o OpenClaw, um agente de IA pessoal de código aberto criado pelo desenvolvedor austríaco Peter Steinberger, fundador da PSPDFKit. Lançado em novembro de 2025 sob o nome Clawdbot (depois Moltbot, depois OpenClaw), o projeto ultrapassou 247 mil estrelas e 47 mil forks no GitHub em menos de 90 dias, um ritmo que Docker, Kubernetes e React nunca alcançaram.

O timing importa porque o mercado de agentes autônomos de IA está explodindo: segundo a Gartner (2025), 82% das organizações planejam integrar IA agêntica nos próximos três anos, e o uso de agentes em software corporativo deve saltar de 1% em 2024 para 33% em 2028. O OpenClaw chegou antes da maioria, com licença MIT, sem assinatura e com uma comunidade que já produz integrações para WeChat, Home Assistant e n8n. Se você quer entender esse fenômeno e decidir se vale colocar para rodar agora, este guia cobre cada detalhe essencial.

O que é o OpenClaw e como ele funciona

OpenClaw é um agente de IA autônomo (programa capaz de tomar decisões e executar ações de forma independente, sem precisar de aprovação humana a cada etapa) que roda localmente como um serviço contínuo. A diferença fundamental em relação a chatbots como ChatGPT ou Claude.ai está no ciclo de operação: um chatbot segue o fluxo pergunta → resposta → fim. O OpenClaw segue um laço agêntico (ciclo contínuo): ele observa o ambiente, planeja a próxima ação, executa ferramentas reais, armazena o resultado e recomeça, até que a tarefa esteja concluída, não apenas respondida.

O componente central é o Gateway, um servidor local escrito em TypeScript que opera em segundo plano na porta 18789 por padrão. Ele orquestra quatro camadas independentes:

Canais de mensagem: WhatsApp, Telegram, Slack, Discord, Signal, iMessage (via BlueBubbles), Microsoft Teams, Google Chat, Matrix e um WebChat nativo. Você interage com o agente como enviaria uma mensagem para um colega.

Motores de LLM (modelos de linguagem de grande escala, os cérebros por trás de ferramentas como ChatGPT): o OpenClaw é agnóstico ao modelo, ou seja, funciona com Claude da Anthropic, GPT-4 da OpenAI, Gemini do Google, DeepSeek e modelos locais via Ollama. Se um provedor ficar indisponível, um mecanismo de fallback (troca automática) assume outro que você configurou.

Ferramentas de ação: acesso ao shell do sistema (terminal), controle de navegador, envio de e-mails, gestão de agenda e jobs agendados (tarefas programadas para rodar em horários específicos, como um alarme). É isso que permite ao agente agir, não apenas responder.

Memória persistente: todo o contexto é salvo em arquivos de texto locais dentro de ~/.openclaw/. O arquivo SOUL.md guarda a personalidade do agente; USER.md armazena suas preferências. Logs diários são gravados em modo append-only (somente adição, nunca sobrescrita). Nenhum banco de dados externo, nenhum dado sai da sua máquina por padrão.

Um mecanismo de heartbeat (similar a um job cron, que é um agendador de tarefas do Linux) permite que o agente aja de forma proativa sem esperar mensagem sua: briefings matinais, backups automáticos, triagem de e-mails. É precisamente o que separa o OpenClaw de um chatbot comum.

A extensibilidade vem dos AgentSkills, módulos definidos em Markdown que ensinam ao agente como realizar tarefas específicas. Cada skill é um diretório com um arquivo SKILL.md contendo metadados e instruções em linguagem natural. O registro oficial ClawHub catalogava mais de 3.000 skills no início de 2026, cobrindo Gmail, GitHub, Notion, Obsidian, ElevenLabs, Home Assistant e n8n, entre outras. Skills de workspace têm precedência sobre as globais, que têm precedência sobre as embutidas.

O que você precisa antes de começar

Antes de instalar, verifique se o seu ambiente atende aos requisitos confirmados pelas fontes oficiais:

Sistema operacional: macOS, Windows ou Linux. O OpenClaw é cross-platform (funciona em múltiplos sistemas).

Node.js: o script oficial de instalação já inclui o Node.js automaticamente, então você não precisa instalá-lo manualmente se usar o comando recomendado abaixo.

Chave de API de um LLM: você precisa de pelo menos uma chave de acesso a um modelo de linguagem. As opções mais usadas pela comunidade são Claude (Anthropic), GPT-4 (OpenAI), DeepSeek e modelos locais via Ollama. O OpenClaw não inclui nenhum modelo: você traz o seu próprio (bring your own API key). Cada chamada ao modelo tem custo conforme o provedor escolhido; consulte a tabela de preços do provedor antes de escalar.

Acesso a terminal: a instalação e a configuração inicial são feitas via linha de comando. Se você nunca abriu um terminal, revise o conceito antes de prosseguir; um dos próprios mantenedores do projeto advertiu na comunidade que “se você não sabe rodar um comando de terminal, este projeto é perigoso demais para usar com segurança.”

Opcional para uso em produção 24/7: um servidor VPS (Virtual Private Server, um servidor na nuvem alugado mensalmente). A DigitalOcean oferece um deploy pré-configurado e com segurança reforçada a partir de US$ 24/mês. Isso elimina a necessidade de comprar hardware dedicado como um Mac Mini, que vários desenvolvedores consideraram para rodar instâncias próprias.

Instalação passo a passo

Os comandos abaixo vêm da documentação oficial e dos nossos próprios testes. O software evolui rapidamente: em caso de dúvida, confira sempre a documentação oficial do OpenClaw.

Passo 1: abra o terminal do seu sistema operacional. No macOS, use o Spotlight (Cmd + Espaço) e digite “Terminal”. No Windows, aperte a tecla Windows e digite “PowerShell”. No Linux, qualquer emulador de terminal serve.

Passo 2: execute o instalador oficial da sua plataforma.

No Windows, use o instalador nativo para PowerShell. A equipe do IAZona instalou com ele em um notebook comum com Windows 11 e o processo inteiro funcionou, do assistente de configuração à primeira tarefa executada:

iwr -useb https://openclaw.ai/install.ps1 | iex

O passo a passo completo dessa instalação, com as telas reais e as pegadinhas que encontramos no caminho, está no nosso tutorial Como instalar o OpenClaw no Windows. Um aviso importante: o comando com curl e bash que circula em muitos tutoriais NÃO funciona no PowerShell do Windows; nós testamos e ele retorna erro, pois é feito para sistemas Unix.

No macOS e no Linux, o instalador oficial é justamente o script via curl:

curl -fsSL https://openclaw.ai/install.sh | bash

Alternativa avançada no Windows: quem preferir um ambiente Linux completo pode usar o WSL2 (Subsistema do Windows para Linux). Abra o PowerShell como administrador, rode o comando abaixo, reinicie o computador e execute o instalador de Linux dentro do terminal Ubuntu:

wsl --install

Passo 3: siga o wizard de configuração. Após a instalação, o assistente interativo (wizard) guiará você para: escolher o provedor de LLM e inserir a chave de API; conectar pelo menos um canal de mensagens (recomenda-se começar com o WebChat nativo ou Telegram para testes); e configurar o serviço como processo contínuo no seu sistema.

Passo 4: instale as skills que desejar. Com o Gateway rodando, você pode adicionar AgentSkills do ClawHub. Antes de cada instalação, verifique o número de estrelas do repositório da skill, a data da última atualização e as permissões declaradas no arquivo SKILL.md. Uma skill legítima nunca pede suas credenciais em texto puro.

Alternativa em nuvem: se preferir não instalar localmente, a DigitalOcean oferece um 1-Click OpenClaw Deploy com imagem de segurança reforçada, pronta para produção, a partir de US$ 24/mês. Acesse a documentação da DigitalOcean para detalhes.

Primeiros passos: colocando o agente para trabalhar

Com o Gateway ativo, abra o canal de mensagens que você configurou (WebChat, Telegram ou outro) e envie uma mensagem simples em linguagem natural, como: “Qual é o meu status atual?” O agente responderá com um resumo do que ele tem acesso e o que já sabe sobre você.

O arquivo USER.md dentro de ~/.openclaw/ é o ponto de partida para personalização. Edite-o para informar ao agente suas preferências de idioma, fuso horário, ferramentas favoritas e qualquer contexto relevante. Quanto mais contexto você fornecer aqui, mais relevantes serão as ações autônomas do agente.

Para testar o modo autônomo, peça algo com ação real mas de baixo risco, como: “Pesquise as últimas notícias sobre [seu setor] e me mande um resumo aqui.” Isso exercita o ciclo completo de planejamento, pesquisa na web e resposta sem que você precise aprovar cada etapa.

Para instalar uma skill específica do ClawHub, o processo via terminal segue três etapas: clonar o repositório da skill no diretório ~/.openclaw/skills/, verificar o skill.md e reiniciar o Gateway. Via interface web do openclaw.ai, a instalação é feita com um clique no catálogo. Sempre confira a documentação oficial para o fluxo atualizado, pois comandos específicos de skills de terceiros variam por repositório.

5 usos que valem o esforço

1. Triagem e resposta de e-mails em volume
Cenário: você acorda com 40 e-mails, a maioria newsletters, notificações e pedidos repetitivos. Com a skill Gmail ou Outlook instalada, instrua o agente: “Leia minha caixa de entrada, arquive newsletters, responda pedidos de reunião confirmando disponibilidade às terças e quintas e me mande um resumo dos e-mails que precisam de atenção real.” O agente executa o ciclo completo enquanto você toma café. Caso documentado pela comunidade OpenClaw mostra um agente que redigiu e enviou uma carta de contestação a uma seguradora e conseguiu reabrir um processo de indenização que havia sido negado.

2. Negociação comercial automatizada por e-mail
Cenário: você quer comprar um produto caro e sabe que há margem de negociação. Um usuário documentado definiu o objetivo (comprar um carro) e a margem máxima de concessão. Enquanto dormia, o agente conduziu a sequência de e-mails de negociação e obteve US$ 4.200 de desconto no preço de tabela. Para replicar: instale a skill de e-mail, defina em linguagem natural o objetivo e os limites da negociação, e autorize o agente a agir no canal configurado.

3. Monitoramento da concorrência semanal automatizado
Cenário: você acompanha cinco fontes de notícias do seu setor. Configure um job agendado (via heartbeat): “Toda sexta às 17h, leia estas cinco fontes, aplique este critério de relevância e me envie um digest por e-mail.” Um caso documentado pela HelloPM (2026) mostrou a redução de duas horas de leitura semanal para cinco minutos de leitura do digest gerado pelo agente.

4. Planejamento familiar automatizado no Notion
Cenário: toda semana alguém precisa montar o cardápio, gerar a lista de compras e distribuir tarefas. Com a skill Notion instalada, Steve Caldwell configurou o agente para gerar automaticamente cardápio semanal, lista de compras e resumo familiar toda semana, economizando uma hora do seu tempo. Instrua o agente com suas preferências alimentares no USER.md e defina o horário de execução.

5. Desenvolvimento de código em segundo plano
Cenário: você tem um projeto de código que progride lentamente porque o tempo de atenção é escasso. Mike Manzano configurou seus agentes de código para rodar enquanto dormia. Andy Griffiths usou OpenClaw para construir um aplicativo Laravel funcional enquanto tomava café, na infraestrutura da DigitalOcean. Para replicar: com a skill GitHub instalada e acesso ao shell habilitado, descreva a tarefa em linguagem natural e deixe o agente iterar. Revise o resultado antes de fazer merge (integrar ao código principal).

Limitações, custos e segurança

O OpenClaw é uma das ferramentas mais poderosas desta geração de IA, mas honestidade exige falar sobre os riscos antes de liberar um agente autônomo nos seus sistemas.

Custos de API: o OpenClaw em si é gratuito (licença MIT), mas cada chamada ao modelo de linguagem tem custo conforme o provedor. Em escala, o uso intenso de Claude ou GPT-4 pode gerar faturas relevantes. Monitore o consumo no painel do provedor e defina limites de gasto antes de configurar automações 24/7. Para uso local sem custo de API, experimente modelos via Ollama.

Custos de infraestrutura: rodar localmente é gratuito em termos de hospedagem, mas exige que sua máquina fique ligada. Para uso contínuo, um VPS na DigitalOcean começa em US$ 24/mês com o 1-Click Deploy pré-configurado.

Segurança de skills de terceiros: este é o risco mais concreto e documentado. A equipe de segurança de IA da Cisco testou uma skill de terceiro do ClawHub e identificou exfiltração de dados (envio não autorizado de informações para fora da máquina) e injeção de prompt (quando instruções maliciosas são embutidas em dados que o agente processa, levando-o a executar ações não autorizadas) sem conhecimento do usuário. Em fevereiro de 2026, 341 extensões maliciosas foram removidas do ClawHub. Antes de instalar qualquer skill, verifique estrelas, data de atualização, autor e o conteúdo completo do SKILL.md. Nunca instale uma skill que peça credenciais em texto puro.

Permissões amplas e acesso autônomo: para funcionar com eficácia, o OpenClaw pode receber acesso a e-mails, calendários, shell do sistema e plataformas de mensagens. Instâncias mal configuradas ou expostas à internet apresentam risco sério de privacidade e segurança. Em março de 2026, o governo chinês restringiu o uso do OpenClaw em agências estatais e empresas públicas por preocupações de segurança, incluindo risco de exclusão não autorizada de dados e vazamentos. A plataforma Moltbook expôs 500 mil chaves de API e 35 mil endereços de e-mail por falta de autenticação no banco de dados.

Responsabilidade jurídica: quando um agente age em seu nome, como enviar um e-mail, fechar um negócio ou criar um perfil em uma plataforma, a responsabilidade legal recai sobre o usuário que configurou o agente. O caso MoltMatch, onde um agente criou um perfil em plataforma de relacionamento sem instrução explícita do usuário, ilustra como ações autônomas podem extrapolar a intenção original. O marco legal para ações de agentes de IA ainda não existe em boa parte das jurisdições. Defina escopo claro e permissões mínimas necessárias para cada tarefa.

Uma CVE (vulnerabilidade de segurança com registro oficial) que permite execução remota de código foi publicada em fevereiro de 2026. Mantenha o OpenClaw atualizado e acompanhe o repositório oficial no GitHub para patches de segurança.

Perguntas frequentes

O OpenClaw funciona sem pagar nada? O software em si é gratuito e de código aberto sob licença MIT. Você não paga assinatura ao OpenClaw. Porém, precisará de uma chave de API de um LLM (Claude, GPT-4 etc.), que tem custo por uso conforme o provedor. Se usar modelos locais via Ollama, o custo de API é zero, mas você precisará de hardware adequado para rodar os modelos.

Meus dados ficam mesmo na minha máquina? Na configuração padrão, sim. O Gateway armazena histórico de conversas, memória do agente e preferências em arquivos locais dentro de ~/.openclaw/, sem enviar para servidores externos do OpenClaw. As chamadas ao LLM, porém, passam pela API do provedor que você escolheu (OpenAI, Anthropic etc.), seguindo as políticas de privacidade desses serviços. Para privacidade total, use um modelo local via Ollama.

Preciso saber programar para usar o OpenClaw? Para a instalação básica e uso das skills do ClawHub, não é necessário saber programar, apenas operar o terminal para rodar o comando de instalação. Para criar skills personalizadas, revisar código gerado pelo agente ou configurar integrações avançadas, conhecimento técnico intermediário ajuda. O próprio mantenedor do projeto alertou que quem não sabe rodar um comando de terminal corre risco ao usar o projeto.

O OpenClaw ainda é mantido agora que Steinberger foi para a OpenAI? Sim. Em fevereiro de 2026, Steinberger anunciou que ingressaria na OpenAI para trabalhar com agentes pessoais de próxima geração. Simultaneamente, foi criada a OpenClaw Foundation, uma fundação sem fins lucrativos que assume a governança do projeto. Sam Altman confirmou que a OpenAI apoiará o projeto como iniciativa open source independente. O repositório continua ativo com contribuições da comunidade.

Para quem o OpenClaw vale a pena hoje

O OpenClaw é a escolha certa para desenvolvedores, pesquisadores e profissionais técnicos que já se sentem confortáveis com terminal, entendem o conceito de chave de API e querem um agente de IA que realmente age, não apenas responde. Se você tem tarefas repetitivas bem definidas, como triagem de e-mails, geração de relatórios semanais, monitoramento de projetos ou automação de pesquisas, o retorno de tempo pode ser significativo já na primeira semana de uso.

Para usuários sem experiência em linha de comando ou que precisam de garantias de suporte empresarial, o risco ainda supera o benefício: a advertência do próprio mantenedor sobre o nível de perigo para quem não domina o terminal deve ser levada a sério. Nesses casos, o 1-Click Deploy da DigitalOcean reduz parte da complexidade, mas não elimina a necessidade de entender o que o agente tem permissão para fazer.

O ecossistema está amadurecendo rapidamente. Empresas como Tencent e Z.ai já anunciaram serviços baseados em OpenClaw; Microsoft testava internamente o ClawPilot em maio de 2026; e o Google desenvolvia seu próprio agente concorrente. Quem aprender a operar o OpenClaw agora, com cautela e escopo bem definido, estará à frente de uma curva que o mercado corporativo levará ainda dois a três anos para absorver. Acompanhe as atualizações na documentação oficial do OpenClaw antes de escalar qualquer automação.