Manual de operação do XIRO: instale, use e resolva

01 · FINALIDADE

Para que serve este manual

Use-o como o primeiro lugar para consultar os cuidados de rotina e as correções de primeira resposta. O guia de campo explica o que dizer. Este manual explica como mantê-lo funcionando.

Princípio	O que significa na prática
Olhe antes de mudar	Abra o FLOW (Ctrl + F) primeiro. Ele mostra onde um pedido parou e por quê.
Nunca "conserte" uma recusa desligando a segurança	Descubra se foi você que disse não, se uma regra recusou, se uma chave acabou ou se falta alguma coisa.
Permissão mínima	Mantenha a política de permissões em Inteligente (Smart). Não use Sempre permitido para evitar perguntas.
Proteja o que ele sabe	Configurações, memória, cofre e logs são pessoais. Faça backup e mantenha-os privados.
Confira o resultado, não a resposta	Um "pronto" falado não é prova. Abra o arquivo, confira a mensagem, olhe o dispositivo.

02 · ANTES DE COMEÇAR

O que vale saber no primeiro dia

Para a voz, é preciso uma chave Gemini. Mesmo que você use um modelo local para trabalhos digitados, a conversa por voz ao vivo roda no Google Gemini com a sua chave.

"Sempre permitido" significa tudo mesmo. Ele pula a pergunta até para apagar, enviar e instalar. Use-o apenas num computador de confiança e para uma tarefa curta.

Uma cópia por usuário do Windows. Abrir o XIRO duas vezes mostra "já está em execução". Use a janela que já está aberta.

O controle pelo celular é para o seu próprio Wi-Fi. Nunca o deixe acessível pela internet.

03 · INSTALAÇÃO

Instalando o XIRO

Passo	Faça isto	Observações
1	Baixe o instalador pelo link do e-mail de compra ou do portal de licenças.	Um único arquivo, `XIRO-Setup-version.exe`.
2	Execute-o e siga as etapas.	Instala só para o seu usuário do Windows, portanto não exige direitos de administrador. Opcional: ícone na área de trabalho, iniciar ao entrar no Windows.
3	Abra o XIRO pelo menu Iniciar.	A tela de ativação aparece primeiro.

Onde fica	Pasta
O app, as configurações e a memória	`%LOCALAPPDATA%\Programs\XIRO`
Lembretes, rotinas, modelos de rosto e de voz, dados do controle parental	`%USERPROFILE%\.xiro`
Trabalhos do escritório de IA (a menos que você indique um local)	A pasta do escritório definida nas Configurações, normalmente em Documentos

Para desinstalar, use Configurações do Windows → Aplicativos. As pastas de dados permanecem, então uma reinstalação mantém a sua memória. Libere o dispositivo no portal de licenças antes, se for aposentar o computador.

04 · ATIVAÇÃO

Ativando a sua licença

Situação	O que fazer
Primeira abertura	Clique em Sign in with Google (Entrar com o Google), entre com a conta usada no pagamento, confira se o código é o mesmo e escolha Authorize this PC (Autorizar este PC). Ou clique em I have a licence key (Tenho uma chave de licença), cole a sua chave (começa com `XIRO-`) e clique em Activate (Ativar). O computador passa a ser um dos seus três.
"Os três dispositivos estão em uso"	Abra o portal de licenças, desconecte um computador que você não usa mais e ative de novo.
Computador novo ou reformatado	Libere o antigo no portal, instale, ative.
Sem internet	O XIRO continua funcionando por duas semanas entre as verificações. Conecte-se uma vez nesse período.
Chave perdida	Procure "XIRO-" no seu e-mail, use Reenviar no portal ou fale com o suporte a partir do e-mail da compra.

05 · CONFIGURAÇÃO INICIAL

Configurando do seu jeito

