OpenClaw Guide: Build Your AI Assistant

TL;DR

• OpenClaw é um assistente de IA de código aberto com mais de 135 mil estrelas no GitHub
• Roda localmente na sua máquina — seus dados permanecem privados
• Conecte via WhatsApp, Telegram, Discord, Slack, iMessage e mais
• Mais de 3.000 skills da comunidade para automação, programação, casa inteligente e mais
• Gratuito (você paga apenas pelos tokens da API de IA, normalmente de US$ 10 a US$ 50/mês)
• A configuração leva cerca de 30 minutos com este guia

O que é o OpenClaw?

OpenClaw (anteriormente conhecido como Clawdbot, depois Moltbot) é o projeto de IA de código aberto mais comentado de 2026. É um assistente pessoal de IA que:

• Roda em seu próprio computador ou servidor
• Conecta-se aos seus aplicativos de mensagens favoritos (WhatsApp, Telegram, Discord, etc.)
• Tem acesso total ao seu sistema de arquivos, terminal e navegador
• Pode automatizar tarefas como um assistente pessoal turbinado

A Jornada: Clawdbot → Moltbot → OpenClaw

O projeto teve uma verdadeira aventura com nomes:

Não importa como você o chame, a funcionalidade permanece a mesma — um assistente de IA incrivelmente poderoso que roda localmente.

Por que OpenClaw?

vs. ChatGPT / Claude Web

vs. Outros Agentes de IA

Recursos matadores do OpenClaw:

1. Inbox multicanal: Uma única IA, acessível via WhatsApp, Telegram, Discord, Slack, iMessage e mais de 12 plataformas
2. Memória persistente: Lembra o contexto em diferentes conversas
3. Ecossistema de skills: Mais de 3.000 plugins da comunidade via ClawHub
4. Agnóstico ao modelo: Funciona com Claude, GPT, Gemini, DeepSeek, modelos locais Ollama, etc.
5. Código aberto: Licença MIT, código totalmente auditável

Pré-requisitos

Antes de começar, certifique-se de ter:

• [ ] Um computador (Mac, Windows com WSL2 ou Linux)
• [ ] Node.js v22+ instalado (baixe aqui)
• [ ] Uma chave de API de IA (Anthropic Claude, OpenAI ou outras)
• [ ] Cerca de 30 minutos de tempo

Requisitos de Hardware

Métodos de Instalação

Método 1: Instalação em Uma Linha (Recomendado)

A maneira mais rápida de começar:

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

Este script irá:

1. Verificar os requisitos do seu sistema


2. Instalar o OpenClaw


3. Iniciar o assistente de configuração (onboarding wizard)

Método 2: Docker (Recomendado para Servidores)

Se você prefere implantação em containers:

# Clone o repositório
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Execute a configuração do Docker
./docker-setup.sh

A configuração do Docker cria dois diretórios importantes:

• ~/.openclaw/ — Configuração, memória, chaves de API


• ~/openclaw/workspace/ — Arquivos acessíveis ao agente de IA

Método 3: Compilar a partir do Código-Fonte

Para desenvolvedores que desejam controle total:

# Clone o repositório
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Instale as dependências
pnpm install

# Compile a UI
pnpm ui:build

# Compile o projeto
pnpm build

# Execute a configuração
pnpm openclaw onboard --install-daemon

Configuração Passo a Passo

Passo 1: Execute o Assistente de Configuração

Após a instalação, o assistente de configuração inicia automaticamente. Se não iniciar, execute:

openclaw onboard --install-daemon

O assistente guiará você por:

1. Seleção do Provedor de Modelo
2. Configuração da Chave de API
3. Configuração da Plataforma de Mensagens
4. Configurações de Segurança

Passo 2: Configure seu Modelo de IA

O OpenClaw suporta múltiplos provedores de IA. Escolha um:

Opção A: Anthropic Claude (Recomendado)

# Defina sua chave de API
export ANTHROPIC_API_KEY=sk-ant-xxxxx

# Ou use o comando de configuração
openclaw config set 'models.default' 'claude-sonnet-4'

