📚 Glossário Técnico (mastigado)
VPS INFRA
O que é: Um computador virtual alugado, ligado 24h num datacenter. Não é da sua casa — é remoto.
Analogia: Você aluga um quarto num prédio empresarial. O quarto é seu, você paga aluguel todo mês.
Seu caso: Contabo Cloud VPS 10 — 2 vCPUs, 10GB RAM, 145GB SSD. R$ ~50/mês.
SSH INFRA
O que é: Protocolo de acesso remoto seguro. Um túnel criptografado entre você e a VPS.
Analogia: É uma porta mágica que te transporta pro computador na Alemanha. O que você digita, ele executa lá.
Comando: ssh [email protected] — depois digita a senha.
DOMÍNIO INFRA
O que é: Um nome fácil de lembrar que aponta pro IP do servidor (tipo placa de rua).
Analogia: É seu endereço na internet. "algiz-phi.us" é seu bairro. "openclaw-control" é sua casa.
Seu caso: openclaw-control.algiz-phi.us → 194.163.166.14 (traduzido pelo Cloudflare).
CLOUDFLARE INFRA
O que é: Empresa que fica na frente do seu servidor, protegendo e acelerando.
O que faz:
▸ DNS: Traduz nomes pra IPs
▸ Proxy: Esconde seu IP real (segurança)
▸ SSL: Certificado HTTPS grátis (cadeado verde)
▸ Cache: Acelera o site
DEPLOY DEV
O que é: O ato de enviar o código novo pro servidor e colocar pra funcionar.
"Fazer deploy" = atualizar o sistema que está rodando.
Analogia: Você constrói um robô na sua oficina (código local). "Fazer deploy" é levar ele até o palco (VPS) e ligar.
GIT / GITHUB GIT
Git: Sistema de versionamento. Salva cada alteração do código como um "checkpoint".
GitHub: Site que hospeda seu Git na nuvem. Backup + histórico + colaboração.
Comandos básicos:
▸ git add . — marca arquivos pra salvar
▸ git commit -m "mensagem" — cria o checkpoint
▸ git push — envia pro GitHub (backup na nuvem)
▸ git pull — puxa do GitHub pro seu PC
Analogia: É um "Ctrl+Z" infinito. Cada commit é um savepoint de RPG. Dá pra voltar pra qualquer ponto.
ROLLBACK DEV
O que é: Voltar atrás. Desfazer um deploy e restaurar a versão anterior que funcionava.
Por que usar: Se um deploy novo quebrou algo, você rollback e tudo volta a funcionar em segundos.
Como fazer: No Git: git revert HEAD. No Docker: trocar a versão da imagem.
DOCKER INFRA
O que é: Sistema de "contêineres" — caixas isoladas que empacotam cada programa com tudo que ele precisa.
Analogia: Cada app mora numa casa separada (container). Se uma pega fogo, as outras não queimam.
Seus containers rodando: Ponto Tangerino (bot + banco + web), Dokploy.
OPENCLAW GATEWAY DNA
O que é: O "cérebro" do sistema. Um serviço que fica rodando na VPS 24h.
O que faz: Gerencia as conversas, conecta com a IA (DeepSeek), controla os agentes.
Porta: 18789. Acessível via navegador em https://openclaw-control.algiz-phi.us
AGENTES (Panteão) DNA
O que são: "Funcionários IA" que você cria no OpenClaw. Cada um tem:
▸ Personalidade (como fala)
▸ Função (o que faz)
▸ Ferramentas (o que pode usar: pesquisar, ler arquivos, etc.)
▸ Modelo de IA (DeepSeek, Claude, etc.)
Exemplo: Hanna (orquestradora), Pítaco (tech lead), Argus (auditor).
BITWARDEN INFRA
O que é: Cofre de senhas criptografado. Fica na sua máquina local, não na VPS.
⚠️ Importante: O OpenClaw na VPS NÃO TEM acesso ao Bitwarden. Ele não consegue ler suas senhas de lá.
Solução: Quando um agente precisar de uma senha (ex: API key), você precisa:
▸ Copiar manualmente do Bitwarden e colar no config do agente
▸ Ou configurar a chave direto no arquivo da VPS
NGINX INFRA
O que é: Servidor web. É a "portaria" do seu servidor — recebe as visitas e redireciona.
O que faz no seu caso:
▸ Pega conexões da porta 80/443
▸ Encaminha pro OpenClaw (porta 18789)
▸ Serve o dashboard do Ponto (porta 3001 → 3000)
❓ Respondendo Suas Perguntas
"Onde o agente vai achar minhas senhas? Está no BW aqui na máquina, pela VPS ele tem acesso?"
❌ Não. O Bitwarden está na sua máquina local (vinny-X99).
A VPS Contabo (na Alemanha) não tem acesso ao cofre do seu PC.
🔧 Solução: Quando criar um agente que precisa de uma API key (ex: DeepSeek, Groq), você copia a chave do Bitwarden e cola na configuração do agente na VPS — ou eu já faço isso pra você.
"Eu fico confundindo VPS, NPS, domínio, SSH — é muito termo"
Vamos simplificar:
▸ VPS (ou "servidor") — o computador alugado na Alemanha 🖥️
▸ SSH — a porta mágica pra acessar esse computador 🚪
▸ Domínio — o nome bonito (openclaw-control.algiz-phi.us) 🌐
▸ Cloudflare — segurança + tradução de nome pra IP 🛡️
▸ NPS — você quis dizer VPS (NPS é uma nota fiscal, não tem nada a ver 😄)
"O que é deploy?"
É quando você pega o código que está no seu computador e envia pro servidor pra rodar.
▸ Antes do deploy: código só no seu PC
▸ Depois do deploy: código rodando na VPS, acessível pra todo mundo
Exemplo real: Você muda o bot do Ponto → faz deploy → o bot novo entra no ar automaticamente.
"Como funciona Git e rollback?"
▸ Git commit = tirar foto do código naquele momento
▸ Git push = enviar as fotos pro álbum (GitHub)
▸ Rollback = pegar uma foto antiga e restaurar
Se amanhã você quebrar tudo fazendo deploy, é só dar rollback e volta ao normal em 1 minuto.