Guia para iniciantes do PetClaw

Se você ainda não instalou o PetClaw, clique no botão de download no site oficial e escolha a versão compatível com o seu dispositivo. Se estiver em um Mac, confira antes se a máquina usa Apple Silicon ou Intel. Se estiver no Windows, escolha a versão do Windows. Quando o download terminar, volte a este guia e continue com os passos de configuração abaixo.

Este guia apresenta passo a passo o fluxo principal da primeira configuração do PetClaw.

Ao final, você terá uma visão mais clara de:

• quais telas aparecem na primeira abertura do app
• quais configurações vale a pena concluir primeiro
• quando você já estará pronto para começar a usar o PetClaw de verdade

Fluxo geral

Para a maioria dos novos usuários, a primeira experiência de uso pode ser entendida em cinco etapas:

1. Entrar e conectar o app à sua conta
2. Deixar o PetClaw concluir a preparação do runtime e a instalação
3. Conceder as permissões necessárias para voz e interação com o desktop
4. Preencher o seu perfil básico e revisar as habilidades integradas recomendadas
5. Testar o atalho de voz e a entrada por diálogo com uma primeira tarefa real

Etapa 1: Faça login e entre no onboarding

Depois de instalar o PetClaw, a primeira tela que você normalmente verá será a de login. Essa etapa conecta o app à sua conta para que o progresso da configuração e as suas preferências futuras sejam salvos corretamente.

Você pode entrar com Google ou usar verificação por e-mail. Para a maioria das pessoas, a melhor escolha é simplesmente a mais rápida.

Depois de entrar, o PetClaw pode continuar com o fluxo de onboarding e começar a preparar o app para o uso real.

Etapa 2: Deixe o PetClaw terminar a preparação do runtime e a configuração básica

Depois do login, o PetClaw pode guiá-lo por verificações de ambiente e preparação do runtime, como preparar o Node.js, instalar o runtime local, configurar componentes relacionados à IA e iniciar o fluxo de conexão local.

Essa etapa mostra o trabalho central de configuração que o PetClaw está executando em segundo plano para que o app rode bem no seu computador.

Se essa etapa terminar normalmente, o PetClaw terá passado de "apenas baixado" para "tecnicamente pronto para ser configurado e usado".

Etapa 3: Conceda as permissões de que o PetClaw precisa

A etapa seguinte é a de permissões. Na prática, duas delas são as mais importantes no começo:

• Permissões de acessibilidade, para que o PetClaw trabalhe de forma mais natural no seu desktop
• Permissões de microfone, para que a entrada por voz e as interações ativadas por voz funcionem corretamente

A primeira tela explica por que essas permissões são importantes e o que elas liberam.

Depois que você terminar de concedê-las, a página entrará em estado de concluída, o que significa que o caminho de interação mais importante já está pronto.

Etapa 4: Preencha o seu perfil e revise as habilidades recomendadas

O PetClaw então pedirá algumas informações pessoais básicas, como o nome pelo qual deve chamar você e qual papel combina melhor com o seu cenário diário de vida ou trabalho.

Isso dá ao PetClaw um contexto leve para que o app pareça mais natural desde o início.

Depois disso, o PetClaw mostra habilidades integradas e capacidades recomendadas para casos de uso comuns. Você pode pensar nisso como o primeiro lote de recomendações do sistema com base na sua configuração e no seu perfil.

Neste ponto, não se espera que você aprenda tudo. Basta identificar um ou dois pontos de partida úteis.

Etapa 5: Teste o atalho de voz e a entrada por diálogo com uma tarefa real

Antes de começar a usar o PetClaw todos os dias, o onboarding costuma oferecer uma tarefa de exemplo simples para você testar imediatamente, como pedir um resumo das notícias de IA de hoje.

Isso é importante porque move você da configuração para o uso real. Em vez de apenas ler páginas de configuração, você começa a sua primeira interação de verdade.

Você também verá a tela de teste de atalho de voz e entrada, onde poderá confirmar:

• qual atalho ativa o modo de voz
• se a entrada do microfone funciona
• se o fluxo de entrada por diálogo parece usável na sua máquina

Este é o ponto em que o PetClaw deixa de ser "um app que acabei de instalar" e começa a virar "um assistente que eu realmente posso usar".

Melhores primeiras tarefas para experimentar

Depois de concluir o onboarding, comece com pedidos pequenos e concretos. Alguns bons primeiros exemplos incluem:

• "Resuma as notícias mais recentes de IA de hoje."
• "Ajude-me a anotar as três coisas mais importantes de hoje."
• "Lembre-me da minha reunião das 4 PM."
• "Ajude-me a redigir uma resposta educada."
• "Transforme este parágrafo em tópicos principais."

Quando o onboarding está realmente concluído

Para a maioria dos usuários, o onboarding está concluído quando tudo isso é verdade:

• você consegue entrar
• a preparação do runtime terminou com sucesso
• as permissões necessárias foram concedidas
• o seu perfil básico foi configurado
• você viu as habilidades integradas recomendadas
• você concluiu pelo menos um teste de voz ou entrada por diálogo

Nesse momento, o PetClaw deixa de ser apenas um software recém-instalado. Ele está pronto para se tornar parte do seu fluxo de trabalho diário.