O Guia Completo do OpenClaw: Da Primeira Instalacao ao Usuario Avancado

O Que e o OpenClaw e Por Que Voce Deveria se Importar?

O OpenClaw e um agente de IA de codigo aberto que roda na sua propria maquina — seu notebook, um servidor domestico ou um VPS na nuvem. Diferente das ferramentas de IA baseadas em navegador que apenas respondem perguntas, o OpenClaw age: ele le seus e-mails, agenda reunioes, organiza arquivos, envia mensagens pelo WhatsApp, Telegram e Discord, e automatiza fluxos de trabalho repetitivos — tudo atraves de linguagem natural.

Desde seu lancamento em janeiro de 2026, o projeto ultrapassou 244.000 estrelas no GitHub, tornando-se um dos repositorios de codigo aberto com crescimento mais rapido de todos os tempos. A razao e simples: as pessoas querem um assistente de IA que realmente faca coisas, e nao um que apenas fale sobre fazer coisas.

Aqui esta uma maneira rapida de entender a diferenca:

Chatbot de IA tradicional:

Voce: "Me ajude a organizar os arquivos da minha area de trabalho." IA: "Claro! Aqui estao algumas dicas: 1. Crie pastas por tipo... 2. Mova os arquivos de acordo..."

OpenClaw:

Voce: "Me ajude a organizar os arquivos da minha area de trabalho." OpenClaw: renomeia, classifica e move 47 arquivos para 5 pastas — "Pronto! Organizei tudo por tipo de arquivo."

Essa e a mudanca fundamental: de um chatbot para um agente.

Este guia te acompanha em toda a jornada — da sua primeira instalacao ate a criacao de Skills personalizados e o gerenciamento de multiplos agentes. Seja com 30 minutos ou uma tarde inteira, avance em cada secao no seu proprio ritmo.

Primeiros Passos: Instalacao e Configuracao

O Que Voce Precisa

• Node.js 22+ (LTS recomendado) — verifique com node --version
• Uma chave de API de modelo de IA — Anthropic Claude (recomendado), OpenAI ou um modelo local via Ollama
• macOS, Linux ou Windows com WSL2

Instale o OpenClaw

O caminho mais rapido e o instalador de uma linha:

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

Isso detecta seu sistema, instala dependencias se necessario e inicia o assistente de configuracao. Se voce preferir npm:

npm install -g openclaw@latest

Para usuarios Docker:

docker pull openclaw/openclaw:latest
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

Para um passo a passo detalhado de cada metodo, consulte nosso guia de Quickstart.

Execute o Assistente de Configuracao Inicial

Apos a instalacao, o assistente te guia por tudo:

openclaw onboard

Voce vai configurar tres coisas:

1. Provedor de IA e API key — O Anthropic Claude funciona melhor. Se voce ainda nao tem uma chave, obtenha uma em anthropic.com. Quer economizar? Veja nosso guia de selecao de modelo e custos.
2. Canal de mensagens — Escolha pelo menos um: o Telegram e o mais facil para comecar (configuracao de 5 minutos). Temos guias dedicados para Telegram, WhatsApp e Discord.
3. Modo de seguranca — Escolha Sandbox por enquanto. Voce pode atualizar para acesso completo depois, quando estiver mais confortavel.

Verifique se Tudo Funciona

openclaw status

Voce devera ver:

Gateway: Running ✓
Model: Connected ✓
Channels: 1 active

Agora abra o aplicativo de mensagens escolhido e envie sua primeira mensagem. Tente algo simples:

• "O que voce pode fazer?"
• "Que horas sao?"
• "Resuma as ultimas noticias de tecnologia."

Se o seu bot responder, parabens — voce tem um agente de IA funcionando.

Conceitos Fundamentais: Como o OpenClaw Funciona

Antes de ir mais fundo, e util entender os quatro blocos de construcao do OpenClaw. Pense neles assim:

Gateway — A Porta de Entrada

O Gateway e como o OpenClaw se conecta ao mundo exterior. Ele lida com mensagens vindas do Telegram, Discord, WhatsApp, uma API web ou ate mesmo da linha de comando. Voce pode executar multiplos gateways simultaneamente — por exemplo, Telegram para uso pessoal e Slack para o trabalho.

Skills — A Caixa de Ferramentas

Skills sao o que o OpenClaw consegue fazer. Cada Skill e uma capacidade empacotada: enviar e-mails, pesquisar na web, gerenciar arquivos, controlar seu navegador. Pense neles como aplicativos em um smartphone. O OpenClaw vem com alguns Skills integrados, mas o verdadeiro poder vem do ecossistema da comunidade no Clawhub e de escrever os seus proprios.

