Ultimate Reference

OpenClaw CLI: Sua Referência Definitiva de Comandos

Um guia completo para web scraping, extração de dados e automação inteligente com a ferramenta CLI OpenClaw.

1. Instalação e Configuração Inicial

openclaw install
Copied!

Instala a versão mais recente do OpenClaw CLI no seu sistema. Garante que todas as dependências estejam configuradas corretamente.

Execute com privilégios de administrador se encontrar problemas de permissão.

openclaw init
Copied!

Cria uma nova estrutura de projeto OpenClaw no diretório atual, com arquivos de configuração e exemplos de scripts.

Use um nome descritivo para o seu projeto para facilitar a organização.

openclaw config set
Copied!

Define ou atualiza uma configuração global ou específica do projeto. Útil para credenciais de API, proxies ou timeouts.

Armazene chaves sensíveis em variáveis de ambiente e referencie-as na configuração.

openclaw update
Copied!

Verifica e instala quaisquer atualizações disponíveis para o OpenClaw CLI e seus componentes principais.

Mantenha o OpenClaw atualizado para acessar os recursos mais recentes e correções de segurança.

2. Extração Básica de Dados

openclaw scrape --selector "CSS_SELECTOR"
Copied!

Extrai o conteúdo de elementos específicos de uma página web usando um seletor CSS. Retorna o texto ou HTML.

Use seletores CSS robustos para evitar quebras em mudanças de layout do site.

openclaw extract --ai-schema '{ "title": "h1", "price": ".price" }'
Copied!

Utiliza a IA para extrair dados estruturados de uma URL com base em um esquema JSON fornecido. Ideal para dados heterogêneos.

O esquema pode ser complexo, aninhado e incluir tipos de dados. A IA tentará corresponder.

openclaw list --element "li.item" --field "text" --output items.json
Copied!

Coleta uma lista de elementos que correspondem a um seletor e extrai um campo específico (ex: texto, href, src) de cada um.

Combine com --ai-schema para extrair múltiplos campos de cada item da lista.

openclaw get-attribute --selector "a#link" --attr "href"
Copied!

Obtém o valor de um atributo específico (ex: 'href', 'src', 'alt') de um elemento selecionado.

Útil para extrair URLs de links ou caminhos de imagens.

openclaw download --path "./downloads/" --file-selector "a[download]"
Copied!

Baixa arquivos de uma URL. Pode ser configurado para baixar links específicos encontrados na página.

Especifique o seletor para links de download para evitar baixar arquivos indesejados.

3. Navegação e Interação Avançada

openclaw navigate --click "button#nextPage"
Copied!

Navega para uma URL e simula um clique em um elemento especificado, útil para avançar páginas ou abrir modais.

Use seletores que sejam únicos para o elemento de clique para garantir a interação correta.

openclaw fill --field "#username" --value "myuser" --field "#password" --value "mypass"
Copied!

Navega para uma URL e preenche campos de formulário com os valores fornecidos.

Pode ser encadeado com --click para enviar o formulário após o preenchimento.

openclaw paginate --next-button ".next-page" --max-pages 5
Copied!

Automatiza a navegação por múltiplas páginas, clicando em um botão de 'próxima página' até um limite ou fim.

Combine com comandos de extração para coletar dados de todas as páginas paginadas.

openclaw screenshot --output "screenshot.png" --full-page
Copied!

Captura uma imagem da página web. Pode ser de uma área específica ou da página inteira.

Útil para depuração visual ou para documentar o estado de uma página.

4. Processamento e Exportação de Dados

openclaw process --jq ".items[] | {name: .title, price: .value}"
Copied!

Processa um arquivo JSON de entrada usando uma expressão JQ para filtrar, transformar ou reestruturar os dados.

JQ é uma ferramenta poderosa; familiarize-se com sua sintaxe para manipulação de dados complexa.

openclaw export --format csv --output output.csv
Copied!

Converte um arquivo JSON para outros formatos, como CSV, XLSX ou HTML, para fácil integração e análise.

