Ultimate Reference

OpenClaw CLI: O Seu Cheat Sheet Definitivo em Português

Acelere a sua produtividade em web scraping e automação de dados com comandos poderosos e eficientes.

1. Instalação e Configuração Básica

openclaw install
Copied!

Instala a versão mais recente do OpenClaw CLI no seu sistema.

Use `--force` para reinstalar ou atualizar dependências críticas.

openclaw config init
Copied!

Inicia o processo de configuração inicial, guiando-o através das definições essenciais.

Reveja o ficheiro de configuração gerado em `~/.openclaw/config.json` para ajustes manuais.

openclaw auth login
Copied!

Autentica-se com as suas credenciais OpenClaw para aceder a funcionalidades premium ou APIs.

Mantenha as suas chaves de API seguras e utilize variáveis de ambiente para produção.

openclaw update
Copied!

Verifica e instala quaisquer atualizações disponíveis para o OpenClaw CLI e os seus módulos.

Execute este comando regularmente para garantir que tem acesso às últimas funcionalidades e correções de segurança.

2. Raspagem de Dados Essencial (Web Scraping Básico)

openclaw scrape url
Copied!

Realiza uma raspagem básica de uma URL, retornando o conteúdo HTML completo.

Direcione a saída para um ficheiro com `> output.html` para análise posterior.

openclaw extract selector
Copied!

Extrai elementos específicos de uma página web usando um seletor CSS.

Use seletores CSS específicos (ex: `div.produto > h2.nome`) para maior precisão na extração.

openclaw fetch content --type text
Copied!

Obtém o conteúdo de texto puro de uma página web, removendo HTML e formatação.

Útil para extrair artigos ou descrições sem a necessidade de processamento adicional.

openclaw find links --depth 1
Copied!

Encontra todos os links internos e externos numa página, com opção de profundidade.

`--depth 0` para apenas a página atual, `--depth 1` para a página atual e as suas ligações diretas.

3. Extração Avançada e Filtragem

openclaw query xpath
Copied!

Executa uma consulta XPath numa URL para extração de dados complexa e hierárquica.

Teste os seus caminhos XPath num navegador antes de os usar no OpenClaw para evitar erros.

openclaw filter data --json-path
Copied!

Filtra e extrai dados de um ficheiro JSON local usando um caminho JSON (JSONPath).

Combine com `openclaw scrape` para processar dados raspados localmente.

openclaw parse table --output csv
Copied!

Identifica e extrai tabelas de uma página web, exportando-as para um formato específico.

Experimente `--output json` ou `--output excel` dependendo das suas necessidades de integração.

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

Tira uma captura de ecrã de uma página web, incluindo a opção de página completa.

Use esta funcionalidade para depurar problemas de layout ou para documentar o estado de uma página.

4. Automação e Fluxos de Trabalho

openclaw workflow create --template web_scrape
Copied!

Cria um novo fluxo de trabalho (workflow) a partir de um modelo predefinido ou em branco.

Defina os seus passos no ficheiro `workflow.yaml` gerado para lógica personalizada.

openclaw run workflow --params '{"query": "data"}'
Copied!

Executa um fluxo de trabalho existente, passando parâmetros dinâmicos.

Utilize variáveis de ambiente para parâmetros sensíveis ou que mudam frequentemente.

openclaw schedule task --every day --at "09:00"
Copied!

Agenda a execução de qualquer comando OpenClaw ou fluxo de trabalho em intervalos definidos.

Verifique o status dos agendamentos com `openclaw schedule list`.

openclaw integrate api --key --endpoint
Copied!

Configura a integração com serviços externos através de APIs, facilitando a troca de dados.

Crie integrações personalizadas para enviar dados raspados diretamente para bases de dados ou CRMs.

5. Gestão de Projetos e Dados

openclaw project init
Copied!

Inicializa um novo projeto OpenClaw, criando a estrutura de diretórios necessária.

Mantenha os seus scripts, configurações e dados raspados organizados dentro da estrutura do projeto.

openclaw data export --format json --path ./exports
Copied!

Exporta todos os dados recolhidos por um projeto para um formato especificado.

A exportação pode ser filtrada por data ou por tipo de dados com opções adicionais.

openclaw cache clear --all
Copied!

Limpa a cache local do OpenClaw, útil para garantir que está a obter dados frescos.

Use com `--older-than 24h` para limpar apenas itens de cache mais antigos que 24 horas.

openclaw logs view --level error --follow
Copied!

Visualiza os registos de atividade do OpenClaw, com opções de filtragem por nível e seguimento.

Monitorize os registos para depurar fluxos de trabalho falhados ou identificar problemas de conexão.

6. Interação e Simulação de Navegador

openclaw navigate --wait 5
Copied!

Abre uma página web num navegador headless e espera por um período ou por um seletor.

Aumente o tempo de espera para páginas com carregamento dinâmico de conteúdo.

openclaw click button
Copied!

Simula um clique num botão ou elemento clicável numa página web.

Use esta funcionalidade para interagir com menus, botões "Carregar Mais" ou aceitar cookies.

openclaw fill form
Copied!

Preenche um formulário numa página web com dados fornecidos em formato JSON.

O JSON deve mapear os atributos `name` dos campos do formulário para os valores desejados.

openclaw scroll to
Copied!

Rola a página web para uma posição específica (ex: `bottom`, `top`, ou `{"x": 0, "y": 500}`).

Útil para carregar conteúdo que só aparece após a rolagem da página.

Perguntas Frequentes sobre OpenClaw

O que é OpenClaw?

OpenClaw é uma ferramenta CLI avançada projetada para web scraping, extração de dados e automação, utilizando inteligência artificial para otimizar processos.

É necessário conhecimento de programação para usar OpenClaw?

Não é estritamente necessário conhecimento de programação. O OpenClaw CLI foi desenhado para ser intuitivo, mas ter alguma familiaridade com seletores CSS ou XPath é uma vantagem.

Posso automatizar tarefas complexas com OpenClaw?

Sim, OpenClaw suporta a criação e execução de fluxos de trabalho (workflows) complexos, bem como o agendamento de tarefas, permitindo uma automação robusta de dados.

Quais são os formatos de exportação de dados suportados?

OpenClaw suporta vários formatos de exportação, incluindo JSON, CSV, Excel e outros, facilitando a integração dos dados com diferentes sistemas e aplicações.