Opção B: OpenAI

export OPENAI_API_KEY=sk-xxxxx
openclaw config set 'models.default' 'gpt-4o'

Opção C: DeepSeek (Econômico)

openclaw config set 'models.providers.deepseek' --json '{
  "baseUrl": "https://api.deepseek.com/v1",
  "apiKey": "your-api-key",
  "api": "openai-completions",
  "models": [
    { "id": "deepseek-chat", "name": "DeepSeek Chat" },
    { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
  ]
}'

Opção D: Modelos Locais com Ollama

Para total privacidade, execute modelos localmente:

# Instale o Ollama primeiro: https://ollama.ai
ollama pull llama3.3

# Configure o OpenClaw para usá-lo
openclaw config set 'models.providers.ollama' --json '{
  "baseUrl": "http://localhost:11434/v1",
  "api": "openai-completions",
  "models": [
    { "id": "llama3.3", "name": "Llama 3.3" }
  ]
}'

Passo 3: Conecte Plataformas de Mensagens

É aqui que o OpenClaw brilha — converse com sua IA de qualquer lugar.

Telegram (Mais fácil)

1. Envie uma mensagem para @BotFather no Telegram
2. Envie /newbot e siga as instruções
3. Copie o token do seu bot
4. Configure o OpenClaw:

openclaw config set 'channels.telegram.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.telegram.allowlist' '["your_telegram_username"]'

WhatsApp

O OpenClaw usa o WhatsApp Web para a conexão:

# Ative o canal do WhatsApp
openclaw config set 'channels.whatsapp.enabled' true

# Reinicie o gateway
openclaw gateway restart

# Escaneie o código QR que aparecer

Um código QR aparecerá no seu terminal. Escaneie-o com o WhatsApp no seu celular (Configurações → Aparelhos conectados → Conectar um aparelho).

Discord

1. Crie uma aplicação no Discord em discord.com/developers
2. Crie um bot e copie o token
3. Configure:

openclaw config set 'channels.discord.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.discord.allowlist' '["your_discord_user_id"]'

iMessage (Apenas Mac)

Para usuários de Mac, o OpenClaw pode se conectar diretamente ao iMessage:

openclaw config set 'channels.imessage.enabled' true

Passo 4: Inicie o Gateway

O gateway é o serviço de segundo plano que mantém o OpenClaw rodando:

# Iniciar como daemon (serviço em segundo plano)
openclaw gateway start

# Ou rodar em primeiro plano para depuração
openclaw gateway

# Verificar status
openclaw gateway status

# Ver logs
openclaw logs --follow

Passo 5: Acesse o Dashboard Web

O OpenClaw inclui uma interface web para configuração e chat direto:

# Abrir o dashboard no seu navegador
openclaw dashboard

Isso abrirá http://127.0.0.1:18789/ com um token de login temporário.

Pelo dashboard, você pode:

• Conversar diretamente com sua IA


• Gerenciar configurações


• Ver histórico de conversas


• Instalar skills

Sua Primeira Conversa

Assim que tudo estiver configurado, envie uma mensagem para o seu bot (via Telegram, WhatsApp ou interface web):

Olá! Pode me dizer o que você consegue fazer?

O OpenClaw irá se apresentar e mostrar suas capacidades. Tente algumas tarefas reais:

Quais arquivos estão na minha pasta Downloads?

Pesquise nos meus documentos por qualquer coisa relacionada a "imposto 2025"

Crie um script em Python que converte CSV para JSON

O que está usando mais espaço em disco no meu computador?

Instalando Skills

As skills estendem as capacidades do OpenClaw. Navegue pelo registro ClawHub ou instale diretamente:

Skills Populares

# Integração com GitHub
openclaw skill install github

# Automação de navegador web
openclaw skill install agent-browser

# Gerenciamento de calendário
openclaw skill install calendar

# Automação de e-mail
openclaw skill install email

# Controle de casa inteligente
openclaw skill install homeassistant

# Geração de imagens
openclaw skill install dalle

