Uma habilidade de navegação web e extração de dados de alto desempenho que permite que agentes de IA capturem capturas de tela e texto via Playwright.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install playwright-controller
2. Instalação Manual
Copie a pasta da habilidade para um desses locais
~/.openclaw/skills/ <project>/skills/ Prioridade: Espaço de Trabalho > Local > Integrado
3. Instalação do Prompt
Copie este prompt para o OpenClaw para instalá-lo automaticamente.
Ajude-me a instalar o playwright-controller usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).
Prefere baixar?
Obtenha os arquivos originais da habilidade em um arquivo ZIP.
O que é Controlador Playwright?
O Controlador Playwright é uma ferramenta de automação de navegador de nível profissional projetada para o ecossistema Openclaw Skills. Ele permite que desenvolvedores e agentes de IA naveguem na web programaticamente usando o Chromium, fornecendo recursos como renderização de página inteira, emulação de dispositivos móveis e espera inteligente para conteúdo dinâmico. Ao contrário de simples scrapers, esta habilidade lida com sites pesados em JavaScript simulando ambientes de usuários reais, incluindo viewports de iPhone e strings de User-Agent específicas.
Ao integrar esta habilidade, os agentes ganham a capacidade de verificar visualmente layouts da web e extrair texto limpo e estruturado para processamento posterior. Suporta tanto o modo headless para velocidade quanto o modo headful para cenários que exigem intervenção manual, como logins complexos ou resolução de CAPTCHA, tornando-se uma adição versátil a qualquer fluxo de trabalho de automação.
Casos de uso do Controlador Playwright
- Geração de capturas de tela de página inteira ou elementos específicos para documentação visual.
- Extração de conteúdo de texto limpo de aplicações web modernas ao remover scripts e anúncios.
- Teste de responsividade de sites através de viewport móvel e simulação de User-Agent.
- Automação da coleta de dados de sites que exigem um ambiente de navegador completo para renderizar conteúdo JS.
- Depuração de interações web usando modos de navegador headful dentro de um ambiente impulsionado por IA.
Como o Controlador Playwright funciona
- O agente aciona a habilidade usando comandos específicos como fetch ou fetch-element.
- Uma instância do navegador Chromium é iniciada com configurações de contexto móvel pré-configuradas (simulação de iPhone).
- O controlador navega até a URL de destino e implementa espera inteligente usando o estado networkidle.
- Um atraso de renderização adicional é aplicado para garantir que todos os ativos e fontes assíncronos sejam totalmente carregados.
- A habilidade captura uma captura de tela PNG de alta resolução e extraia o texto interno da página.
- Elementos não essenciais como scripts e anúncios são filtrados durante a fase de extração de texto.
- Os arquivos são salvos em um diretório designado com carimbos de data/hora únicos e hashes baseados em URL para armazenamento organizado.
Configuração do Controlador Playwright
O Controlador Playwright faz parte da biblioteca Openclaw Skills e vem com todas as dependências necessárias pré-configuradas. Certifique-se de ter o Node.js (v16+) instalado.
# Para buscar uma página da web e gerar uma captura de tela imediatamente
playwright:fetch https://example.com
# Para capturar um elemento específico em uma página
playwright:fetch-element --selector=".main-content" https://example.com
Esquema de Dados e Taxonomia de Controlador Playwright
A habilidade organiza a saída em um formato de diretório estruturado, normalmente sob uma pasta ./screenshots. Os arquivos são nomeados usando uma combinação de carimbos de data/hora e hashes de URL limpos.
| Tipo de Arquivo | Convenção de Nomenclatura | Descrição |
|---|---|---|
| Captura de Tela Completa | <timestamp>_<url_hash>.png |
Captura PNG fiel de página inteira. |
| Texto Extraído | <timestamp>_<url_hash>_content.txt |
Conteúdo de texto limpo de toda a página. |
| Visual do Elemento | <timestamp>_<url_hash>_element.png |
Captura de tela direcionada de um seletor CSS específico. |
| Captura de Erro | <timestamp>_<url_hash>_error.png |
Estado visual capturado durante uma falha de execução. |
Recursos avançados do Controlador Playwright
- Emulação Móvel: Suporte integrado para User-Agent do iPhone 17.0 e simulação de resolução 375x800.
- Espera Inteligente: Detecção automática de estados de ociosidade de rede e buffers de renderização personalizados.
- Modo Headful: Janela de navegador visível opcional para depuração e interações manuais do usuário.
- Interceptação de Recursos: Capacidade de otimizar o desempenho ignorando ativos não essenciais enquanto mantém a precisão visual.
- API Flexível: Acesso direto às funções fetchWithPlaywright e fetchElementAndScreenshot para integração de scripts personalizados.
- Tratamento de Erros Robusto: Geração automática de captura de tela mesmo quando o carregamento da página falha para facilitar a depuração.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
Assistente de Engenharia de Paper
Um assistente estruturado de escrita acadêmica que utiliza uma arquitetura de três camadas para automatizar o desenvolvimento de teses e a organização de artigos de pesquisa.
Habilidade de Inteligência do Mercado de Ações
Uma ferramenta profissional de dados financeiros para consultar cotações de mercado em tempo real nos mercados de ações A-shares, Hong Kong e EUA.
Habilidade de Painel de Ações
Uma ferramenta de triagem automatizada para identificar ações com limite de alta e alto ímpeto no mercado chinês de ações-A.
Ponte de Arquivos Agente-para-Proprietário
Uma ponte segura para agentes de IA exportarem arquivos, compartilharem saídas e fornecerem links de download diretamente aos seus proprietários.
River Autotrader
Uma ferramenta de rastreamento e análise de informações de criptomoeda em tempo real para o ecossistema do token River ($RIVER).
Rastreador de Dinheiro Inteligente
Um sistema abrangente de inteligência on-chain para rastrear grandes transações, movimentos de baleias e fluxos de fundos institucionais em várias blockchains.
Apresentou*
