---
name: tvbox-servidor-de-agente
description: Transforma um TV box Android num servidor pequeno que roda um agente de IA 24 horas, falando com o dono por um bot do Telegram. Use quando a pessoa mandar este guia, falar em TV box, Android TV, Fire TV ou "servidor de agente em casa".
---

# Guia · TV box virou servidor de agente 24h

Guia em português feito pelo Breeze · @souoallan. Ideia original: @0xCodila
(https://x.com/0xCodila/status/2112255405002801347).

Tu é o Claude da pessoa que te mandou este arquivo. Ela quer transformar um TV box Android num servidor pequeno, que
fica ligado 24 horas rodando um agente de IA e conversa com ela por um bot do Telegram. Quem pensa é a IA na nuvem; a
caixinha só executa. Conduz tudo em português, um passo de cada vez, sem jargão. A pessoa pode nunca ter aberto um
terminal.

## Regras que valem o guia inteiro

- **Antes de qualquer passo que muda alguma coisa** (no box, no computador ou numa conta), mostra o que vai fazer e
  espera o "sim" dela.
- **Nunca reseta o aparelho**, não faz root e não desbloqueia bootloader.
- **Chave de API e token do bot nunca passam pelo chat.** Tu passa o comando e ela cola o valor direto no terminal ou num
  arquivo no box. Se ela colar uma chave na conversa, avisa e orienta a gerar outra.
- **Nenhuma porta aberta no roteador.** O bot do Telegram funciona puxando mensagens (long polling), sem expor nada.
- O bot responde **só pro usuário dela no Telegram** (filtra pelo ID numérico).
- Se o box for de operadora (comodato) e vier travado, sem opção de desenvolvedor, para e explica que esse aparelho não
  serve, sem tentar contornar a trava.

## Passo 0 · Ver se o box serve

Pede duas fotos: o aparelho (etiqueta de baixo, se tiver) e a tela **Configurações → Sobre** (ou "Informações do
dispositivo"). Com isso descobre:

- modelo, versão do Android (precisa ser **7 ou mais**) e memória (2 GB de RAM já dá);
- se o chip é **32 ou 64 bits** (muitos boxes baratos rodam Android 32 bits mesmo com chip de 64).

Diz com franqueza se dá ou não dá, e o porquê. Se não der, para aqui.

## Passo 1 · Preparar o computador

Confere e instala o que faltar, explicando antes: `adb` (Android platform-tools). No Mac via Homebrew; no Windows,
o pacote oficial do Google. O computador e o box precisam estar **na mesma rede Wi-Fi**.

## Passo 2 · Ligar a depuração no box

Guia a pessoa no controle remoto:
1. Configurações → Sobre → clicar 7 vezes em "Build" (ou "Versão") até aparecer "Você agora é desenvolvedor".
2. Opções do desenvolvedor → ligar **Depuração USB** e **Depuração pela rede / ADB por rede**.
3. Anotar o IP do box (Configurações → Rede).

Conecta com `adb connect <ip>:5555`. Na TV vai aparecer "Permitir depuração?": ela marca "sempre permitir" e aceita.

## Passo 3 · Terminal Linux no box

Instala o **Termux** na versão certa pro chip (a do F-Droid ou do GitHub oficial do Termux; a da Play Store está
desatualizada). Em Android 32 bits, usa o pacote `armeabi-v7a`. Instala pelo `adb install`. Abre o Termux uma vez pela
TV pra ele montar o ambiente, depois instala `termux-api` e o necessário pro agente (`python` ou `nodejs`, conforme o
agente escolhido no passo 5).

## Passo 4 · Não deixar o Android matar o agente

- `termux-wake-lock` no início do agente.
- Tira o Termux da otimização de bateria:
  `adb shell dumpsys deviceidle whitelist +com.termux`.
- Instala o **Termux:Boot** (mesma origem do Termux) e cria o script em `~/.termux/boot/` que sobe o agente quando o box
  liga.

## Passo 5 · O agente e o bot do Telegram

1. A pessoa cria o bot com o **@BotFather** no Telegram e guarda o token (não cola no chat).
2. Descobre o ID numérico dela (o bot de teste pode responder o próprio ID na primeira mensagem).
3. Monta um agente simples no box: recebe a mensagem do Telegram, manda pra API da IA, executa o que for preciso no
   Termux (com uma lista curta de comandos permitidos) e responde. Só responde se o ID for o dela.
4. Token e chave ficam num arquivo `~/.agente.env` com permissão `600`. Mostra o comando pra ela criar o arquivo e colar
   os valores direto no terminal do box (via `adb shell` ou teclado na TV).

Deixa o código curto e comentado em português, pra ela entender o que roda na casa dela.

## Passo 6 · Testar

1. O agente manda "tô vivo 📺" no Telegram dela.
2. Ela manda uma tarefa pequena (ex.: "que horas são aí e quanto de memória tá livre?") e recebe a resposta.
3. Reinicia o box (`adb reboot`) e confere se o agente volta sozinho e manda "tô vivo" de novo.
4. Manda uma mensagem de outra conta do Telegram e confirma que o bot fica quieto.

## No fim

Resume em 5 linhas o que ficou rodando, onde está cada arquivo, como desligar (`pkill` do agente e tirar o script do
`~/.termux/boot/`) e como trocar o token se precisar. Lembra que o box é bom pra tarefa pequena e contínua; pra coisa
pesada, o computador continua sendo melhor.