T.I Connect OpenClaw Manual público

Manual de Instalação da T.I Connect

Guia prático para instalar e colocar em operação um agente OpenClaw em VPS, com estrutura segura, canal Telegram e base replicável para futuros clientes.

Este manual foi consolidado a partir do material do curso, de referências externas e da CLI atual do OpenClaw — com correção dos trechos desatualizados.

Resumo executivo

Servidor recomendado: Ubuntu 24.04 LTS
Infra sugerida: 4 vCPU / 8 GB RAM ou superior
Canal inicial: Telegram
LLM inicial: OpenAI ou Anthropic
Abordagem: instalação oficial, sem Docker 1-click

1. Objetivo

Subir um agente OpenClaw com padrão profissional para a T.I Connect, com uma base que possa ser clonada e adaptada para novas implantações comerciais.

2. Pré-requisitos

VPS ativa com acesso root
IP público do servidor
Token do bot do Telegram
Credencial da LLM escolhida
Nome/identidade do agente

3. Provisionamento da VPS

Escolher uma VPS estável
Usar Ubuntu 24.04 LTS
Evitar Docker pronto/1-click
Anotar IP, senha root e provedor

Evite instalar em máquina pessoal como ambiente principal. VPS dá isolamento, disponibilidade e repetibilidade.

4. Acesso via SSH

ssh root@SEU_IP

No primeiro acesso, confirme a fingerprint e informe a senha root.

5. Instalação do OpenClaw

Atualize o sistema e use o instalador oficial:

apt update && apt upgrade -y
curl -fsSL https://openclaw.ai/install.sh | bash

Não use fluxo antigo com clone manual do repositório + python3 main.py + PM2 como caminho principal. Isso ficou para trás.

6. Configuração inicial

Finalize o setup guiado. Se precisar revisar seções depois:

openclaw configure

# ou por seção
openclaw configure --section model
openclaw configure --section channels
openclaw configure --section gateway

Defina o provedor de modelo
Conecte o canal Telegram
Mantenha o gateway com bind seguro

7. Configurar o Telegram

Criar o bot no @BotFather
Copiar o token gerado
Inserir o token na configuração do OpenClaw
Testar o envio/recebimento no chat

8. Segurança mínima obrigatória

Firewall

ufw default deny incoming
ufw allow ssh
ufw enable
ufw status

Fail2Ban

apt install fail2ban -y
systemctl enable fail2ban
systemctl start fail2ban
fail2ban-client status

Política

Não expor serviços desnecessários
Usar credenciais fora de código hardcoded
Limitar acesso do bot aos responsáveis

9. Operação do gateway

openclaw gateway status
openclaw gateway start
openclaw gateway restart
openclaw status
openclaw doctor

Esses são os comandos centrais para validar saúde, reinício e operação do ambiente.

10. Identidade do agente

Depois da instalação, configurar os arquivos-base do workspace:

SOUL.md — personalidade
USER.md — contexto do cliente
IDENTITY.md — nome, papel, acesso
AGENTS.md — regras e limites

É essa etapa que transforma o bot em um agente útil de verdade.

11. Modelo para novos clientes

Usar esta página como base de instalação
Duplicar checklist técnico
Trocar identidade e contexto
Validar canal, segurança e teste final
Documentar credenciais e entrega

Assim a T.I Connect pode padronizar implantação de agentes para uso interno e para clientes futuros.

12. Status deste material

Esta página já está pronta para publicação. O próximo passo é colocá-la em uma hospedagem pública com URL real.

Opção 1: GitHub Pages
Opção 2: Cloudflare Pages
Opção 3: domínio/subdomínio próprio da T.I Connect