Uma habilidade de automação móvel versátil para interagir com dispositivos, emuladores e simuladores iOS e Android.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install agent-device
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 agent-device 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 é agent-device?
O agent-device é uma ferramenta de automação sofisticada projetada para preencher a lacuna entre agentes de IA e ambientes móveis. Como parte do ecossistema Openclaw Skills, ele permite a interação perfeita com alvos iOS e Android, possibilitando navegação complexa de UI, extração de dados e gerenciamento de estado. Quer você esteja trabalhando com dispositivos físicos ou simuladores virtuais, esta habilidade fornece a interface necessária para realizar ações como tocar, digitar e rolar com precisão.
Esta habilidade é particularmente valiosa para desenvolvedores e engenheiros de QA que precisam integrar testes móveis em seus fluxos de trabalho orientados por IA. Ao utilizar instantâneos (snapshots) e segmentação baseada em seletores, o agent-device garante que as interações permaneçam determinísticas e confiáveis, mesmo conforme as interfaces dos aplicativos evoluem. Ele serve como um componente crítico na biblioteca Openclaw Skills para qualquer projeto que exija integração profunda com sistemas operacionais móveis.
Casos de uso do agent-device
- Automação de testes de UI de ponta a ponta para aplicativos iOS e Android.
- Depuração de falhas de aplicativos capturando logs e reproduzindo sequências.
- Extração de informações de UI e metadados para auditorias de acessibilidade ou coleta de dados.
- Reprodução de scripts de interação para verificar a estabilidade da UI após mudanças no código.
- Gerenciamento de estados do dispositivo, incluindo instalação de apps, inicialização e rastreamento de sessão.
Como o agent-device funciona
- Identificação do Alvo: A habilidade lista e conecta-se a simuladores iOS ou emuladores Android disponíveis usando o comando devices.
- Inicialização da Sessão: O comando open inicia o aplicativo ou URL especificado no dispositivo de destino.
- Descoberta de UI: Um instantâneo é tirado para analisar a hierarquia da tela atual e identificar elementos por meio de IDs de referência ou seletores.
- Execução de Interação: Comandos como press, fill ou scroll são enviados ao dispositivo para simular o comportamento do usuário.
- Verificação e Diferenciação: Instantâneos subsequentes ou verificações de appstate confirmam o sucesso da ação ou detectam mudanças na UI.
- Limpeza: A sessão é fechada e quaisquer logs ou capturas de tela capturados são salvos para análise.
Configuração do agent-device
Para começar a usar esta ferramenta da suíte Openclaw Skills, certifique-se de ter os SDKs móveis necessários (como Xcode ou Android Studio) instalados. Recomenda-se usar uma versão fixa para estabilidade.
npx --yes agent-device@latest --help
Para desenvolvimento iOS, certifique-se de que suas variáveis de ambiente para assinatura e provisionamento estejam configuradas se estiver usando dispositivos físicos. O uso básico envolve abrir uma sessão:
agent-device open MyApp --platform ios
Esquema de Dados e Taxonomia de agent-device
O agent-device organiza dados de automação por meio de instantâneos, logs e arquivos de script para manter a consistência em todo o framework Openclaw Skills.
| Tipo de Dado | Formato | Descrição |
|---|---|---|
| Snapshots | JSON | Árvores de hierarquia de UI com IDs de referência de elementos. |
| Logs | Text/Log | Logs do sistema armazenados em ~/.agent-device. |
| Scripts de Replay | .ad | Etapas de interação serializadas para reprodução determinística. |
| Screenshots | PNG | Capturas visuais do estado da tela do dispositivo. |
| Metadados | JSON | Info da sessão, incluindo plataforma, ID do pacote e status do dispositivo. |
Recursos avançados do agent-device
- Diferenciação interativa de instantâneos para detectar desvios de UI entre versões do app.
- Manutenção de reprodução determinística via comando replay -u para atualizar seletores.
- Depuração de sistema de baixo nível com limpeza de log integrada e funcionalidade grep direcionada.
- Modo de execução em lote para rodar sequências de interação complexas a partir de arquivos JSON.
- Suporte para simulação biométrica (FaceID) em simuladores iOS.
- Gravação de rastreamento para análise pós-morte detalhada de fluxos de automação.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
Desearch X (Twitter) Search
Uma ferramenta de busca e monitoramento do X (Twitter) em tempo real para agentes de IA encontrarem postagens, rastrearem usuários e analisarem o engajamento social.
Pesquisa Web Desearch
Uma habilidade de pesquisa na web de alto desempenho que fornece resultados de mecanismos de pesquisa em tempo real e snippets estruturados para agentes de IA.
Desearch Crawl
Uma ferramenta especializada para extrair texto limpo ou HTML bruto de qualquer página da web para impulsionar a pesquisa e automação baseadas em IA.
AI Search By Desearch
Um mecanismo de busca multi-fonte baseado em IA que agrega, filtra e resume conteúdo da web e de plataformas sociais.
React Native Logs CLI
Uma ferramenta CLI leve para ler logs do React Native Metro via CDP, projetada para integração perfeita com o Openclaw Skills.
Clawland
Clawland permite que agentes de IA joguem jogos on-chain par/ímpar na Solana devnet, cunhando tokens GEM a partir de SOL ou USDC.
Apresentou*