Navegue pelo nosso diretorio de Skills para ver o que esta disponivel.

Memory — O Cerebro

O OpenClaw lembra de coisas entre conversas. Diga a ele seu nome, sua agenda de trabalho, suas preferencias — e ele retem esse contexto. Diferente de chatbots sem estado, o OpenClaw constroi uma compreensao persistente de quem voce e e como voce trabalha, armazenada localmente em ~/.openclaw/memory/.

Sandbox — A Rede de Seguranca

O Sandbox controla o que o OpenClaw tem permissao para fazer no seu sistema. No modo sandbox, ele nao pode acessar arquivos arbitrarios nem executar comandos destrutivos. Essa e sua camada de seguranca — especialmente importante ao experimentar novos Skills ou dar ao OpenClaw permissoes mais amplas.

Para uma configuracao de seguranca detalhada, veja nosso modelo de configuracao segura.

Instalando e Usando Skills

Skills sao onde o OpenClaw deixa de ser uma "demo interessante" e se torna uma "ferramenta do dia a dia". Veja como comecar.

Buscar e Instalar

# Pesquise Skills por palavra-chave
openclaw skills search email

# Veja detalhes sobre um Skill especifico
openclaw skills info @openclaw/email-manager

# Instale
openclaw skills install @openclaw/email-manager

Cinco Skills Que Valem a Pena Instalar Primeiro

| Skill | O Que Faz | Comando de Instalacao | |-------|-----------|----------------------| | Email Manager | Le, redige e envia e-mails | openclaw skills install @openclaw/email-manager | | Calendar | Cria eventos, verifica agenda, envia convites | openclaw skills install @openclaw/calendar | | File Organizer | Classifica, renomeia e limpa arquivos | openclaw skills install @openclaw/file-organizer | | Web Search | Pesquisa na web e resume resultados | openclaw skills install @openclaw/tavily-search | | Browser Control | Automatiza tarefas no navegador | openclaw plugins install @openclaw/browser-control |

Apos instalar, basta conversar com seu agente naturalmente:

• "Verifique meus e-mails nao lidos e resuma os 3 principais."
• "O que tem na minha agenda amanha?"
• "Pesquise as ultimas notas de lancamento do OpenClaw."

Gerenciando Seus Skills

# Liste todos os Skills instalados
openclaw skills list

# Atualize todos os Skills
openclaw skills update

# Remova um Skill que voce nao precisa mais
openclaw skills remove @openclaw/file-organizer

Antes de instalar Skills de terceiros, revise nossa lista de verificacao de seguranca de Skills para se manter seguro.

Configurando Automacoes (Cron Jobs)

Uma das funcionalidades mais praticas do OpenClaw sao as automacoes agendadas. Em vez de pedir ao seu agente para fazer algo toda manha, voce pode configurar uma vez e deixar rodar.

Crie um Resumo Diario

Basta dizer ao seu agente em linguagem natural:

"Toda manha as 8h, me envie um resumo com o clima de hoje, meus eventos do calendario e a quantidade de e-mails nao lidos."

O OpenClaw criara um cron job automaticamente. Voce tambem pode gerencia-los manualmente:

# Liste todas as tarefas agendadas
openclaw cron list

# Veja detalhes de uma tarefa especifica
openclaw cron show <task-id>

# Pause uma tarefa
openclaw cron disable <task-id>

# Retome-a
openclaw cron enable <task-id>

# Delete permanentemente
openclaw cron delete <task-id>

Ideias de Automacao

• Resumo diario — Clima + calendario + e-mails nao lidos toda manha
• Resumo semanal — Relatorio na sexta-feira a tarde sobre as atividades da semana
• Rastreador de precos — Monitore uma pagina de produto e avise quando o preco cair
• Lembrete de fim de dia — Um lembrete amigavel as 18h para encerrar o trabalho
• Limpeza de caixa de entrada — Arquive automaticamente e-mails de baixa prioridade toda noite

Configurando a Memoria Persistente

O sistema de memoria do OpenClaw e o que faz dele algo pessoal. Quanto mais contexto voce fornecer, melhor ele te atende.

Ensine Seu Agente Sobre Voce

Envie uma mensagem assim:

"Lembre-se disso sobre mim: Meu nome e Alex. Sou gerente de produto. Trabalho de segunda a sexta, das 9h as 18h, fuso horario GMT+8. Prefiro respostas concisas. Me comunico em ingles, mas consigo ler chines."

