1. Instalação e Configuração Inicial
openclaw install
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
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
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
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"
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" }'
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
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"
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]"
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"
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"
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
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
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}"
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
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
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
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
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"
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]"
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
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
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"
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
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
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
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.