O Kelvin no seu PC

Como ver se está tudo bem, olhar o terminal, reiniciar, parar e resolver os problemas mais comuns. Os comandos são digitados no CMD (Prompt de Comando) ou no PowerShell, em qualquer pasta.

Agora

O estado do Kelvin neste momento.

Entre no painel pra ver o estado aqui.

Como o Kelvin roda

Tem três jeitos. O instalador (instalar.bat) pergunta qual você quer; dá pra trocar quando quiser.

Recomendado

Serviço do Windows

Liga sozinho com o PC, antes mesmo de alguém entrar no Windows, e não tem janela. Se o Kelvin cair, o Windows liga de novo em 3 segundos.

Pra ver o terminal: kelvin logs -f. Abrir o iniciar.bat só mostra o aviso de que ele já está ligado.

Janela (iniciar.bat)

O jeito antigo: dois cliques no iniciar.bat e o terminal fica aberto na tela. Fechou a janela, o Kelvin desliga.

Bom pra quando você está mexendo no código e quer ver tudo na hora.

Ao entrar no Windows

Abre a janela do iniciar.bat sozinha quando você entra no seu usuário. Fica no meio do caminho: liga sozinho, mas com janela.

O dia a dia

O que você mais vai usar. Nenhum desses precisa de administrador.

Ver se está tudo bem

Conectado ou não, memória, sub-bots, se está rodando como serviço.

kelvin status

kelvin servicos

O segundo mostra se o navegador, o yt-dlp e o Go estão ligados. No painel: Resumo e Monitor.

Ver o terminal ao vivo

Tudo que o Kelvin escreve: mensagens chegando, comandos, erros.

kelvin logs -f

Ctrl+C sai (o bot continua ligado). Só as últimas linhas: kelvin logs 100. No painel: aba Console, até pelo celular.

Reiniciar o bot

Desliga e liga de novo em poucos segundos. O painel continua no ar.

kelvin reiniciar

No painel: Controles › Reiniciar (dá pra avisar os grupos antes). Com a Conexão separada ligada, o WhatsApp nem desconecta.

Abrir o painel

kelvin painel

kelvin guia

O segundo abre esta página.

Parar ou ligar o serviço

Desliga tudo (bot e painel) até você ligar de novo, ou até o PC reiniciar.

kelvin servico parar

kelvin servico ligar

O Windows pergunta se pode (administrador): aceite. Sem o kelvin: nssm stop KelvinSystem num CMD aberto como administrador.

Quando o bot nem liga

Se o kelvin status não responde, o motivo fica no arquivo do serviço.

kelvin servico

kelvin servico log

O primeiro diz se o serviço está ligado, parado ou pausado. O segundo mostra o fim do logs\servico.log.

Todos os comandos

A mesma lista do kelvin ajuda. Só funcionam no PC do bot.

Comando	O que faz
`kelvin status`	Conectado? Memória, comandos, módulos, sub-bots e como está rodando.
`kelvin servicos`	Navegador, yt-dlp e Go: ligados?
`kelvin raiox`	Os comandos que mais gastam tempo e memória, e quando o bot travou.
`kelvin logs` · `logs 200` · `logs -f`	O terminal do bot: últimas 60 linhas, últimas 200, ou ao vivo.
`kelvin reiniciar`	Reinicia o bot.
`kelvin ligar`	Liga de novo depois de "Desligar" no painel.
`kelvin servico`	Estado do serviço do Windows e se ele liga com o PC.
`kelvin servico parar` · `ligar` · `reiniciar`	Para, liga ou reinicia o serviço inteiro. Pede administrador.
`kelvin servico log`	O fim do `logs\servico.log`, pra quando o bot nem liga.
`kelvin painel` · `kelvin guia`	Abre o painel, ou esta página.
`kelvin testar ".menu"`	Roda um comando como teste (nada sai no WhatsApp). `--membro` testa como membro comum.
`kelvin recarregar <arquivo>`	Troca o código daquele arquivo sem reiniciar.
`kelvin recarga`	O que foi recarregado sozinho desde que o bot ligou.
`kelvin backup`	Cópia de segurança do banco agora (vai pra pasta `backups`).
`kelvin preparar`	Instala/atualiza o navegador, o yt-dlp e compila o Go.
`kelvin navegador entrar`	Abre o navegador pra entrar no Pinterest/Instagram. Não funciona no modo serviço (veja abaixo).
`kelvin modulos` · `modulo ligar <id>`	Lista, liga ou desliga módulos.
`kelvin instalar <origem>`	Instala módulo do npm, do GitHub, de uma pasta ou de um .zip.

Trocar de modo

Tudo isso mexe só em como o Kelvin liga. O bot, o banco e a sessão do WhatsApp ficam onde estão.

Usar a janela por um tempo (sem tirar o serviço)

