FONECLAW PARA ANDROID
Configure o modelo, as permissões e as aprovações de ferramentas por trás de cada ação no Android.
O FoneClaw é o agente de IA para celular. O LLM selecionado cuida da compreensão e do planejamento; as ferramentas internas executam ações compatíveis no telefone.
Cada visual abaixo vem de uma gravação localizada do produto FoneClaw.
Contexto diário
O FoneClaw pode reunir SMS recentes, notificações e informações do dispositivo em uma única visão prática.
Mostre meu resumo de hoje.
Mensagens
Peça um período ou contato e receba as mensagens relevantes agrupadas e resumidas.
Resuma os SMS desta semana por contato.
Auditoria do dispositivo
Verifique memória, armazenamento, bateria, rede, permissões de aplicativos e sinais sensíveis com um único pedido.
Verifique a saúde do meu telefone.
Controle do telefone
Ajuste controles compatíveis do sistema ou trabalhe com dispositivos Wi-Fi e Bluetooth próximos.
Defina o brilho em 60% e depois encontre minha caixa de som.
Trabalho entre aplicativos
Resuma e-mails configurados, encontre um destino e abra uma rota em um aplicativo de navegação compatível.
Resuma os e-mails recentes e depois navegue até o hotel.
Contexto visível
Quando o recurso está ativado, uma nova captura de tela ou foto pode acionar um pedido para resumir o conteúdo visível.
Resuma esta captura de tela.
Pesquise no catálogo público usado por Skills e Workflows. Os rótulos de risco e aprovação vêm do projeto no GitHub.
127 ferramentas internas públicas
| Ferramenta | Risco | Aprovação | O que faz |
|---|---|---|---|
camera_open_latest_photoTela e aplicativos | Leitura sensível | Exige aprovação | Abre a foto visível mais recente da galeria do sistema. Use somente quando o usuário pedir explicitamente para ver ou abrir a foto mais nova. Não use após camera_take_photo, a menos que o usuário peça para abrir a foto capturada. |
camera_open_photoTela e aplicativos | Leitura sensível | Exige aprovação | Abre uma foto visível específica da galeria do sistema. Use somente quando o usuário pedir explicitamente uma foto específica. Não use após camera_take_photo sem um pedido para abrir a captura. indexFromLatest começa em 1 e segue da mais nova para a mais antiga. |
camera_take_photoTela e aplicativos | Leitura sensível | Exige aprovação | Tira uma nova foto e retorna o URI salvo quando disponível. Use quando a intenção for capturar uma foto. Para uma captura normal, deixe lensFacing sem valor ou como auto e mantenha explicitLensSelection como false. Se o usuário pedir câmera frontal, selfie ou traseira, escolha o valor correspondente e defina explicitLensSelection como true. Não abra a foto depois sem um pedido explícito. A câmera nativa do sistema tem prioridade; o backend direto só pode ser usado quando ela não respeitar a lente solicitada. Chame a ferramenta sem pedir previamente que o usuário conceda permissão. |
cross_app_read_screenTela e aplicativos | Baixo | Automática | Abre ou alterna para um aplicativo Android, aguarda até ele permanecer em primeiro plano e retorna a árvore de acessibilidade visível. Use quando o mesmo pedido exigir abrir o aplicativo e ler, inspecionar, descrever ou resumir a página. Não divida a tarefa entre launch_app e get_screen_info. Não captura a tela nem interage com elementos. |
cross_app_screenshotTela e aplicativos | Leitura sensível | Exige aprovação | Abre ou alterna para um aplicativo Android, aguarda a tela aparecer e captura a tela atual. Use apenas quando um mesmo pedido exigir abrir o aplicativo e tirar a captura. Não use para pedidos que envolvam somente captura ou somente abertura do aplicativo. |
get_installed_map_appsTela e aplicativos | Baixo | Automática | Consulta os aplicativos de mapas instalados compatíveis com as ferramentas de mapas. Retorna o nome exibido e o nome do pacote de cada aplicativo. |
get_screen_infoTela e aplicativos | Baixo | Automática | Obtém os elementos da interface do aplicativo visível. Cada elemento tem um ID de nó, como [n3], que pode ser usado com tap_node. Não use para ler, listar, pesquisar ou resumir notificações do Android; use as ferramentas sysinfo. Não armazene o resultado, pois os IDs mudam a cada chamada. |
launch_appTela e aplicativos | Controle do dispositivo | Exige aprovação | Abre um aplicativo Android iniciável pelo nome do pacote ou pelo nome exibido. Isso muda o aplicativo em primeiro plano e pode expor sua tela. Prefira o nome exato do pacote. Se houver ambiguidade, peça ao usuário para escolher um dos pacotes retornados. |
play_store_check_appTela e aplicativos | Baixo | Automática | Verifica, por uma consulta de rede somente leitura, se um nome exato de pacote Android está listado no Google Play. Use antes de play_store_install. |
play_store_installTela e aplicativos | Efeito externo | Exige aprovação | Abre no Google Play a página de um aplicativo identificado pelo nome exato do pacote, toca em Instalar e aguarda a conclusão. Não abre o aplicativo instalado. Não use resultados aproximados nem escolha o primeiro resultado. Se packageName for desconhecido, peça o pacote exato. Interrompe diante de pagamento, compra, assinatura, atualização, interface ambígua ou tempo limite. |
screenshot_openTela e aplicativos | Leitura sensível | Exige aprovação | Abre uma captura de tela visível específica na galeria do sistema. index começa em 1 na ordem escolhida, e sortOrder pode ser newest ou oldest. |
screenshot_open_latestTela e aplicativos | Leitura sensível | Exige aprovação | Abre a captura de tela visível mais recente da galeria do sistema. Use quando o usuário quiser ver a captura salva mais nova, em vez de criar outra. |
screenshot_takeTela e aplicativos | Leitura sensível | Exige aprovação | Captura a tela atual do Android com o serviço de acessibilidade do FoneClaw e salva em Pictures/FoneClaw/Screenshots. Use quando a intenção for capturar a tela atual. Para ver uma captura já salva, use screenshot_open. |
tap_nodeTela e aplicativos | Baixo | Automática | Toca em um elemento da interface visível. O elemento é identificado pelo ID de nó obtido pela ferramenta screen_info. |
alarm_modify_alarmStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Abre imediatamente a página de alarmes do Relógio quando o usuário quiser alterar um alarme existente. Chame a ferramenta para cada pedido separado, mesmo que já tenha sido usada na conversa, e não peça confirmação. Como o Android não oferece uma API pública confiável para editar alarmes existentes, a ferramenta apenas abre o Relógio para edição manual. |
alarm_set_alarmStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Define um alarme no Relógio do Android. Reúna horário, repetição e rótulo ausentes antes da chamada. |
bluetooth_connected_devicesStatus do dispositivo e controle do sistema | Leitura sensível | Exige aprovação | Retorna os dispositivos Bluetooth conectados no momento por perfis públicos do Android visíveis a aplicativos comuns. |
bluetooth_nearby_devicesStatus do dispositivo e controle do sistema | Leitura sensível | Exige aprovação | Procura e retorna dispositivos Bluetooth próximos. Inclui resultados BLE e de descoberta Bluetooth clássica quando as permissões e o estado do Bluetooth permitem. Dispositivos sem nome legível ficam ocultos por padrão. |
bluetooth_pair_deviceStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Inicia o pareamento com um dispositivo Bluetooth pelo endereço MAC. Abre o fluxo normal de vínculo do Android, que pode exigir confirmação ou PIN do usuário. |
bluetooth_paired_devicesStatus do dispositivo e controle do sistema | Leitura sensível | Exige aprovação | Retorna os dispositivos Bluetooth já pareados com este dispositivo Android. |
bluetooth_stateStatus do dispositivo e controle do sistema | Baixo | Automática | Retorna o estado atual do adaptador Bluetooth: on, off, turning_on, turning_off ou unknown. |
close_bluetoothStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Desliga o Bluetooth pela API pública legada. Se o Android recusar, informa que aplicativos Android comuns não podem desligar o Bluetooth neste dispositivo. |
device_app_activity_snapshotStatus do dispositivo e controle do sistema | Leitura sensível | Exige aprovação | Retorna um resumo compacto da atividade recente de aplicativos com o UsageStats do Android. Exige acesso ao uso de aplicativos e não monitora processos em segundo plano em tempo real. |
device_app_permission_auditStatus do dispositivo e controle do sistema | Leitura sensível | Exige aprovação | Retorna uma auditoria compacta de riscos de permissões dos aplicativos instalados visíveis. O risco é heurístico e considera grupos de permissões sensíveis declaradas ou concedidas. |
device_app_sensitive_auditStatus do dispositivo e controle do sistema | Leitura sensível | Exige aprovação | Retorna estados sensíveis compactos dos aplicativos: acessibilidade, acesso a notificações, administrador do dispositivo, sobreposição, isenção de otimização de bateria e grupos de permissões sensíveis concedidas. |
device_battery_statusStatus do dispositivo e controle do sistema | Baixo | Automática | Retorna um resumo compacto da bateria e da economia de energia do Android. Não altera configurações. |
device_health_checkStatus do dispositivo e controle do sistema | Baixo | Automática | Retorna um diagnóstico compacto e somente leitura de memória, armazenamento, bateria e rede. Não altera configurações. |
device_hidden_app_checkStatus do dispositivo e controle do sistema | Leitura sensível | Exige aprovação | Faz uma verificação heurística de aplicativos do usuário sem entrada no iniciador ou com componentes desativados. Pode sinalizar aplicativos suspeitos, mas serviços legítimos também podem aparecer. |
device_memory_statusStatus do dispositivo e controle do sistema | Baixo | Automática | Retorna um resumo compacto da memória do Android. Não altera configurações. |
device_network_statusStatus do dispositivo e controle do sistema | Baixo | Automática | Retorna o estado e os recursos da rede ativa do Android. Não altera configurações de rede. |
device_storage_statusStatus do dispositivo e controle do sistema | Baixo | Automática | Retorna um resumo do armazenamento interno e compartilhado do Android. Não verifica nem exclui arquivos. |
device_time_statusStatus do dispositivo e controle do sistema | Baixo | Automática | Retorna o fuso horário atual do Android e o timestamp Unix para chamadas dependentes de horário. Use verifyWithNtp=true apenas se o horário do sistema estiver em dúvida ou for necessária uma referência online. A verificação NTP usa ntp1.aliyun.com e nunca altera o relógio. |
dnd_open_policy_access_settingsStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Abre as configurações do Android onde o usuário pode conceder ao FoneClaw acesso a Não Perturbe e à política de notificações. Não chame logo após dnd_set_mode informar que essa página já foi aberta. |
dnd_set_modeStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Define o modo Não Perturbe do Android. Se faltar acesso à política ou o Android recusar a alteração, abre a página de acesso ou configurações correspondente. |
dnd_statusStatus do dispositivo e controle do sistema | Baixo | Automática | Lê o estado do acesso à política Não Perturbe e o filtro de interrupções atual do Android. |
flashlight_set_enabledStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Liga ou desliga a lanterna do Android pela API de iluminação da câmera do sistema. |
flashlight_statusStatus do dispositivo e controle do sistema | Baixo | Automática | Retorna se a lanterna está disponível e seu último estado conhecido. |
flashlight_toggleStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Alterna o estado da lanterna do Android. Se o estado atual for desconhecido, liga a lanterna. |
foneclaw_permission_statusStatus do dispositivo e controle do sistema | Baixo | Automática | Verifica todas as permissões e acessos especiais atuais do próprio FoneClaw. Use quando o usuário perguntar quais permissões estão ativas, ausentes, limitadas ou disponíveis. É uma leitura atualizada; não substitua por auditoria de aplicativos, painel de notificações ou leitura de tela. |
open_bluetoothStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Solicita a ativação do Bluetooth. Em SDKs de destino legados, tenta primeiro a API pública e recorre à interface de confirmação do Android quando necessário. |
system_panel_open_notificationsStatus do dispositivo e controle do sistema | Leitura sensível | Exige aprovação | Abre a área visível de notificações do Android somente quando o usuário pedir explicitamente para abri-la ou exibi-la. Nunca use para ler, inspecionar, pesquisar, listar ou resumir notificações; nesses casos, use sysinfo. Exige o serviço de acessibilidade do FoneClaw. |
system_panel_open_quick_settingsStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Abre o painel de configurações rápidas, atalhos rápidos ou central de controle do Android. Exige o serviço de acessibilidade do FoneClaw. |
system_settings_open_battery_optimization_entryStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Abre as configurações de otimização de bateria do Android. Se appNameOrPackage for informado, abre os detalhes desse aplicativo pelo pacote ou nome instalado. Se não puder identificá-lo ou abri-lo, retorna falha sem abrir outra página. Sem valor, abre a lista de otimização de bateria do sistema. |
system_settings_open_battery_saver_settingsStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Abre as configurações de Economia de bateria do Android. Aplicativos comuns não podem alternar esse modo diretamente por APIs públicas; depois da abertura, o usuário deve fazer a alteração manualmente. ROMs de fabricantes podem recorrer às configurações gerais de bateria. |
system_settings_open_date_time_settingsStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Abre diretamente as configurações de data e hora do Android. Use para data, hora, horário automático, fuso horário ou fuso automático. Inicia uma Intent do sistema sem exigir acessibilidade, leitura de tela ou toque. Após o sucesso, não chame launch_app, get_screen_info nem tap_node. |
system_settings_open_hotspot_entryStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Abre as configurações de ponto de acesso do Android. Aplicativos comuns não conseguem alternar o hotspot silenciosamente de forma confiável por APIs públicas. Se a página exata não puder ser aberta, retorna falha sem abrir outra configuração. |
system_settings_open_location_entryStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Abre as configurações de localização do Android. Se appNameOrPackage for informado, abre os detalhes do aplicativo pelo pacote ou nome instalado. Se não puder identificá-lo ou abri-lo, retorna falha sem abrir outra página. Sem valor, abre as configurações de Localização do sistema. |
system_settings_set_auto_rotateStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Ativa ou desativa a rotação automática do Android. Exige a permissão especial para modificar configurações do sistema. |
system_settings_set_brightnessStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Define o brilho da tela do Android. No modo manual, usa um percentual de 1 a 100; no modo auto, apenas ativa o brilho automático e ignora percent. Exige permissão especial para modificar configurações do sistema. |
system_settings_set_eye_comfortStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Abre as configurações de Tela do Android para conforto visual, luz noturna, filtro de luz azul ou modo leitura. Use em vez de fornecer apenas instruções manuais. Como cada fabricante oferece um controle diferente, o usuário conclui a alteração nessa página. |
system_settings_set_font_scaleStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Define a escala de fonte do sistema Android. Exige permissão especial para modificar configurações. Valores típicos: 0.85 pequeno, 1.0 padrão, 1.15 grande, 1.3 maior e até 1.6 extra grande. |
system_settings_set_haptic_feedbackStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Ativa ou desativa a resposta tátil do Android. Exige permissão especial para modificar configurações do sistema. |
system_settings_set_screen_timeoutStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Define em segundos o tempo até a tela do Android apagar. Exige permissão especial para modificar configurações, e o valor é limitado ao intervalo de 15 a 1800 segundos. |
system_settings_set_touch_soundsStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Ativa ou desativa os sons de toque do Android. Exige permissão especial para modificar configurações do sistema. |
system_settings_set_user_rotationStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Trava a rotação da tela do Android. Exige permissão especial para modificar configurações e desativa a rotação automática. Aceita portrait, landscape, reverse_portrait ou reverse_landscape. |
system_settings_statusStatus do dispositivo e controle do sistema | Baixo | Automática | Retorna o estado da permissão para gravar configurações e os valores atuais de brilho, escala da fonte, tempo de tela, rotação, sons de toque e resposta tátil. Apenas lê as configurações do Android. |
volume_adjust_streamStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Aumenta ou reduz um fluxo de áudio do Android em uma etapa do sistema. Use para mudanças relativas de volume. |
volume_set_all_streams_mutedStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Silencia ou reativa todos os fluxos de áudio compatíveis do Android e informa quais mudaram. Use para pedidos que envolvam o aparelho inteiro ou todos os volumes. |
volume_set_ringer_modeStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Define o modo de toque do telefone Android. No modo silencioso, recorre automaticamente ao silenciamento de todos os fluxos de áudio se o Android recusar a alteração do toque. |
volume_set_streamStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Define um fluxo de áudio do Android em um percentual específico. Use quando o usuário pedir um nível exato de volume. |
volume_set_stream_mutedStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Silencia ou reativa um fluxo de áudio do Android. Altera o estado do fluxo, não o modo de toque do telefone. |
volume_statusStatus do dispositivo e controle do sistema | Baixo | Automática | Lê o estado atual dos fluxos de áudio e o modo de toque do Android. |
wifi_configured_networksStatus do dispositivo e controle do sistema | Leitura sensível | Exige aprovação | Lê as redes Wi-Fi configuradas ou salvas no Android. Retorna metadados e estado da conexão, mas nunca senhas de Wi-Fi. |
wifi_connectStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Conecta a uma rede Wi-Fi. Primeiro verifica as configurações salvas do Android para o SSID e conecta diretamente se ele existir. Se não estiver salvo, usa a passphrase informada para adicionar e conectar ou abre o painel Wi-Fi quando for necessário digitar a senha. |
wifi_disconnectStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Desconecta do ponto de acesso Wi-Fi atual. Primeiro tenta a desconexão silenciosa legada do WifiManager em hosts com API de destino 28; se o Android recusar, abre o painel Wi-Fi para ação do usuário. |
wifi_forgetStatus do dispositivo e controle do sistema | Destrutivo | Exige aprovação | Esquece uma rede Wi-Fi salva. Primeiro tenta removeNetwork silenciosamente pelo WifiManager legado e, se necessário, abre o painel Wi-Fi para ação do usuário. |
wifi_scan_networksStatus do dispositivo e controle do sistema | Leitura sensível | Exige aprovação | Procura e retorna pontos de acesso Wi-Fi próximos. Se o Wi-Fi estiver desligado, tenta ativá-lo diretamente e só abre o painel Wi-Fi se essa tentativa falhar. Exige permissão de localização e o serviço de localização do dispositivo. Os resultados podem revelar dados de rede sensíveis à localização. |
wifi_set_enabledStatus do dispositivo e controle do sistema | Controle do dispositivo | Exige aprovação | Ativa ou desativa o Wi-Fi do Android. Primeiro tenta a operação direta do WifiManager e verifica se o estado solicitado foi atingido. Se falhar ou ficar pendente, abre o painel Wi-Fi para ação do usuário. |
wifi_statusStatus do dispositivo e controle do sistema | Leitura sensível | Exige aprovação | Retorna o estado atual do Wi-Fi do Android e detalhes da conexão ativa quando o aplicativo tem permissão. Apenas lê o estado da rede. |
get_locationLocalização e navegação | Leitura sensível | Exige aprovação | Obtém a localização atual do dispositivo Android enquanto o FoneClaw está em uso. Exige apenas permissão de localização em primeiro plano. |
location_search_nearby_placeLocalização e navegação | Leitura sensível | Exige aprovação | Pesquisa locais próximos candidatos para um nome ambíguo usando a localização atual. Use somente quando o usuário pedir para encontrar, verificar, identificar, escolher ou navegar até um local, ou quando o destino de navegação for ambíguo. Ao criar um evento, preserve o nome de local fornecido em locationName e não pesquise endereço ou coordenadas apenas porque estão ausentes. |
map_navigateLocalização e navegação | Efeito externo | Exige aprovação | Abre uma rota ou tela de navegação em um aplicativo de mapas para um destino e modo de transporte. Inicia um aplicativo externo, usa somente os argumentos fornecidos e não lê dados do dispositivo. |
mail_account_listE-mail | Baixo | Automática | Lista contas de e-mail configuradas. Deixe query vazio para listar todas. Com query, a prioridade é ID da conta, e-mail, alias e depois correspondência aproximada de alias ou e-mail. Mesmo correspondências exatas podem retornar várias contas. |
mail_account_saveE-mail | Controle do dispositivo | Exige aprovação | Testa as conexões IMAP e SMTP e salva a conta somente se ambas funcionarem. Chame assim que todos os campos obrigatórios estiverem disponíveis. Exige aprovação do usuário. |
mail_deleteE-mail | Destrutivo | Exige aprovação | Move até 20 messageRefs exatas para a lixeira ou as exclui permanentemente somente quando o usuário pedir exclusão definitiva de forma explícita. Nunca repita uma tentativa cujo resultado seja incerto. |
mail_listE-mail | Baixo | Automática | Lista, filtra ou pesquisa resumos de mensagens. query procura em assunto, remetente, destinatários e corpo. Deixe accountId vazio para usar a única conta ou a conta padrão identificada sem ambiguidade. |
mail_readE-mail | Leitura sensível | Exige aprovação | Lê uma mensagem por uma messageRef retornada por mail_list e a marca como lida no servidor. Após o sucesso, resuma a mensagem para o usuário na mesma resposta. |
mail_sendE-mail | Efeito externo | Exige aprovação | Envia um novo e-mail, responde, responde a todos ou encaminha. Exige aprovação. Anexos devem usar os metadados estruturados exatos fornecidos com a mensagem atual do usuário. |
call_log_missedComunicação e contatos | Leitura sensível | Exige aprovação | Lê chamadas perdidas recentes. Use antes de pedidos como retornar a chamada perdida. Depois de selecionar um número, chame phone_dial(phoneNumber) e use get_screen_info e tap_node no discador. |
call_log_recentComunicação e contatos | Leitura sensível | Exige aprovação | Lê entradas recentes do histórico de chamadas do Android. Exige READ_CALL_LOG. Use antes de responder quem ligou recentemente ou de escolher uma chamada para retornar. |
contacts_listComunicação e contatos | Leitura sensível | Exige aprovação | Lista uma quantidade limitada de contatos do Android. Exige READ_CONTACTS. Use somente quando o usuário pedir explicitamente para ver os contatos. |
contacts_searchComunicação e contatos | Leitura sensível | Exige aprovação | Pesquisa contatos do Android pelo nome exibido ou número de telefone. Exige READ_CONTACTS. Use antes de discar quando o usuário fornecer o nome de um contato. |
phone_dialComunicação e contatos | Efeito externo | Exige aprovação | Verifica se o número existe nos contatos e abre o discador do sistema com o número preenchido. Depois, use get_screen_info, identifique o botão de chamada visível e chame tap_node. Se o botão não estiver claro ou a tela não for o discador, pare e peça ao usuário para continuar manualmente. |
phone_dial_contactComunicação e contatos | Efeito externo | Exige aprovação | Encontra um contato pelo nome e abre o discador com seu número. Use quando o usuário pedir para ligar para um contato nomeado. Se houver várias correspondências, mostre as opções e peça uma escolha. Depois, use get_screen_info, identifique o botão de chamada e chame tap_node. |
send_to_sms_messageComunicação e contatos | Efeito externo | Exige aprovação | Após aprovação, abre um rascunho visível de SMS ou MMS. Em um SMS de texto com destinatário, toca automaticamente em Enviar somente se a acessibilidade estiver conectada e o aplicativo padrão, o destinatário, o texto completo e um único controle estável de envio forem verificados. Anexos, seleção de SIM, interface ambígua ou acessibilidade indisponível exigem ação manual. Após um resultado final, interrompa o planejamento e não chame get_screen_info nem tap_node. |
sms_listComunicação e contatos | Leitura sensível | Exige aprovação | Consulta mensagens SMS atuais neste dispositivo. Sem keyword, address, contact ou threadId, lista as recentes. Use esses campos para pesquisar e defina threadId somente com um valor obtido antes por sms_list. Para resumos, chame uma vez com box=all e resuma mensagens recebidas e enviadas. Não substitua o resultado atual pelo histórico do SysInfo. |
calendar_create_eventCalendário | Efeito externo | Exige aprovação | Cria um evento no calendário Android. Reúna horário e lembrete ausentes antes da chamada. Um nome de local fornecido pelo usuário é suficiente e deve ser enviado em locationName; só pesquise endereço ou coordenadas quando houver pedido explícito. Prefira startLocalDateTime e endLocalDateTime no formato yyyy-MM-dd HH:mm, interpretado no fuso do dispositivo. Não use milissegundos de época calculados pelo modelo. Use calendarId=0, salvo se o usuário escolher outro calendário. Depois, informe os horários actualStart e actualEnd retornados. |
calendar_delete_eventCalendário | Destrutivo | Exige aprovação | Exclui um evento do calendário Android por ID. Pesquise eventos em todos os calendários com calendarId=0, salvo se o usuário escolher outro. Envie título, startMillis, endMillis e localização conhecidos para identificar o alvo sem ambiguidade. |
calendar_list_calendarsCalendário | Leitura sensível | Exige aprovação | Lista calendários Android graváveis. Use para permitir que o usuário escolha um calendário; não presuma que calendarId=1 seja o calendário local ou desejado. |
calendar_list_eventsCalendário | Leitura sensível | Exige aprovação | Lista eventos do calendário Android em um período concreto. Use para agendas de hoje, amanhã, da semana ou eventos existentes. Prefira startLocalDateTime e endLocalDateTime em yyyy-MM-dd HH:mm no fuso do dispositivo. Use startMillis e endMillis apenas como alternativa legada quando vierem de uma ferramenta confiável. Use calendarId=0 para todos os calendários, salvo escolha explícita. |
calendar_open_eventCalendário | Leitura sensível | Exige aprovação | Abre a página de detalhes de um evento do calendário Android pelo ID. Pesquise ou liste eventos primeiro quando o usuário descrevê-lo em linguagem natural. Não adivinhe o ID. |
calendar_search_eventsCalendário | Leitura sensível | Exige aprovação | Pesquisa eventos do calendário Android por palavra-chave em um período concreto. Use antes de abrir, atualizar ou excluir um evento descrito por título ou conteúdo. Prefira datas locais no formato yyyy-MM-dd HH:mm; use milissegundos apenas quando vierem de uma ferramenta confiável. Pesquise todos os calendários com calendarId=0, salvo escolha explícita. |
calendar_update_eventCalendário | Efeito externo | Exige aprovação | Atualiza um evento do calendário Android por ID. Pesquise ou liste primeiro quando o alvo for descrito em linguagem natural e envie os detalhes conhecidos junto com as alterações. Não adivinhe calendarId nem o ID do evento. Campos de texto vazios são ignorados; startMillis/endMillis=0 preserva os horários; reminderMinutes=-2 mantém, -1 remove e valores a partir de 0 substituem os lembretes. |
memo_createNotas | Controle do dispositivo | Exige aprovação | Cria uma nota, lembrete ou tarefa local visível ao usuário. Use quando ele pedir explicitamente para guardar o conteúdo como nota prática. Não use para salvar ou consultar memória de perfil gerenciada pelo agente, como preferências, identidade, relações ou estilo de resposta. |
memo_deleteNotas | Destrutivo | Exige aprovação | Faz a exclusão reversível de uma nota local pelo ID. Pesquise ou liste notas primeiro quando o usuário descrever o alvo em linguagem natural, para conhecer seu ID e título. |
memo_listNotas | Leitura sensível | Exige aprovação | Lista notas locais visíveis ao usuário. status pode ser active, done, archived ou all. Não use para responder o que o agente lembra sobre o usuário, preferências de perfil ou histórico da conversa. Um resultado vazio indica apenas que não há notas locais correspondentes. |
memo_mark_doneNotas | Controle do dispositivo | Exige aprovação | Marca uma nota local como concluída ou ativa pelo ID. |
memo_searchNotas | Leitura sensível | Exige aprovação | Pesquisa notas locais visíveis por palavra-chave no título, conteúdo ou tags. status pode ser active, done, archived ou all. Não use para pesquisar memória de perfil gerenciada pelo agente nem histórico da conversa. Um resultado vazio se refere apenas ao repositório de notas. |
memo_updateNotas | Controle do dispositivo | Exige aprovação | Atualiza uma nota local pelo ID. Pesquise ou liste primeiro quando o alvo for descrito em linguagem natural e envie os detalhes conhecidos com as alterações. Título, conteúdo e tags vazios são ignorados; reminderAtMillis=-2 mantém, -1 remove e valores acima de 0 definem o lembrete. |
sysinfo_brief_sourcesInformações do sistema | Leitura sensível | Exige aprovação | Obtém fontes locais do SysInfo para um resumo diário. Lê dados locais já capturados e não inicia uma nova coleta. |
sysinfo_mark_reviewedInformações do sistema | Controle do dispositivo | Exige aprovação | Marca eventos locais do SysInfo como revisados após a confirmação do usuário. |
sysinfo_notification_queryInformações do sistema | Leitura sensível | Exige aprovação | Consulta notificações Android já capturadas quando o usuário pedir um período especial, como ontem ou os últimos N minutos, ordem da mais antiga para a mais nova ou todas as atualizações em vez de notificações agrupadas. Para um resumo comum de hoje, use sysinfo_today_brief. Lê apenas eventos de notificação e nunca abre o painel. |
sysinfo_searchInformações do sistema | Leitura sensível | Exige aprovação | Pesquisa dados locais já capturados pelo SysInfo usando uma palavra-chave. Não examina fontes do sistema. |
sysinfo_threadInformações do sistema | Leitura sensível | Exige aprovação | Carrega eventos locais já capturados pelo SysInfo em uma threadKey. |
sysinfo_today_briefInformações do sistema | Leitura sensível | Exige aprovação | Lê notificações já capturadas hoje para análise do LLM. Use quando o usuário pedir para ler, listar, revisar, verificar ou resumir notificações, itens não lidos ou importantes, acontecimentos de hoje, pendências, resumo diário, mensagens perdidas ou próximas ações. Retorna fonte, título, prévia, horário, importância e sugestões. Depois, produza uma resposta clara no idioma do usuário, sem apenas repetir a saída bruta. Para uma janela explícita dos últimos N minutos, use sysinfo_notification_query. Nunca abra nem leia a interface do painel de notificações para esses pedidos. |
shopping_compareWeb e compras | Baixo | Automática | Pesquisa resultados públicos da web para um produto em plataformas de compras e retorna evidências de comparação. Use antes de dar orientações sobre preços. |
web_fetchWeb e compras | Baixo | Automática | Acessa uma página web específica pelo URL e retorna o texto legível. |
web_searchWeb e compras | Baixo | Automática | Pesquisa páginas relevantes na web. Retorna títulos, URLs e trechos curtos dos resultados. |
shortcut_save_agent_promptTarefas, Workflows e atalhos | Controle do dispositivo | Exige aprovação | Salva um atalho criado pelo usuário que envia um prompt ao agente. Chame somente depois que o usuário confirmar título, descrição e comportamento. |
shortcut_save_direct_toolTarefas, Workflows e atalhos | Controle do dispositivo | Exige aprovação | Salva um atalho criado pelo usuário para executar ferramentas diretamente. Use somente quando todas as ações pedidas puderem ser mapeadas integralmente para etapas conhecidas, com parâmetros completos. |
task_createTarefas, Workflows e atalhos | Baixo | Automática | Cria de uma só vez o plano TODO completo e ordenado para o pedido atual. É obrigatório antes de qualquer ferramenta não relacionada a tarefas quando o pedido exigir três etapas ou mais. Envie todas as etapas limitadas e visíveis ao usuário em items. O plano só pode ser criado uma vez e não pode ser ampliado. Não inclua gerenciamento, limpeza, atualização de status nem resposta final. |
task_listTarefas, Workflows e atalhos | Baixo | Automática | Lista itens TODO internos do pedido atual. Por padrão, retorna itens open, in_progress e blocked. |
task_updateTarefas, Workflows e atalhos | Baixo | Automática | Atualiza um item TODO interno. Transições permitidas: open para in_progress, blocked ou abandoned; in_progress para blocked, done ou abandoned; blocked para open ou abandoned. done e abandoned são finais. Apenas uma tarefa pode estar in_progress. |
workflow_deleteTarefas, Workflows e atalhos | Destrutivo | Exige aprovação | Exclui um Workflow salvo pelo ID. |
workflow_listTarefas, Workflows e atalhos | Leitura sensível | Exige aprovação | Lista Workflows salvos. |
workflow_saveTarefas, Workflows e atalhos | Controle do dispositivo | Exige aprovação | Salva um Workflow reutilizável. stepsJson deve ser um array JSON de objetos {toolName, arguments}. |
add_skillSkills e plugins | Controle do dispositivo | Exige aprovação | Adiciona um novo documento de Skill ao registro de Skills. |
disable_skillSkills e plugins | Controle do dispositivo | Exige aprovação | Desativa uma Skill do usuário para que ela não apareça no prompt do agente. |
enable_skillSkills e plugins | Controle do dispositivo | Exige aprovação | Ativa uma Skill válida do usuário para que o agente possa usá-la. |
list_skillsSkills e plugins | Leitura sensível | Exige aprovação | Lista Skills do usuário e do sistema com origem, estado de ativação e estado de validação. |
load_skill_detailSkills e plugins | Leitura sensível | Exige aprovação | Carrega uma Skill especializada quando a tarefa corresponde a uma das Skills presentes no prompt do sistema. Injeta na conversa atual as instruções e os recursos da Skill, que podem incluir orientações detalhadas de Workflow e referências a scripts ou arquivos do mesmo diretório. O nome deve corresponder exatamente a uma Skill listada no prompt. |
plugin_request_installSkills e plugins | Efeito externo | Exige aprovação | Cria uma proposta estruturada de instalação para um plugin oficial. Não baixa nem instala o plugin; a HomeScreen deve consultar o usuário. |
plugin_searchSkills e plugins | Baixo | Automática | Pesquisa metadados oficiais de plugins do FoneClaw quando o usuário pedir um recurso ausente da lista atual de ferramentas. Pesquisa apenas metadados e nunca baixa nem instala plugins. |
preview_skill_importSkills e plugins | Baixo | Automática | Visualiza um documento SKILL.md colado. Faz a análise e a validação, mas não salva. |
remove_skillSkills e plugins | Destrutivo | Exige aprovação | Remove a Skill. |
save_skill_draftSkills e plugins | Controle do dispositivo | Exige aprovação | Salva um documento SKILL.md como rascunho desativado de Skill do usuário. |
update_skillSkills e plugins | Controle do dispositivo | Exige aprovação | Atualiza um documento de Skill existente no registro. |
Nenhuma ferramenta corresponde à pesquisa.
Você não precisa ter uma API própria. A configuração do modelo altera o mecanismo de raciocínio; o FoneClaw continua sendo o agente Android que executa a tarefa no telefone.
Comece imediatamente, sem fornecer suas próprias credenciais de API.
Adicione um modelo compatível com OpenAI usando API Base URL e API Key.
Use a opção de importação do Hugging Face no aplicativo para adicionar um modelo local compatível.
As configurações oferecem controles de dados locais, permissões sob demanda, seleção de modelo e comportamento de aprovação das ferramentas.
O FoneClaw solicita a permissão específica do Android somente quando a tarefa pedida precisa dela.
Escolha Auto approve, Follow tool policy ou Deny all de acordo com o nível de autonomia desejado.
Revise memória, informações de contas de terceiros, coleta de dados do agente, detecção de imagens e permissões nas Configurações.
Perguntas frequentes sobre os recursos do FoneClaw.
O catálogo público no GitHub inclui mais de 120 ferramentas internas em 11 grupos, entre elas verificações do dispositivo, SMS, chamadas, configurações do sistema, Wi-Fi e Bluetooth, capturas de tela, e-mail, calendário, mapas, tarefas web, Workflows e Skills.
Não. Quando uma tarefa precisa de uma permissão, o FoneClaw solicita esse acesso específico e orienta você a ativá-lo. Depois, é possível revisar as permissões nas Configurações.
O FoneClaw pode preparar e executar ações de comunicação compatíveis. A necessidade de aprovação depende do Modo de Aprovação de Ferramentas selecionado e da política aplicável à ferramenta.
Não. E-mail requer configuração IMAP/SMTP, mapas precisam de um aplicativo instalado, o resumo automático de imagens exige permissões de detecção e sobreposição, e algumas configurações do Android requerem permissões adicionais. Recursos básicos, como status do telefone, resumo de SMS e configurações do sistema, funcionam sem configuração extra.
Não. Você pode usar o modelo padrão gratuito do FoneClaw. Também pode configurar um modelo online popular com API Base URL e API Key ou importar um modelo local compatível.
Baixe o FoneClaw e teste seu conjunto público de ferramentas Android, as permissões sob demanda e tarefas práticas do dia a dia.