# Conversas por voz (Discord)
openclaw skill install discord-voice

Categorias de Skills

Aviso de Segurança

⚠️ Importante: Revise as skills antes de instalar. A natureza aberta do ClawHub significa que podem existir skills maliciosas. Use openclaw skill inspect para revisar o código ou peça ao Claude Code / Codex para auditá-lo para você.

Configuração Avançada

Estrutura do Arquivo de Configuração

O OpenClaw armazena a configuração em ~/.openclaw/:

~/.openclaw/
├── openclaw.json    # Configuração principal
├── env              # Variáveis de ambiente (chaves de API)
├── memory/          # Armazenamento de memória persistente
├── skills/          # Skills instaladas
├── backups/         # Backups de configuração
└── logs/            # Arquivos de log

Editando a Configuração

# Ver config atual
openclaw config get

# Definir um valor
openclaw config set 'key.path' 'value'

# Editar no seu editor padrão
openclaw config edit

Gerenciamento de Memória

O OpenClaw mantém memória persistente entre as conversas:

# Ver estatísticas de memória
openclaw memory stats

# Limpar toda a memória (cuidado!)
openclaw memory clear

# Exportar memória para backup
openclaw memory export > memory-backup.json

Executando Verificações de Saúde (Health Checks)

# Verificação de saúde abrangente
openclaw doctor

# Verificar componentes específicos
openclaw doctor --check api
openclaw doctor --check channels
openclaw doctor --check skills

Melhores Práticas de Segurança

O OpenClaw tem acesso total ao sistema — é isso que o torna poderoso, mas também arriscado. Siga estas diretrizes:

1. Use uma Máquina Dedicada

Não execute o OpenClaw no seu computador principal de trabalho. Opções:

• VPS: DigitalOcean, Vultr, AWS (US$ 5-20/mês)
• Laptop antigo: Reutilize hardware antigo
• Raspberry Pi: Funciona para uso leve
• Docker: Fornece algum isolamento

2. Ative o Modo Sandbox

Para sessões não confiáveis (chats de grupo, canais):

openclaw config set 'agents.defaults.sandbox.mode' 'non-main'

Isso executa sessões de grupo/canal dentro de sandboxes Docker.

3. Use Listas de Permissão (Allowlists)

Permita apenas que usuários específicos interajam com seu bot:

# Telegram
openclaw config set 'channels.telegram.allowlist' '["usuario1", "usuario2"]'

# Discord
openclaw config set 'channels.discord.allowlist' '["id_do_usuario_1", "id_do_usuario_2"]'

4. Mantenha Atualizado

Vulnerabilidades de segurança foram encontradas em versões anteriores. Sempre use a mais recente:

# Verificar atualizações
openclaw update --check

# Atualizar para a última versão
openclaw update

Nota: Versões anteriores a 2026.1.29 possuem uma vulnerabilidade de segurança conhecida. Atualize imediatamente se estiver em uma versão antiga.

5. Audite Skills Antes de Instalar

# Inspecionar o código de uma skill
openclaw skill inspect <nome-da-skill>

# Verificar a reputação da skill
openclaw skill info <nome-da-skill>

Exemplos de Automação

Aqui é onde o OpenClaw se torna realmente poderoso:

Resumo Matinal

Configure um resumo diário às 8h:

# Na sua config, adicione um cron job
openclaw config set 'automations.morning-briefing' --json '{
  "cron": "0 8 * * *",
  "action": "Envie-me um resumo de: previsão do tempo, eventos do calendário hoje, e-mails importantes não lidos e as 3 principais manchetes de notícias"
}'

Bot de Revisão de PR no GitHub

Revise PRs automaticamente quando for atribuído:

openclaw skill install github

# Configurar webhook ou busca periódica
openclaw config set 'automations.pr-review' --json '{
  "trigger": "github.pr.assigned",
  "action": "Revise o PR, verifique bugs, problemas de segurança e violações de estilo. Poste um comentário de resumo."
}'

Cenas de Casa Inteligente

openclaw skill install homeassistant