Configuração	Onde	Dica
Nome, tratamento, idiomas, voz, estilo	O assistente de configuração; depois, Sistema → Preferências do app	Coloque o seu idioma principal primeiro e diga se o XIRO deve acompanhar você quando você trocar de idioma.
Chaves de IA	Inteligência → Modelos e chaves (F8)	Adicione mais de uma chave Gemini para o XIRO passar para a próxima quando uma acabar.
Microfone, alto-falantes, foco de voz, palavra de ativação, aperte para falar	Sistema → Preferências do app → Dispositivos de áudio	"Perto do microfone" ignora a TV e o ambiente.
Rosto, voz, PIN, cofre	Sistema → Configuração biométrica	Defina também um PIN. Ele é o reserva e protege a redefinição do cofre.
Política de permissões	Sistema → Preferências do app → Permissões	Deixe em Inteligente.
Sua região e moeda	Você e sua região	Usadas para preços, dinheiro do quiz e notícias locais.
Pasta do escritório	Configurações do escritório	Onde vai o trabalho pronto quando você não indica um local.

06 · INICIAR, PARAR, RECARREGAR

Use a menor ação que resolve o problema

Você precisa…	Faça isto	O que acontece
Parar tudo agora mesmo	STOP no HUD, ou Esc	A resposta, a tarefa em andamento, o som e a mídia param. Nada recomeça.
Silenciar o microfone	F4 ou o anel MIC	O XIRO deixa de ouvir você. A fala dele é silenciada à parte, com OUT.
Ficar em paz por um tempo	DND, ou diga "não perturbe por uma hora"	Sem escuta, sem pop-ups, sem sons até acabar.
Recomeçar do zero com todas as mudanças aplicadas	SYNC, F5 ou Ctrl + R	Uma reinicialização de verdade. A tela de bloqueio aparece de novo, se você usa uma.
Fechar o XIRO	Feche a janela normalmente	Tudo é salvo. Evite encerrá-lo pelo Gerenciador de Tarefas.

Continua depois do STOP	Por quê	Como parar
Trabalho dado a um colega do escritório	Roda no escritório, não na conversa.	Termina sozinho. Confira o escritório.
Modo reunião	Está gravando uma reunião de propósito.	"Encerre a reunião."
Respostas do balcão de pedidos	Clientes de verdade estão sendo atendidos.	"Desligue o balcão."
Lembretes agendados	Chegam na hora marcada.	Cancele o lembrete.

07 · USO DIÁRIO

Um ritmo simples que mantém os problemas visíveis

Começo do dia

Veja se o XIRO diz que está conectado.
Confira MIC e OUT.
Responda aos lembretes pendentes.
Dê uma olhada no indicador de chaves.

Durante o trabalho

Um objetivo, com o destino do resultado.
Responda só ao pedido que está na sua frente.
Confira resultados, não respostas.
Use STOP antes de mudar de rumo.

Fim do dia

Veja o que estiver vermelho no FLOW.
Recolha o trabalho do escritório.
Faça backup se muita coisa mudou.
Feche normalmente.

Uma boa instrução inclui	Exemplo
O que você quer produzir	"Um currículo de duas páginas em Word."
O que usar	"Use as minhas anotações; não invente datas."
Para onde vai	"Salve na minha Área de trabalho como Curriculo.docx."
Como conferir	"Me diga o caminho onde salvou."
O que não fazer	"Não envie; só salve."

08 · PERMISSÕES

Escolhendo com que frequência o XIRO pergunta

Política	Comportamento	Use para
Inteligente (Smart) (padrão)	Ler nunca pergunta, alterar pergunta uma vez por sessão, apagar e enviar perguntam sempre.	Uso do dia a dia
Perguntar sempre	Toda alteração pergunta, todas as vezes. Ler continua sem perguntar.	Um computador compartilhado ou sensível
Uma vez por sessão	Tudo pergunta uma vez por sessão, inclusive apagar.	Sessões com as mãos livres numa máquina de confiança
Sempre permitido	Nada pergunta, nem apagar, enviar ou instalar.	Raramente, por pouco tempo, numa máquina de confiança

Leia a ação e o alvo na pergunta. Um alvo vago é motivo para dizer não.
Uma pergunta sem resposta por dois minutos conta como não.
Se o XIRO leu uma página da web ou um documento naquele turno, um sim anterior é perguntado de novo, para que o texto da página não reaproveite a sua permissão.