Pare o serviço:
kelvin servico parar
Aceite o aviso de administrador do Windows.
Dois cliques no iniciar.bat. O terminal abre na tela, como antes.
Quando terminar: feche a janela do iniciar.bat e ligue o serviço de novo:
kelvin servico ligar
Se esquecer, ele volta sozinho quando o PC reiniciar.

Tirar o serviço de vez

Abra a pasta do bot, clique na barra de endereço, digite cmd e Enter.
Rode:
instalar.bat -Remover
Ele tira o serviço, a tarefa e o atalho. Daí em diante, ligue pelo iniciar.bat.

Instalar de novo ou trocar o modo

Dois cliques no instalar.bat. O que já está instalado é pulado.
Na última pergunta, escolha 1 (serviço), 2 (abre ao entrar no Windows) ou 3 (não ligar sozinho).

Atualizar o Kelvin

Quando chega um zip novo.

Copie os arquivos do zip pra pasta do bot, substituindo.
Na maioria das vezes não precisa fazer mais nada: o Kelvin percebe e troca sozinho. Confira com
kelvin recarga
Se aparecer "reinicie o bot pra valer", rode
kelvin reiniciar

O que mudou	O que acontece
Comandos (`commands/`, `modulos/`)	Trocam na hora.
Etapas do handler, rotas do painel	Trocam na hora.
Arquivos do painel (`lib/painel/js`, `css`, `html`)	É só recarregar a página do navegador.
Resto da `lib/`	Precisa reiniciar. Com a Conexão separada ligada (Motor › Ajustes do v4), ele mesmo reinicia sem cair do WhatsApp.
`package.json` (pacote novo)	Rode `npm install` na pasta do bot e depois `kelvin reiniciar`.

Arquivo com erro (salvou pela metade, faltou uma chave) não entra: a versão antiga continua valendo e o erro aparece no kelvin recarga e no Motor › Recarga sem reiniciar.

Deu problema

Os mais comuns, com a mensagem que aparece.

"A porta 3000 já está em uso" ao abrir o iniciar.bat

Já tem um Kelvin ligado: quase sempre é o serviço. Não precisa do iniciar.bat. Se quiser a janela, pare o serviço antes (kelvin servico parar).

Sem serviço instalado: outra janela do iniciar.bat ficou aberta, ou outro programa usa a porta. Feche, ou troque painel.porta no config.js.

"Acesso negado" no nssm ou no sc

Parar e ligar o serviço precisa de administrador. Use kelvin servico parar (ele pede a permissão), ou abra o CMD como administrador: tecla Windows, digite cmd, botão direito em Prompt de Comando › Executar como administrador.

"Uma cópia deste serviço já está sendo executada"

Não é erro: o serviço já estava ligado.

Serviço "pausado" ou não liga

O Kelvin fechou logo depois de abrir, e o Windows deu um tempo antes de tentar de novo. Veja o motivo:

kelvin servico log

Os motivos mais comuns: o iniciar.bat aberto ao mesmo tempo (porta em uso), ou o config.js sem painel.senha. Arrumou? kelvin servico reiniciar.

"kelvin não é reconhecido como um comando"

O terminal foi aberto antes de instalar. Feche e abra de novo. Se continuar, dois cliques no instalar-cli.bat da pasta do bot.

"Get-Content não é reconhecido"

Get-Content é do PowerShell, não do CMD. Use kelvin servico log, que funciona nos dois.

O "kelvin navegador entrar" não abre janela

No modo serviço o Kelvin roda escondido do Windows, então a janela do navegador não aparece. Faça assim, uma vez só:

kelvin servico parar
Abra o iniciar.bat
kelvin navegador entrar e entre nas contas
Feche o iniciar.bat e rode kelvin servico ligar

O login fica salvo na pasta database do bot.

Sub-bots "0 conectados"

Logo depois de ligar é normal: eles sobem uns segundos depois do principal conectar. Passou de 1 minuto: veja kelvin logs 80 e a aba Sub-bots do painel (botão Console de cada um).

"minha cabeça travou: IA ... HTTP 400"

A IA de fora recusou a pergunta. Se repetir, veja kelvin logs. Pra IA rodar no PC em vez de fora: instale o Ollama e escolha o modelo em Editar › Configurações › APIs › IA no PC.

Onde ficam as coisas

Tudo dentro da pasta do bot.

Pasta ou arquivo	O que é
`logs\servico.log`	O terminal do Kelvin quando ele roda como serviço (troca de arquivo a cada 10 MB).
`database\`	O banco, a sessão do WhatsApp e os logins do navegador. Não apague e não mande pra ninguém.
`database\cli.token`	A chave do comando `kelvin`. Só funciona no próprio PC.
`backups\`	As cópias do banco (do painel e do `kelvin backup`). Não incluem a sessão do WhatsApp.
`config.js`	Nome do bot, donos, senha e porta do painel.
`modulos\`	Os módulos. Módulo novo = uma pasta aqui.
`instalar.bat` · `iniciar.bat`	Instalador (e `-Remover`) · ligar com janela.