O OpenClaw armazena isso em sua memoria de longo prazo e aplica a todas as interacoes futuras.

Visualizar e Editar a Memoria

# Veja o que seu agente lembra
cat ~/.openclaw/memory/long-term.json

# Ou pergunte diretamente no chat
"O que voce sabe sobre mim?"

Voce tambem pode corrigir ou remover memorias:

"Esqueca minha antiga agenda de trabalho. Agora eu trabalho das 10h as 19h."

Como a Memoria Funciona

O OpenClaw usa tres camadas de memoria:

• Curto prazo — Contexto da conversa atual (limpo apos cada sessao)
• Longo prazo — Fatos persistentes sobre voce (preferencias, habitos, informacoes biograficas)
• Episodica — Registros de interacoes passadas (usados para reconhecimento de padroes ao longo do tempo)

Essa abordagem em camadas significa que seu agente se torna mais util quanto mais voce o usa, sem precisar de lembretes constantes.

Escrevendo Seu Primeiro Skill Personalizado

Quando os Skills integrados e da comunidade nao cobrem sua necessidade especifica, voce pode escrever o seu proprio. Os Skills do OpenClaw usam um formato YAML simples.

Estrutura do Skill

Crie um novo arquivo em ~/.openclaw/skills/daily-news.yaml:

name: "Daily Tech News"
description: "Fetches and summarizes today's top tech headlines"
version: "1.0.0"

triggers:
  - "tech news"
  - "today's news"
  - "news summary"

steps:
  - action: web_search
    query: "top tech news today"
    max_results: 5

  - action: summarize
    content: "{{search_results}}"
    style: "bullet_points"

  - action: respond
    message: |
      Here's your tech news summary:

      {{summary}}

Teste

# Recarregue os Skills para captar o novo arquivo
openclaw skills reload

# Teste
openclaw skills test "Daily Tech News"

Depois tente na conversa: "Me de as noticias de tecnologia de hoje."

Construindo Skills Mais Complexos

Skills podem encadear multiplas acoes:

• web_search — Pesquisar na web
• summarize — Condensar texto em topicos ou paragrafos
• respond — Enviar uma resposta formatada
• file_read / file_write — Ler ou criar arquivos
• shell_exec — Executar comandos no terminal (requer permissoes adequadas)
• http_request — Chamar APIs externas

Voce pode combinar estas para construir fluxos de trabalho como: pesquisar precos de voos → comparar resultados → escrever um resumo em um arquivo → notificar voce pelo Telegram.

Gerenciamento de Multiplos Agentes

Conforme seu uso cresce, voce pode querer agentes separados para diferentes partes da sua vida — um para o trabalho, um para tarefas pessoais, um para experimentos.

Criar Agentes

# Crie um agente de trabalho com Claude Sonnet
openclaw create-agent work
openclaw config --agent work set ai.model "claude-sonnet-4-6"

# Crie um agente pessoal
openclaw create-agent personal
openclaw config --agent personal set ai.model "claude-haiku-4-5"

# Liste todos os agentes
openclaw list-agents

# Alterne entre eles
openclaw switch-agent work

Por Que Usar Multiplos Agentes?

| Agente | Modelo | Conectado A | Proposito | |--------|--------|-------------|-----------| | Work | Claude Sonnet | Slack, Gmail, Linear | Tarefas profissionais, triagem de e-mails | | Personal | Claude Haiku | Telegram, Google Calendar | Agendamentos, lembretes, tarefas pessoais | | Lab | Ollama (local) | Apenas CLI | Testar novos Skills, experimentos |

Cada agente tem sua propria memoria, Skills e conexoes de canais — completamente isolados uns dos outros.

Automacao de Navegador

O OpenClaw pode controlar um navegador para executar tarefas que vao alem de simples chamadas de API: preencher formularios, extrair dados de paginas web, comparar precos entre sites ou tirar capturas de tela.

Habilitar o Browser Control

# Instale o plugin de navegador
openclaw plugins install @openclaw/browser-control

# Habilite-o
openclaw config set browser.enabled true

# Mostre a janela do navegador (defina como true para depuracao)
openclaw config set browser.headless false

Casos de Uso

• "Abra o GitHub e encontre os repositorios em alta hoje."
• "Va ate a Amazon, pesquise teclados mecanicos e liste os 3 melhores por avaliacao com precos."
• "Preencha o formulario de contato em example.com com minhas informacoes."
• "Tire uma captura de tela do meu site de portfolio."