09 · VOZ E ÁUDIO

Ouvindo você, e só você

Foco de voz	O que passa	Use quando
Perto do microfone (padrão)	A fala perto do microfone. A TV, a música e as pessoas do outro lado da sala são ignoradas.	Uso normal na mesa
Qualquer fala	Toda fala, mas não ruído.	Você fala de longe
Tudo	Todo som.	Para checar se o foco está cortando as suas palavras

Sintoma	Verifique	Solução
Parece não ouvir	O anel MIC, a privacidade do microfone no Windows, o dispositivo escolhido	Reative o som (F4), permita o microfone, escolha o dispositivo certo
Ouve a si mesmo	Volume dos alto-falantes, eco	Use um fone com microfone ou abaixe o volume
Ignora a palavra de ativação	A palavra exata definida em Dispositivos de áudio	Diga-a com clareza ou desligue a palavra de ativação
A palavra de ativação offline nunca o acorda	A linha sob a palavra, no cartão WAKE WORD	Pressione DOWNLOAD para essa palavra e depois SAVE & CONNECT. “Hey XIRO” precisa antes do seu próprio modelo pequeno treinado
Não ouve nada com o aperte-para-falar ligado	O cartão PUSH-TO-TALK: a tecla é a que você está segurando?	Segure a tecla (ou o anel TALK) durante toda a fala, ou desmarque o aperte-para-falar e pressione SAVE & CONNECT
Responde à TV	A configuração de foco de voz	Defina Perto do microfone e pressione F5
Aparece texto, mas sem voz	O anel OUT, o dispositivo de saída do Windows	Reative o som de OUT, escolha alto-falantes que funcionem

10 · MODELOS DE IA E CHAVES

Mantendo a IA disponível

Estado da chave (F8)	Significado
IN USE	A chave que o XIRO está usando agora.
READY	Ligada e em boa saúde, a próxima da fila.
RESTING	O Google disse que esta chave atingiu o limite. O XIRO espera o tempo indicado.
BUDGET USED	Passou do orçamento diário que você definiu.
OFF	Desligada por você e guardada para depois.
REJECTED	O Google recusou a chave. Confira-a ou troque-a.

Para…	Faça isto
Trocar de chave agora	USE NOW no cartão da chave.
Deixar o XIRO passar para a próxima sozinho	Marque "Auto-switch when a key runs out" (ligado por padrão).
Limitar o uso diário de uma chave	Defina BUDGET / DAY no cartão dela.
Trocar uma chave	EDIT, cole a nova chave, SAVE KEY.
Ver o uso em relação aos limites	Passe o mouse sobre o indicador de chaves no HUD ou pressione Ctrl + M.

"Limite ainda não visto" é normal. O Google só informa um limite quando ele é atingido, e o XIRO nunca chuta um.

11 · O ESCRITÓRIO DE IA

Dirigindo a equipe

Passo	Faça isto	Confira
Definir	Diga o que você quer produzir, para quando e onde salvar.	A tarefa aparece no cartão do colega.
Atribuir	"Peça a [nome] para [tarefa]", ou deixe o Chefe de Gabinete escolher.	O colega aparece como WORKING só enquanto o trabalho realmente está rodando.
Acompanhar	Abra o escritório ou pergunte "No que [nome] está trabalhando?"	O quadro da equipe mostra decisões, arquivos e revisões.
Recolher	Abra a pasta que o XIRO indicar quando terminar.	Uma pasta, com um README e o relatório de QA.

Movimento não é prova de trabalho. As pessoas andando no piso 3D são uma imagem do escritório. Os arquivos prontos são a evidência.

12 · O BALCÃO DE PEDIDOS

Configurando e operando o atendimento

Canal	Você precisa de	Observações
WhatsApp	Um número comercial na API WhatsApp Cloud da Meta e um endereço web público para receber as mensagens	Texto, mensagens de voz e fotos
Telegram	Um token de bot	Texto e voz
Messenger	Um app da Meta vinculado à sua página	Texto
Instagram	O mesmo app da Meta, vinculado à sua conta	Somente texto