# Automação "Saindo de casa"
openclaw config set 'automations.leaving-home' --json '{
  "trigger": "location.leave_home",
  "action": "Desligue todas as luzes, coloque o termostato no modo econômico e ative o sistema de segurança"
}'

Organização de Arquivos

Diga ao OpenClaw para organizar sua pasta Downloads:

Organize minha pasta Downloads: mova imagens para ~/Pictures, documentos para ~/Documents e apague qualquer coisa com mais de 30 dias

Solução de Problemas

Problemas Comuns

# Adicionar ao PATH
export PATH="$HOME/.openclaw/bin:$PATH"
# Adicione ao perfil do seu shell (.bashrc, .zshrc)

# Verifique suas variáveis de ambiente
openclaw config get models

# Execute a configuração novamente
openclaw onboard

# Verifique os logs
openclaw logs --channel whatsapp

# Reinicie o gateway
openclaw gateway restart

# Reconstruir índice de skills
openclaw skill rebuild

# Verificar conflitos
openclaw doctor --check skills

Obtendo Ajuda

• Documentação: docs.openclaw.ai
• GitHub Issues: github.com/openclaw/openclaw/issues
• Comunidade no Discord: discord.gg/openclaw
• Reddit: r/OpenClaw

Detalhamento de Custos

O OpenClaw em si é gratuito. Seus custos vêm do uso da API de IA:

Dicas para Economizar

1. Use DeepSeek para tarefas rotineiras (US$ 0,14/M tokens vs US$ 3/M do Claude)
2. Modelos locais para consultas simples (grátis após o investimento em hardware)
3. Defina limites de tokens por conversa
4. Use cache para consultas repetidas

O Que Vem a Seguir?

Agora que você tem o OpenClaw rodando, aqui estão algumas ideias:

Construa Suas Próprias Skills

Crie skills personalizadas para suas necessidades específicas:

# Criar uma nova skill
openclaw skill create minha-skill-personalizada

# Editar a skill
code ~/.openclaw/skills/minha-skill-personalizada/SKILL.md

Conecte Mais Plataformas

• Adicione múltiplas contas de WhatsApp (pessoal + trabalho)
• Conecte o Slack para trabalho, Discord para o pessoal
• Configure o iMessage para o ecossistema Apple

Explore o Ecossistema

• Navegue no ClawHub para encontrar mais de 3.000 skills
• Junte-se à comunidade no Discord para dicas e truques
• Siga @OpenClaw para atualizações

Indo Além: Implante Seus Próprios Produtos de IA

Depois de experimentar o poder dos assistentes de IA, você pode querer construir produtos para outras pessoas. É aí que entra o Y Build.

O Y Build ajuda você a passar de uma ideia baseada em IA para um produto lançado:

1. Programação com IA: Descreva o que você quer, a IA gera o código
2. Implantação em Um Clique: Fique online instantaneamente com CDN global
3. Ferramentas de Crescimento: Vídeos de demonstração, otimização de SEO, analytics

• Uma ferramenta SaaS movida a IA
• Uma plataforma de automação como o OpenClaw
• Um chatbot personalizado para o seu negócio

Conclusão

O OpenClaw representa um novo paradigma na IA pessoal — um assistente que é:

• Local: Seus dados nunca saem da sua máquina
• Poderoso: O acesso total ao sistema permite automação real
• Extensível: Mais de 3.000 skills e crescendo
• Multiplataforma: Uma única IA, acessível em todos os lugares

• Responder perguntas pelo seu WhatsApp
• Pesquisar e organizar seus arquivos
• Automatizar tarefas repetitivas
• Controlar sua casa inteligente
• E muito mais

Bem-vindo à comunidade OpenClaw. 🦞

• Documentação Oficial do OpenClaw
• Repositório GitHub do OpenClaw
• Registro de Skills ClawHub
• Codecademy: Tutorial OpenClaw
• DigitalOcean: O que é OpenClaw
• Hostinger: Como configurar o OpenClaw
• CNBC: De Clawdbot a OpenClaw
• Medium: Rodando OpenClaw com Segurança usando Docker