Especifique os cabeçalhos das colunas para CSV usando a opção --fields para um controle mais preciso.

openclaw merge --output merged.json
Copied!

Combina múltiplos arquivos JSON em um único arquivo, útil para consolidar dados de várias fontes ou execuções.

O OpenClaw pode inteligentemente mesclar arrays ou objetos, dependendo da estrutura dos arquivos.

openclaw validate
Copied!

Valida um arquivo de dados JSON contra um esquema JSON, garantindo a conformidade e a integridade dos dados.

Use a validação para garantir que os dados extraídos atendam aos requisitos esperados antes do processamento.

5. Automação e Agendamento

openclaw run
Copied!

Executa um script JavaScript personalizado que pode orquestrar uma série de comandos OpenClaw ou lógica complexa.

Scripts JS oferecem flexibilidade máxima para cenários de automação complexos.

openclaw schedule --cron "0 9 * * 1-5"
Copied!

Agenda a execução de um comando OpenClaw ou script usando uma expressão cron, para automação recorrente.

Teste suas expressões cron cuidadosamente para garantir que o agendamento ocorra conforme o esperado.

openclaw monitor --diff-selector ".news-feed" --notify-email "[email protected]"
Copied!

Monitora uma URL em busca de alterações em um seletor específico e envia notificações quando detecta diferenças.

Útil para rastrear mudanças em preços, notícias ou disponibilidade de produtos.

openclaw workflow start
Copied!

Inicia um fluxo de trabalho definido em um arquivo JSON, que pode incluir uma sequência de tarefas e condições.

Use workflows para automatizar pipelines de dados completos, desde a extração até a exportação.

6. Depuração e Otimização

openclaw debug --verbose
Copied!

Executa um comando com saída detalhada para ajudar a identificar problemas. Mostra logs de rede, erros e warnings.

O modo verbose é essencial para entender por que um comando pode não estar funcionando como esperado.

openclaw inspect --selector "body > div.main"
Copied!

Abre uma interface interativa no navegador para inspecionar o DOM de uma página e testar seletores em tempo real.

Use esta ferramenta para construir e testar seletores CSS e XPath com precisão.

openclaw log show --level error
Copied!

Exibe os logs do OpenClaw. Pode ser filtrado por nível (info, warn, error) ou por período.

Monitore os logs para identificar erros recorrentes ou gargalos de desempenho.

openclaw benchmark
Copied!

Mede o tempo de execução e o consumo de recursos de um comando, ajudando na otimização de scripts.

Compare benchmarks antes e depois das otimizações para quantificar melhorias.

openclaw cache clear
Copied!

Limpa o cache local do OpenClaw, útil para garantir que você esteja sempre obtendo os dados mais recentes.

Limpe o cache ao depurar problemas onde dados desatualizados podem ser um fator.

Perguntas Frequentes sobre OpenClaw CLI

O que é OpenClaw CLI?

OpenClaw CLI é uma ferramenta de linha de comando avançada que utiliza inteligência artificial para web scraping, extração de dados e automação de tarefas em páginas web. É projetada para ser eficiente e flexível.

Preciso de conhecimento em programação para usar o OpenClaw?

Não necessariamente. Muitos comandos OpenClaw podem ser usados sem programação. No entanto, o conhecimento de seletores CSS/XPath e, para automações avançadas, JavaScript, pode expandir significativamente suas capacidades.

Como o OpenClaw lida com CAPTCHAs ou bloqueios de IP?

OpenClaw oferece recursos como rotação de proxies, simulação de comportamento humano e integração com serviços de resolução de CAPTCHA para contornar esses desafios, embora a eficácia possa variar.

Posso integrar o OpenClaw com outras ferramentas?

Sim, o OpenClaw gera dados em formatos padronizados como JSON, CSV e XLSX, facilitando a integração com bancos de dados, ferramentas de BI ou outros scripts personalizados.

O OpenClaw suporta JavaScript em páginas web?

Sim, OpenClaw utiliza um navegador headless que executa JavaScript, permitindo a interação com páginas dinâmicas e SPAs (Single Page Applications).