Adicione itens, preços, taxa de entrega, horários, limites e regras por voz ou na tela do balcão.
Ensaie: "Teste o balcão com [mensagem]" responde sem enviar nada e sem registrar pedido.
"Verifique a configuração do balcão" lista o que ainda falta em cada canal.
"Ligue o balcão." Desconhecidos serão atendidos em seu nome, e é por isso que isso pergunta todas as vezes.
No dia a dia: "Mostre os pedidos de hoje" e assuma qualquer conversa que precise de você.
No WhatsApp, o painel Business (Ctrl + Shift + B) mostra tudo numa só janela. As pílulas no topo ficam âmbar ou vermelhas quando a API, o token, o webhook ou o balcão precisam de atenção. Clique numa delas para ver o motivo.

13 · CONTROLE PELO CELULAR

Pareando e mantendo o controle seguro

Passo	Faça isto
1	Coloque o celular e o computador no mesmo Wi-Fi de confiança. Redes de visitantes costumam bloquear isso.
2	Abra Remote Control no XIRO. Aparece um QR code de uso único.
3	Escaneie-o e confie no certificado de segurança, se o celular pedir.
4	Permita o microfone somente para a página do XIRO.
5	Envie um teste inofensivo, como "que horas são?"

Problema	Solução
O QR não faz nada	Confira se os dois estão no mesmo Wi-Fi e permita o XIRO no firewall do Windows.
A página carrega, mas o microfone não funciona	Confie no certificado nas configurações do celular e depois permita o microfone.
O código expirou	Gere um novo. Os códigos funcionam uma única vez.

14 · SEUS DADOS

O que o XIRO guarda, e onde

Dados	Onde	Sensibilidade
Configurações e chaves de IA	A pasta de instalação do XIRO	Secreto
Memória, conhecimento, contatos, trabalhos do escritório, cofre	A pasta de instalação do XIRO	Pessoal
Lembretes, rotinas, modelos de rosto e de voz	`%USERPROFILE%\.xiro`	Pessoal
Regras e capturas de tela do controle parental	`%USERPROFILE%\.xiro`	Só os pais
Logins salvos do navegador usados pelo XIRO	O seu perfil de usuário	Como senhas
Trabalhos prontos do escritório	A pasta que você indicou ou a pasta do escritório	Seus documentos

O mapa de memória (MAP, Ctrl + Shift + M) mostra tudo o que o XIRO guarda, em sete visões. RINGS numera as áreas em ordem, as mais novas por dentro. Duas são em 3D: 3D MIND, uma esfera giratória com todas as memórias e ligações, com luz correndo pelas ligações, e 3D SPACE, um mapa mental ao redor do XIRO (clique num nó para abrir ou recolher; Expand all, Collapse, Fit e Labels ficam no canto dele, e L esconde ou mostra os rótulos em todas as visões; arraste para girar, use a rolagem para ampliar). Em nenhuma visão ele mostra o que há dentro do cofre, o que foi dito ou as suas chaves.

15 · LOGS E FLOW

Descobrindo o que aconteceu

Ferramenta	Abra com	Mostra
Quadro FLOW	Ctrl + F	O caminho que o seu último pedido seguiu. Âmbar significa esperando por você, e uma estrela marca onde deu errado.
Registro FLOW (ledger)	Ctrl + F, depois L	Cada instrução por dia: concluída, parcial, com falha, respondida ou descartada, com o motivo.
Logs e auditoria	Ctrl + L	Cada ação com hora e resultado. Os segredos são removidos.
A marca ⚠	No HUD	Instruções que falharam ou funcionaram só em parte e que você ainda não viu.

Abra o FLOW e encontre o pedido.
Leia o motivo no cartão vermelho ou âmbar.
Corrija essa única coisa (aprove, adicione uma chave, dê o detalhe que faltou) e tente mais uma vez.
Continua falhando? O Export do FLOW, com uma descrição curta, é o que o suporte precisa.

16 · SOLUÇÃO DE PROBLEMAS

Sintoma, causa provável, solução

