Instalação e Configuração Inicial
openclaw install
Instala a versão mais recente da ferramenta OpenClaw no seu sistema operacional.
Recomenda-se executar com privilégios de administrador para evitar problemas de permissão.
openclaw config init
Inicializa o arquivo de configuração global do OpenClaw, permitindo personalizar variáveis de ambiente e credenciais.
Edite o arquivo gerado para configurar proxies, chaves de API e outros parâmetros padrão.
openclaw auth login --token
Autentica o OpenClaw com sua conta de usuário, usando um token de API para acessar recursos premium ou serviços em nuvem.
Mantenha seu token seguro. Use variáveis de ambiente para evitar expô-lo diretamente no histórico do shell.
openclaw update
Verifica e instala quaisquer atualizações disponíveis para o OpenClaw CLI e seus componentes internos.
Execute regularmente para ter acesso às últimas funcionalidades e correções de segurança.
openclaw version
Exibe a versão atual do OpenClaw CLI instalada no seu sistema.
Útil para depuração e para garantir compatibilidade com scripts ou plugins.
Extração Básica de Dados
openclaw scrape https://example.com --selector ".product-title"
Extrai o texto de elementos que correspondem ao seletor CSS especificado de uma URL.
Use seletores CSS robustos para garantir que os dados corretos sejam capturados mesmo com pequenas alterações no site.
openclaw extract https://example.com --ai "nome e preço de todos os produtos"
Utiliza IA para identificar e extrair dados específicos de uma página, com base em uma descrição em linguagem natural.
Quanto mais específica for sua descrição em linguagem natural, mais precisos serão os resultados da IA.
openclaw get-links https://example.com --filter "/categoria/"
Coleta todos os links de uma página, opcionalmente filtrando por um padrão de URL.
Combine com o comando 'scrape' para criar crawlers que seguem links e extraem dados recursivamente.
openclaw snapshot https://example.com --full-page --output screenshot.png
Captura uma imagem da página web, incluindo a rolagem completa, salvando-a em um arquivo.
Útil para auditorias visuais de mudanças no layout ou para documentação.
openclaw data-fetch https://api.example.com/data --schema "id:int, nome:string, status:string"
Busca dados de uma API e os estrutura de acordo com um esquema pré-definido, validando os tipos.
Defina o esquema com precisão para garantir a integridade dos dados e facilitar o processamento posterior.
Navegação e Interação Avançada
openclaw browse https://example.com --click "#next-page-button"
Navega para uma URL e executa uma ação de clique em um elemento específico.
Use seletores CSS ou XPath para identificar botões, links ou outros elementos clicáveis.
openclaw form-fill https://example.com/login --input "username:user, password:pass" --submit
Preenche formulários em uma página web com dados fornecidos e, opcionalmente, os envia.
Insira os nomes dos campos do formulário e seus respectivos valores para automação de login ou cadastro.
openclaw paginate https://example.com/search --next-button ".pagination-next"
Automatiza a navegação entre páginas, clicando repetidamente em um botão de 'próximo' até que não esteja mais presente.
Ideal para extrair dados de listas paginadas, como resultados de pesquisa ou catálogos de produtos.
openclaw intercept https://example.com --block "*.css, *.png" --allow "*.json"
Controla quais requisições de rede são permitidas ou bloqueadas durante a navegação, otimizando o carregamento da página.
Bloqueie recursos desnecessários (imagens, scripts de rastreamento) para acelerar a raspagem e economizar largura de banda.
openclaw simulate https://example.com --action "scroll-down 3" --wait 500ms
Simula interações do usuário como rolagem, atrasos ou movimentos do mouse para renderizar conteúdo dinâmico.
Use 'scroll-down' ou 'scroll-to' para carregar conteúdo que aparece apenas quando o usuário rola a página.
Processamento e Transformação de Dados
openclaw process data.json --transform "preco * 1.10 as preco_novo"
Aplica transformações matemáticas ou lógicas aos campos de um arquivo de dados JSON ou CSV.
Use expressões simples ou complexas para manipular valores, criar novos campos ou formatar dados.
openclaw clean data.csv --remove-duplicates "SKU" --fill-missing "N/A"
Limpa um conjunto de dados, removendo duplicatas com base em um campo e preenchendo valores ausentes.
A limpeza de dados é crucial para garantir a qualidade e a consistência das informações antes da análise.
openclaw merge file1.json file2.json --on "ID_Produto" --output merged_data.json
Combina dois arquivos de dados (JSON ou CSV) com base em um campo chave comum.
Garanta que o campo chave exista em ambos os arquivos e tenha valores consistentes para uma fusão bem-sucedida.
openclaw normalize data.json --field "preco" --type "currency" --locale "pt-BR"
Normaliza valores em um campo específico para um formato padronizado, como moeda, data ou texto.
A normalização é essencial para comparar dados de diferentes fontes ou formatos.
openclaw filter data.csv --where "status == 'disponivel' AND preco < 100"
Filtra registros de um arquivo de dados com base em uma ou mais condições lógicas.
Use operadores lógicos (AND, OR, NOT) e de comparação (==, !=, <, >) para refinar seus dados.
Automação e Agendamento
openclaw schedule "0 0 * * *" "openclaw scrape example.com --output daily_data.json"
Agenda a execução de um comando OpenClaw ou script em intervalos regulares usando a sintaxe cron.
Teste seus comandos manualmente antes de agendá-los para garantir que funcionem como esperado.
openclaw workflow run my_workflow.json
Executa um fluxo de trabalho (workflow) predefinido que encadeia múltiplos comandos OpenClaw e lógicas condicionais.
Workflows são ideais para automatizar sequências complexas de tarefas, como raspagem, processamento e exportação.
openclaw monitor https://example.com --alert-on "element-missing .price" --notify "email:[email protected]"
Monitora uma página web em busca de alterações específicas e envia alertas quando uma condição é atendida.
Monitore elementos críticos para detectar quebras no scraping devido a mudanças no layout do site.
openclaw job status
Verifica o status de um trabalho agendado ou em execução, fornecendo informações sobre seu progresso e resultados.
Use o ID do trabalho retornado após agendar ou iniciar um workflow para monitorá-lo.
openclaw cron add "0 */6 * * *" "openclaw clean data.csv --remove-duplicates SKU" --name "LimpezaDiaria"
Adiciona uma nova tarefa cron diretamente ao agendador do sistema, com um nome descritivo.
Defina um nome claro para suas tarefas cron para facilitar o gerenciamento e a identificação.
Integração e Exportação
openclaw export data.json --to csv --output products.csv
Converte um arquivo de dados (JSON, XML) para outro formato, como CSV, Excel ou Parquet.
Escolha o formato de exportação que melhor se adapta ao seu sistema downstream ou ferramenta de análise.
openclaw push data.csv --to s3://my-bucket/data/ --region us-east-1
Envia um arquivo de dados para um serviço de armazenamento em nuvem, como Amazon S3, Google Cloud Storage ou Azure Blob Storage.
Configure as credenciais da nuvem via 'openclaw config' ou variáveis de ambiente para acesso seguro.
openclaw integrate data.json --with https://api.example.com/upload --method POST
Envia dados extraídos diretamente para uma API externa ou webhook, facilitando a integração em tempo real.
Verifique a documentação da API para o formato de payload e os cabeçalhos de autenticação necessários.
openclaw webhook add "data-ready" --url "https://my-webhook.com/receive" --event "export.complete"
Configura um webhook para ser acionado quando um evento específico do OpenClaw ocorre, como a conclusão de uma exportação.
Webhooks são excelentes para orquestrar fluxos de trabalho entre diferentes sistemas automaticamente.
openclaw save data.json --format excel --sheet "Produtos" --output report.xlsx
Salva dados em um arquivo Excel, permitindo especificar o nome da planilha e outras opções de formatação.
Útil para gerar relatórios que podem ser facilmente compartilhados e visualizados por usuários não técnicos.
AI e Análise Inteligente
openclaw analyze https://blog.example.com/noticia --ai "sentimento dos comentários"
Utiliza IA para analisar o conteúdo de uma URL e extrair insights específicos, como o sentimento de textos.
A análise de sentimento é poderosa para entender a percepção do público sobre produtos ou marcas.
openclaw categorize data.json --field "descricao" --ai "categorias de produto"
Classifica registros de dados em categorias predefinidas ou inferidas por IA, com base no conteúdo de um campo.
Perfeito para organizar grandes volumes de dados não estruturados em grupos significativos.
openclaw summarize https://news.example.com/article --ai "pontos chave da notícia"
Gera um resumo conciso de um texto longo ou artigo de uma página web, destacando os pontos mais importantes.
Economize tempo na leitura e análise de conteúdo com resumos automáticos gerados por IA.
openclaw detect-changes https://example.com --baseline baseline.json --output diff.json
Compara o estado atual de uma página web com uma 'baseline' anterior e relata as diferenças significativas usando IA.
Monitore alterações de preços, disponibilidade de produtos ou atualizações de conteúdo em sites concorrentes.
openclaw generate-report data.json --ai "insights e recomendações" --output insights.pdf
Cria um relatório detalhado a partir de um conjunto de dados, com insights e recomendações gerados por inteligência artificial.
Permite transformar dados brutos em inteligência acionável sem a necessidade de análise manual complexa.