A automacao de navegador e poderosa, mas consome muitos recursos. Use-a para tarefas que realmente precisam de interacao visual com paginas web — para simples busca de dados, um Skill de pesquisa web e mais rapido e mais barato.

Integracoes Alem do Chat

O OpenClaw se conecta a mais do que apenas aplicativos de mensagens. Aqui estao algumas integracoes populares:

Google Workspace

openclaw config set integrations.google.enabled true
openclaw config set integrations.google.credentialsPath "/path/to/credentials.json"
openclaw integrations google authorize

Uma vez conectado, voce pode gerenciar Gmail, Google Calendar e Google Drive atraves de linguagem natural.

Gerenciamento de Projetos (Linear, Jira)

openclaw skills install @openclaw/linear
openclaw config set integrations.linear.apiKey "YOUR_API_KEY"

"Crie uma tarefa de alta prioridade no Linear: Corrigir o bug de redirecionamento da pagina de login."

Anotacoes (Obsidian, Notion)

openclaw skills install @openclaw/obsidian
openclaw config set integrations.obsidian.vaultPath "/path/to/vault"

"Crie uma nova nota no Obsidian com o titulo 'Notas da Reuniao — 2 de Marco' com os pontos de discussao de hoje."

Para uma lista completa de plataformas suportadas, confira nosso diretorio de integracoes de canais.

Seguranca e Controle de Custos

Docker Sandbox

Para maximo isolamento, execute o OpenClaw dentro de um Docker sandbox:

openclaw config set sandbox.mode "docker"
openclaw config set sandbox.docker.image "openclaw/sandbox:latest"
openclaw sandbox test

Isso restringe o acesso ao sistema de arquivos, acesso a rede e execucao de comandos a limites predefinidos.

Execute uma Auditoria de Seguranca

openclaw security audit --deep

Isso verifica permissoes mal configuradas, tokens expostos e outros problemas comuns.

Para um guia completo de hardening de seguranca, leia Exposicao de Portas e Acesso Remoto.

Controle Seus Gastos

Custos de API podem se acumular. Veja como definir limites de protecao:

# Defina um limite diario de requisicoes
openclaw config set ai.dailyLimit 1000

# Defina um teto de orcamento mensal (em USD)
openclaw config set ai.monthlyBudget 50

# Verifique seu uso
openclaw stats usage
openclaw stats cost

Custos mensais tipicos:

| Nivel de Uso | Descricao | Custo Estimado | |-------------|-----------|----------------| | Leve | 10-20 conversas/dia | $5–10/mes | | Moderado | 50-100 conversas + cron jobs | $20–30/mes | | Intenso | Automacoes + controle de navegador | $50–100/mes |

Quer se aprofundar na otimizacao de custos? Veja nosso guia de selecao de modelo e custos.

Referencia Rapida de Solucao de Problemas

| Sintoma | Causa Provavel | Solucao | |---------|---------------|---------| | EADDRINUSE na inicializacao | Porta 18789 ja em uso | openclaw gateway start --port 18790 | | 401 Unauthorized | API key invalida ou expirada | openclaw config set api-key | | Bot nao responde | Canal nao conectado | Verifique openclaw status e a configuracao do canal | | Respostas lentas | Modelo sobrecarregado ou problemas de rede | Tente um modelo mais leve ou verifique a conexao | | Skills nao carregam | Precisa recarregar apos instalacao | openclaw skills reload |

Para solucao de problemas mais detalhada, veja nosso guia de erros comuns.

Comandos de Diagnostico Uteis

# Verificacao completa de saude
openclaw doctor

# Ver logs
openclaw logs

# Modo de depuracao
openclaw config set logging.level "debug"

Proximos Passos

Voce cobriu bastante terreno. Aqui esta para onde ir dependendo dos seus interesses:

• Quer mais canais? Explore nossos guias de integracao de mais de 50 canais — de Slack e Teams a WeChat e Line.
• Interesse em seguranca? Leia a lista de verificacao de seguranca de Skills e o guia de configuracao segura.
• Quer hospedar por conta propria? Confira nosso guia sobre acesso remoto e exposicao de portas.
• Pronto para contribuir? O repositorio do OpenClaw no GitHub aceita pull requests, contribuicoes de Skills e relatorios de bugs.

O OpenClaw representa uma mudanca real na forma como interagimos com a IA — de pedir conselhos a delegar tarefas reais. O projeto esta evoluindo rapido, a comunidade esta crescendo, e o melhor momento para comecar a construir sua propria configuracao de agente de IA e agora.