Sintoma	Causa provável	Solução
Abre, mas nunca fala	Sem chave Gemini, ou ela foi recusada	Adicione ou troque a chave no F8 e depois F5
Travado em "conectando"	Rede fora do ar, ou todas as chaves em descanso	Confira a internet; adicione uma chave; espere o tempo indicado
"Já está em execução"	Aberto duas vezes	Use a janela aberta
Disse que fez, mas não há arquivo	Respondeu sem salvar	Peça o caminho onde salvou; indique uma pasta; aprove o salvamento
Fica pedindo permissão	Apagar pergunta sempre, de propósito, ou uma página foi lida naquele turno	Aprove a ação exata. Não mude para Sempre permitido.
Instrução recusada	Você disse não, Modo Privado, ou a pergunta expirou	Olhe o FLOW e peça de novo com a tela visível
Um lembrete não para de se repetir	Está esperando o seu OK	Diga "OK" ou clique na luz REMINDER
O desbloqueio por rosto falha	Ambiente novo, pouca luz, ou o perfil precisa ser atualizado	Melhore o reconhecimento aqui (exige o seu PIN) ou configure o rosto de novo
Um modelo local não responde	O Ollama não está em execução	Inicie o Ollama e confira se o seu modelo aparece na lista
Colega do escritório parado com trabalho na fila	A fila é retomada pouco depois da inicialização	Espere um minuto após abrir e peça o relatório da equipe
O vídeo abre no navegador	O dono do vídeo bloqueia a reprodução dentro de aplicativos	Assista no navegador
3D SPACE aparece em cinza no mapa de memória	O driver de vídeo não oferece 3D nesta janela	Atualize o driver de vídeo. Enquanto isso, 3D MIND mostra o cérebro plano, que não precisa de suporte a 3D.
Disco quase cheio	Outro programa encheu a unidade	Libere espaço. O XIRO avisa antes que os logs deixem de ser gravados.

17 · BACKUP E RESTAURAÇÃO

Mantendo uma cópia segura

Para…	Faça isto
Fazer um backup	Diga "faça backup dos meus dados do XIRO com a senha [senha]" ou use a tela de Backup. Com senha, o backup é criptografado (AES-256). Feche os outros trabalhos antes, para a cópia ficar consistente.
Restaurar	Use Restaurar na mesma tela. Ele pergunta sempre, porque substitui o que está lá.
Mudar para um computador novo	Faça backup, instale no PC novo, ative, restaure. Pareie o controle pelo celular de novo.

Um backup contém as suas chaves, memória, contatos e conversas. Sempre coloque uma senha nele e nunca o guarde numa pasta compartilhada ou pública.

18 · ATUALIZAÇÕES E LICENÇA

Mantendo-se em dia

Item	Como funciona
Atualizações	Quando há uma versão nova, o XIRO a oferece. Um clique instala, e os seus dados e configurações são mantidos.
Custo	Grátis para sempre, para a sua licença.
Verificação da licença	De vez em quando, em segundo plano. Continua funcionando por duas semanas sem internet.
Dispositivos	Três de cada vez, gerenciados no portal de licenças.

19 · SEGURANÇA

Usando como o software de confiança que ele é

Use uma conta comum do Windows (sem administrador) no dia a dia.
Mantenha a política de permissões em Inteligente.
Ative o bloqueio por rosto ou voz e um PIN, e bloqueie (Ctrl + Shift + L) quando se afastar.
Use o Modo Privado ("modo privado") para tudo que não deve sair do computador.
Nunca peça ao XIRO para ler em voz alta arquivos que contenham senhas ou chaves.
Mantenha o controle pelo celular no seu próprio Wi-Fi, nunca com redirecionamento de portas.
Instale apenas skills e plugins em que você confia. Instalar um deles pergunta sempre.
Mantenha o disco do Windows criptografado (BitLocker ou Criptografia de Dispositivo).

Tipo de dado	Exemplos	Como tratar
Segredos	Chaves de IA, senhas de app de e-mail, logins salvos	Nunca colá-los em conversas; trocá-los se forem expostos
Pessoais	Memória, contatos, documentos, capturas de tela	Modo Privado para trabalho sensível; backups criptografados
Comerciais	Pedidos, clientes, trabalhos do escritório	Backups e limitar quem usa o computador

20 · BLOQUEIOS, COFRE E FAMÍLIA

Entrada, o cofre e o controle parental

Situação	Faça isto	Exige
O desbloqueio por rosto está difícil	Configuração biométrica → Melhorar o reconhecimento aqui	Seu PIN ou senha
"Face ID needs updating" (o rosto precisa ser atualizado)	Configure o acesso por rosto de novo	Desbloqueie antes com o PIN
Trocar a frase secreta do cofre	Diga a atual junto com a nova, ou Alterar frase secreta	A frase secreta atual
Esqueceu a frase secreta do cofre	Configuração biométrica → Cofre secreto → Redefinir frase secreta	Seu PIN ou senha do XIRO (e a sua voz, se você ativou isso)
Cofre bloqueado após tentativas erradas	Espere cinco minutos	—
Configurar o controle parental	Sistema → Controle parental	Um PIN dos pais, separado
Fazer as regras valerem	Dê à criança uma conta padrão do Windows e ative "Start at Windows sign-in" (iniciar ao entrar no Windows)	O PIN dos pais

21 · SE ALGO DER ERRADO

Roteiros de ação

Uma chave ou senha apareceu onde não devia

Pressione STOP e feche o XIRO.
Troque a chave ou senha no provedor dela (no caso do Gemini, no Google AI Studio).
Coloque a nova chave no F8.
Avise o suporte se achar que o XIRO a mostrou, e inclua o que você pediu.

Algo foi apagado, enviado ou alterado sem você querer

Pressione STOP.
Diga "desfaça isso" para pequenas alterações de arquivos, movimentações, renomeações e configurações.
Confira a lixeira em busca de arquivos apagados.
Olhe o FLOW para ver qual ação rodou e por quê, e guarde isso para o suporte.
Volte a política de permissões para Inteligente, se ela tiver sido alterada.

Uma página da web ou documento pareceu dar ordens ao XIRO

Diga não a qualquer pergunta e pressione STOP.
Não peça ao XIRO para lembrar ou agir com base nesse conteúdo.
Recomece com as suas próprias palavras e um alvo exato.

Um computador com o XIRO foi perdido ou roubado

Desconecte esse computador no portal de licenças, para que ele não possa mais se conectar.
Troque as suas chaves de IA, já que estavam naquele computador.
Troque as senhas das contas em que o XIRO estava conectado.

Um celular desconhecido está conectado ao controle

Feche o XIRO ou desconecte o computador da rede.
Abra Remote Control no XIRO, remova os celulares que você não reconhece (ou desfaça o pareamento de todos) e pareie o seu de novo.
Troque a senha do seu Wi-Fi se houver outra pessoa na sua rede.

22 · REFERÊNCIA RÁPIDA

Atalhos

Tecla	Função
F1	O guia dentro do app
F4	Silenciar ou reativar o microfone
F5 / Ctrl + R	Reiniciar com todas as mudanças aplicadas
F8	Modelos e chaves
F11	Tela cheia
Esc	Fecha o painel aberto; sem nenhum aberto, para tudo
Ctrl + F	FLOW: o que o XIRO está fazendo, e o registro
Ctrl + I	O terminal de informações
Ctrl + K	Pesquisar tudo
Ctrl + L	Logs e auditoria
Ctrl + M	Cotas e uso
Ctrl + N	Notificações e lembretes
Ctrl + Shift + M	O mapa de memória
Ctrl + Shift + W	Workspace: tarefas, pessoas, links e notas, saúde
Ctrl + Shift + D	O quadro de casos
Ctrl + Shift + A	O vínculo com o WhatsApp: conexão, QR, seus números, PIN e histórico
Ctrl + Shift + B	O painel WhatsApp Business
Ctrl + Shift + L	Bloquear o XIRO
Ctrl + Space (segurar)	Aperte para falar, quando ativado; a tecla pode ser trocada em Dispositivos de áudio

Precisa de ajuda? O Suporte tem soluções rápidas, o seu portal de licenças e um jeito de falar com uma pessoa.