Como usar o Tob
Tudo o que o Tob faz e onde fica cada opção: contas de IA, bots, conversas, aprovações, rotinas, memória, grupos, o computador dos bots, conectores, cofre, dispositivos e licença.
Nesta página
Começando
O Tob é um app de bots que trabalham por você. Cada bot tem uma conversa contínua com você, memória, rotinas e acesso a um computador próprio, com navegador, terminal e arquivos. Os bots pensam com as suas contas de IA: a assinatura do Claude ou do ChatGPT que você já tem, ou uma chave de API.
O Tob tem três partes, e vale conhecer os nomes porque eles aparecem no app:
- O app: o que você abre no Mac, no Windows, no Linux ou no navegador. É a mesma tela em todos.
- O servidor (hub): guarda os bots, as conversas, as contas e o cofre. Roda no seu computador, dentro do Docker ou, num Mac com chip Apple ou no Windows, dentro de um Linux que o próprio app do Tob cria (quem já tem o Docker escolhe na instalação).
- O computador dos bots: onde os bots trabalham (navegador, terminal, arquivos). Também roda no Docker, e é um só para todos os bots. Desligado, os bots não respondem.
Instalar
O passo a passo está em runtob.com/instalar: você instala o app do Tob e ele cuida do resto. No Linux e nos Macs com Intel, o Docker vem antes; num Mac com chip Apple e no Windows não precisa. O primeiro download leva alguns minutos e precisa de uns 15 GB livres no disco. Com o Linux do Tob, num Mac ou no Windows, o Tob continua ligado com o app fechado: para desligar, use o menu Tob → Desligar o Tob neste Mac e sair (no Windows, neste computador, e a tecla Alt mostra o menu).
A primeira tela
Na primeira vez, o Tob pede uma conta de IA (veja Contas de IA) e depois o primeiro bot. Com a conta conectada, toque em Criar o primeiro bot: ele já nasce usando essa conta. Se tocar em Agora não, a tela volta na próxima vez que o app abrir sem bots.
Contas de IA
É a conta com que os bots pensam. Fica em Configurações → Contas de IA. O Tob não cobra pelo uso da IA: quem cobra é o seu provedor, do jeito de sempre (a assinatura, ou o uso da chave de API).
| Provedor | Como entra | Motor que roda o bot |
|---|---|---|
| Claude (Pro, Max, Team, Enterprise) | Entrar com o Claude: o Tob abre a página do Claude, você entra e cola no Tob o código que ela mostra. | Claude Code |
| ChatGPT (Codex) (Plus, Pro, Business, Enterprise) | Entrar com o ChatGPT: o Tob mostra um código e a página da OpenAI; você entra e digita o código lá (vale 15 minutos). | Codex |
| API da Anthropic | Cole a chave (paga por uso). | Claude Code |
| API da OpenAI (Codex) | Cole a chave. | Codex |
| xAI (Grok) | Cole a chave da API da xAI. | Codex |
| OpenRouter | Cole a chave. Qualquer modelo da OpenRouter. | Claude Code nos modelos anthropic/…; Codex nos outros |
| Outra API | Cole a chave, o endereço da API e escolha o formato: Chat Completions (o mais comum), Responses ou Anthropic Messages. | Codex no formato Responses; Claude Code nos outros dois |
O motor importa por um motivo prático: ele decide o que o bot pergunta antes de fazer. O modelo continua sendo o da sua conta: um bot da xAI que roda pelo Codex continua pensando com o Grok e com a sua chave.
Onde ficam os logins
Os logins do Claude e do ChatGPT ficam no computador dos bots, guardados e renovados pelo próprio Claude Code e pelo Codex, numa pasta por conta. O Tob não guarda a sua senha nem o token do Claude. As chaves de API ficam criptografadas no servidor. O login roda no computador dos bots, então ele precisa estar ligado para entrar.
Várias contas
Dá para ter mais de uma conta do mesmo provedor (ex.: Claude Pessoal e Claude Empresa). Cada bot escolhe a sua na aba Configurações dele, em Conta; quem não escolheu usa a conta padrão do provedor. Trocar a conta de um bot mantém a conversa.
Uso e limites das assinaturas
As assinaturas do Claude e do ChatGPT têm limites de uso, e as janelas mudam com o plano. No Claude, o Pro e o Max têm uma janela de 5 horas e uma da semana; o Ultra (o antigo Max 20x) não tem a de 5 horas, só a da semana; e o Fable tem uma semanal só dele. No ChatGPT, o Plus tem a janela de 5 horas (e pode ter uma da semana), e o Pro não tem a de 5 horas. O Tob mostra as janelas que o provedor informa para cada conta, então uma janela que o plano não tem não aparece. Em Configurações → Contas de IA, cada conta do Claude e do ChatGPT mostra quanto já usou de cada janela; abrindo a conta, aparece também quando cada uma volta e o plano. Na aba Configurações do bot, embaixo de Conta, vai o resumo da conta dele.
Os números são os que o próprio Claude Code (o mesmo do comando /usage) e o próprio Codex leem do provedor, com o login da conta. O computador dos bots lê quando você abre Contas de IA (no máximo uma vez por minuto) e depois das tarefas (no máximo a cada 5 minutos); nenhuma mensagem é enviada para isso. Chaves de API não aparecem aqui: são pagas por uso, sem janelas. Contas do Claude que ainda usam o token antigo não leem o uso: entre de novo para ver.
Oferecer outra conta no limite (ligado de fábrica, em Contas de IA): quando a conta de um bot bate um limite no meio de uma tarefa, aparece um cartão na conversa com as suas outras contas do mesmo provedor que ainda têm uso, cada uma com quanto já usou. Você escolhe com qual a tarefa segue, na mesma conversa, ou toca em Esperar o limite passar. Nada troca sem você escolher, porque nem toda conta serve para tudo: a de uma empresa, por exemplo, pode não poder ser usada para coisas pessoais. A conta escolhida no bot não muda: quando o limite passa, ele volta para ela. Rotinas não trocam, porque não há a quem perguntar; bots com Usar o Claude desta máquina ou Usar o Codex desta máquina também não. Uma janela semanal só de um modelo (a do Fable, por exemplo) cheia segura só os bots desse modelo: os de outro modelo seguem na conta. Desligado, a tarefa para no limite e a linha diz quando a conta volta.
Sobre usar a assinatura do Claude no Tob. O Tob roda o Claude Code oficial, sem modificações, e o login fica com ele, do mesmo jeito que outros apps fazem. Mas as regras da Anthropic restringem o uso do login do Claude.ai por apps de terceiros, e quem decide como as regras se aplicam é a Anthropic. Os limites da assinatura também pressupõem uso individual comum. Se preferir não depender disso, use uma chave da API da Anthropic. Mais detalhes nas perguntas do site.
Criar bots
Toque no + no pé da lista e em Criar novo bot (ou use a busca, Ctrl K, e escolha a ação). Escolha o formato, os olhos, a cor e o nome. Marque Braço direito se ele vai coordenar os outros (veja Equipe).
Depois de criado, o bot se apresenta. Você pode pedir a ele mesmo para mudar o nome, o rótulo (a etiqueta ao lado do nome), as instruções ou o ícone: ele tem uma ferramenta para se configurar.
Trazer bots do Grok Bot
O Grok Bot não tem botão de exportar, então a importação é por copiar e colar, como a dele. Em Configurações → Geral → Importar do Grok Bot, toque em Começar:
- Copie o pedido que o Tob mostra e mande no chat de um bot seu no Grok Bot.
- Ele responde com um bloco de texto (JSON) com o nome, a legenda, a função e as regras, a memória, as rotinas e as skills dele. Cole a resposta inteira no Tob.
- Confira a prévia e escolha para onde vai: um bot novo ou Juntar a um bot que você já tem. O que vale para todos os bots (seu nome, fuso horário) pode ir para a memória comum.
As rotinas entram pausadas, para não rodarem em dobro enquanto o Grok Bot ainda roda as dele: ligue cada uma no painel do bot quando desligar a de lá. Os horários vêm para o fuso do seu Tob. Uma rotina com um horário que o Tob não entende (ou não consegue trazer para o fuso dele), ou com um pedido longo demais, fica de fora, e o Tob diz qual. Faça um bot por vez. O computador dos bots precisa estar ligado.
Não vêm: as conversas antigas, as senhas do Vault e os logins dos conectores. Guarde as senhas no Cofre e conecte os apps em Conectores. Os arquivos do computador do Grok Bot também ficam lá; baixe o que precisar e mande na conversa do bot.
A conversa
Cada bot tem uma conversa contínua: ele lembra do que vocês falaram. Escreva e aperte Enter. Enquanto ele trabalha, a lista mostra "trabalhando…" e a conversa diz o que ele está fazendo (pensando, usando o navegador, rodando um comando…). O botão ■ para a tarefa.
- Anexos: o + da caixa de texto, colar uma imagem (Ctrl/⌘ V) ou arrastar arquivos para a conversa. Até 25 MB por arquivo. Em grupos ainda não dá para anexar.
- Comandos "/": digite
/para ver os comandos e as skills que o bot tem. - Se o bot ainda está respondendo, a sua mensagem fica na caixa: mande quando ele terminar, ou pare com o ■.
- Ferramentas: por padrão aparecem só as respostas. Para ver cada comando, passo no navegador e arquivo lido, ligue Mostrar as ferramentas usadas em Configurações → Geral.
Quando o bot precisa de você
Às vezes o bot para e mostra um cartão na conversa. Se você ligou as notificações, chega um aviso.
Enviar para o Tob
Um link, uma foto, um PDF ou qualquer arquivo de outro app vai para um bot sem copiar e colar. O Tob abre, pergunta Enviar para qual bot? e abre a conversa desse bot com os arquivos anexados e os links na caixa. Escreva o que ele deve fazer e envie. Até 25 MB por arquivo; o que passar disso fica de fora, com aviso. Grupos e bots pausados no plano grátis não aparecem na lista.
- iPhone: no botão Compartilhar de qualquer app, toque em Tob (se não aparecer, em Mais, no fim da fila de apps). Fotos HEIC vão como JPEG. Se o Tob não abrir sozinho, abra você: o que foi enviado espera lá.
- Mac: no menu Compartilhar (no Safari, no Finder, no Fotos…), escolha Tob. Se não aparecer, ligue em Ajustes do Sistema → Geral → Itens de Início e Extensões → Compartilhamento (no macOS 14: Privacidade e Segurança → Extensões). Também dá para soltar arquivos no ícone do Tob no Dock ou usar Abrir com → Tob no Finder.
- Windows: clique com o botão direito no arquivo → Enviar para → Tob.
Imagens
Bots com login do ChatGPT geram imagens com a ferramenta do próprio Codex, e a imagem aparece na conversa. Nos outros bots, o bot avisa que precisa do login do ChatGPT ou oferece usar uma conta da API da OpenAI, que cobra por imagem: ele só gera depois que você tocar em Gerar (cobra por imagem).
Conversa longa
Cada mensagem leva a conversa inteira junto, e o modelo tem um limite. No painel do bot, em Contexto, aparece quanto já foi usado. Perto do limite o bot resume sozinho; você também pode tocar em Resumir e continuar. Para recomeçar do zero, use + Nova conversa, em Conversas. As conversas antigas continuam lá.
Aprovações
Em Configurações do bot (no painel dele), Aprovações diz o que o bot pergunta antes de fazer. Vale igual para os bots que rodam pelo Claude Code e pelo Codex (veja o motor de cada conta em Contas de IA):
| Opção | O que o bot faz |
|---|---|
| Pedir antes de comandos e cliques | Ler arquivos, pesquisar e navegar rodam direto; rodar comandos, mudar arquivos, clicar e digitar no navegador pedem a sua aprovação. Ferramentas de conectores que mudam algo também pedem. |
| Autônomo | O bot faz tudo sem perguntar, inclusive nos conectores. |
Rodam pelo Codex: as contas do ChatGPT, da API da OpenAI, da xAI, os modelos da OpenRouter que não são anthropic/… e a Outra API no formato Responses. Nesses bots, o Codex só lê arquivos pelo terminal, então até um comando que só lê pede aprovação. Um comando aprovado roda sem entrada: o bot não consegue digitar nele depois. A pesquisa na web feita pelo próprio provedor não pede.
O que vale para todos
- Rotinas nunca pedem aprovação: ninguém está olhando na hora, então a rotina roda como se o bot estivesse no modo autônomo.
- O bot cuida das próprias skills sem pedir. Para guardar algo novo na memória, ele pergunta num cartão (dá para desligar isso).
- Nos cartões de conectores e do cofre, Permitir sempre faz o Tob parar de perguntar por aquela ferramenta ou aquele item.
- Executar comandos no seu computador (fora do computador dos bots) tem a sua própria regra, no app de desktop: veja O computador dos bots.
- Tudo que o bot faz sem perguntar acontece no computador dos bots, não no seu, a não ser que você tenha ligado a execução no seu computador ou o compartilhamento de pastas.
O painel do bot
Toque no nome do bot no topo da conversa para abrir o painel. Ele tem cinco abas:
- Detalhes: o contexto da conversa, as rotinas e a lista de conversas.
- Biblioteca: os arquivos que o bot salvou na pasta de trabalho dele e o que você anexou. Abre prévia de páginas, PDFs, imagens, código (com cores), Markdown, CSV, Excel, Word e PowerPoint.
- Skills: as tarefas que o bot sabe fazer passo a passo (veja Skills).
- Computador: a tela do bot ao vivo, com o navegador dele.
- Configurações (a engrenagem): conta, modelo, esforço, sites liberados, conectores, aprovações, equipe, instruções e memória. É também onde fica Apagar bot.
A tela do bot
Cada bot tem a própria tela, com um navegador que guarda os logins entre uma tarefa e outra, terminal e arquivos. Toque na tela para assistir; toque em Assumir o controle para usar o mouse e o teclado você mesmo, por exemplo para entrar num site com código de 2 fatores. No controle, os botões de baixo dão teclado, teclas especiais, Copiar e Colar entre o seu dispositivo e a tela do bot.
Configurações do bot
- Conta: a conta de IA do bot (veja Contas de IA).
- Modelo e Esforço (effort): o modelo da conta e quanto ele pensa antes de responder. "Padrão" deixa a escolha com a conta.
- Sites liberados: um site por linha (
google.comvale também para os subdomínios). O navegador e os comandos do bot só alcançam esses endereços. Vazio, qualquer site. É um filtro de boa-fé: veja Segurança. - Conectores: quais conectores este bot pode usar. Todos vêm ligados: um bot novo nasce com todos, e um conector novo entra ligado em todos os bots. Desligue aqui os que este bot não deve usar.
- Aprovações: veja Aprovações.
- Faz parte da equipe e Braço direito: veja Equipe.
- Instruções: como o bot deve se comportar, sempre.
- Memória: o que o bot anotou sobre o trabalho dele. Você lê e corrige aqui.
Rotinas
Rotinas são tarefas num horário: "toda sexta às 8h, monte a lista do mercado", "dias úteis às 7h30, uma lição de inglês". O jeito mais fácil é pedir ao bot na conversa; ele combina o horário e cria a rotina. Também dá para criar no painel do bot, em Detalhes → Rotinas → +.
- O resultado cai na conversa do bot, marcado como rotina, e chega uma notificação.
- Rotinas rodam sem pedir aprovação. Pense nisso antes de dar a um bot com rotinas acesso a conectores que mudam coisas.
- Se o computador dos bots estiver desligado na hora, o Tob liga e espera o bot. Se o seu computador (onde o Tob está instalado) estiver dormindo ou desligado, a rotina não roda.
Quadros
Um quadro é uma página que o bot monta para você acompanhar: o painel de uma viagem, o planner da semana, um rastreador de preço, um checklist. Peça na conversa ("monta um quadro da minha viagem com o que está nos meus e-mails") e ele aparece nos Fixados, no topo da lista, com o ícone do bot e a última novidade embaixo do nome.
- É um painel: no computador o quadro usa a largura da janela, com o resumo no topo e os blocos lado a lado; no celular vira uma coluna só. Todos os quadros têm o mesmo visual, o do app. Se um quadro seu veio como uma lista estreita (os primeiros vinham assim), peça na caixa embaixo dele: "refaz no formato de painel".
- Fica salvo: o que você marca e anota no quadro o Tob guarda no seu servidor e mostra em todos os seus dispositivos. O bot lê o que você marcou antes de mexer no quadro.
- Se atualiza: peça uma rotina ("todo dia de manhã, confira os preços e atualize o quadro"). O bot busca os dados (nos conectores, no navegador) e reescreve a página; o quadro recarrega sozinho.
- Você ajusta: escreva na caixa embaixo do quadro ("põe a previsão do tempo") e o pedido vai para a conversa do bot. Conversar abre a conversa.
- Fixado tira o quadro da lista ou põe de volta; a lixeira tira o quadro do Tob (a página continua na Biblioteca do bot). Todos os quadros de um bot ficam no painel dele, em Biblioteca, e a busca (⌘ K) acha pelo nome.
O quadro roda isolado do app: a página não vê o seu login, as suas conversas nem os conectores, só o que você marcou nela.
Memória
Há dois tipos:
- A memória de cada bot: o que ele aprendeu sobre o trabalho dele. Só ele lê.
- A memória comum: o que todos os bots da equipe sabem sobre você (planos, viagens, preferências, pessoas). Um bot fora da equipe não lê nem escreve nela.
As duas entram em toda conversa, e por isso vão junto para o modelo de IA de cada bot (Claude, ChatGPT ou o provedor que você escolheu). Fora isso, ficam só no seu servidor.
O que o Tob sabe de você
Em Configurações → O que o Tob sabe está tudo o que os bots lembram, numa lista só: a memória comum e a de cada bot, item por item. A comum já vem aberta; a de cada bot abre com um clique no nome dele. Dá para corrigir (lápis), esquecer (lixeira), adicionar, buscar, esquecer tudo de uma memória ou editar como texto. Também dá para abrir pelo ⌘K, buscando "memória".
"Posso lembrar disso?"
Com Perguntar antes de lembrar algo novo ligado (o padrão), um bot que quer guardar algo novo mostra um cartão no chat. Nada é gravado até você tocar em Lembrar; Reescrever deixa você mudar o texto antes, e Não descarta. O bot não fica esperando: ele continua a conversa, e você responde quando quiser.
Se um bot escrever na memória sem perguntar (por um comando no terminal, por exemplo), o Tob percebe quando a tarefa termina e mostra um cartão com o que entrou, para Manter ou Esquecer. Apagar uma linha errada o bot pode sem perguntar.
Desligado, os bots anotam sozinhos, como antes, e tudo continua na tela para você conferir. De vez em quando vale olhar: um bot pode anotar algo errado.
Skills e Ensinar
Uma skill é uma receita: os passos de uma tarefa que o bot repete. Ele lê a skill quando a tarefa bate com ela. Há três jeitos de criar:
- Pedir na conversa: "guarde isso como skill".
- Escrever na aba Skills do painel: dê um nome e escreva os passos. Marque Vale para todos os bots para uma skill da equipe toda.
- Ensinar: na aba Computador, assuma o controle e toque em Ensinar. Faça a tarefa na tela do bot (dá para Anotar o que está fazendo) e toque em Concluir: o bot assistiu e guarda o que viu como skill.
Na conversa, / mostra as skills do bot para chamar uma direto.
Equipe, braço direito e grupos
A equipe
Com Faz parte da equipe ligado (o padrão), o bot lê a memória comum, vê o que os outros bots estão fazendo e pode perguntar a outro bot no meio de uma tarefa. Quando um bot fala com outro, a conversa aparece como "A ⇄ B" e você pode abri-la para ler (e parar). Desligado, o bot fica isolado.
Um bot de um provedor de fora (xAI, OpenRouter, Outra API) que faz parte da equipe recebe junto a memória comum, o resumo dos outros bots e as respostas deles.
Braço direito
O braço direito coordena a equipe por iniciativa própria: você pede uma coisa e ele distribui entre os bots e junta as respostas. Ele também fala com grupos: escreve no chat do grupo, espera as respostas e lê o que foi dito. No chat do braço direito, o @ marca bots e grupos para ele falar.
Para virar braço direito: marque Braço direito ao criar o bot ou nas configurações dele, ou arraste o bot na lista e solte no topo. Os braços direitos ficam no alto da lista, grandes; quando não cabem lado a lado, descem para a linha de baixo.
Liderados: nas configurações do braço direito, marque os bots que ele coordena, como quem escolhe os participantes de um grupo. Sem nenhum marcado, ele lidera todos os bots da equipe. Com alguns marcados, ele só lista, chama e põe no resumo do dia esses bots, fala só com os grupos feitos deles e o @ no chat dele só oferece eles. Assim dá para ter vários braços direitos, cada um com a sua turma (um bot pode estar na turma de mais de um). Se você apagar todos os liderados de um braço direito, ele volta a liderar todos.
Resumo do dia
No painel do braço direito, em Detalhes → Rotinas, o cartão Resumo do dia liga uma rotina que todo dia (20h por padrão, você muda o horário e o texto) manda no chat dele, com notificação: o que cada bot fez (tarefas, rotinas que falharam, últimas respostas), o que está esperando por você (aprovações, perguntas com opções, senhas pedidas, contas de IA sem login, aparelhos querendo entrar) e quanto usaram. A qualquer hora você também pode perguntar a ele "o que a equipe fez hoje?". Cada braço direito com liderados próprios tem o seu resumo, só da turma dele. Entre os que lideram todos, o cartão aparece até um deles ligar o resumo; nos outros fica escrito em qual está ligado. O relatório de um deixa de fora os resumos dos outros.
O uso é contado por tarefa, a partir desta versão: tokens para todos os bots e, nos bots do Claude, o custo estimado pelo próprio Claude Code a preço de API. Na assinatura do Claude esse valor só mostra o tamanho do trabalho (não há cobrança por uso, mas conta nos limites do plano); o Codex informa só tokens. Nada disso sai do seu servidor.
Grupos
Um grupo é uma conversa com vários bots juntos. Crie pelo + → Criar grupo, dê um nome e marque quem participa (pelo menos dois). No painel do grupo dá para mudar os participantes ou apagar o grupo.
Organizar a lista
- Arrastar muda a ordem (no celular, segure e arraste). Soltar no topo transforma em braço direito; soltar em Fixados fixa no alto. Esc cancela.
- Seções: + → Criar seção cria um título (Trabalho, Pessoal…). Arraste bots e grupos para dentro; o que não está em nenhuma fica em "Sem seção". Toque no título para recolher.
- Atalhos: ⌘ 1 a 9 abre os primeiros bots e ⌘ K abre a busca (no Windows e no Linux, Ctrl). Segure a tecla para ver os números.
- Largura: arraste a borda da lista. Bem estreita, ela mostra só os ícones. O painel do bot também muda de largura.
O computador dos bots
O botão do computador, no pé da lista, mostra se ele está ligado e quem está trabalhando agora (toque num bot para abrir a conversa). Dali você liga e desliga; Mais opções leva para Configurações → Computador. Desligado, os bots não respondem, mas os arquivos continuam guardados.
Cópias de segurança
O Tob faz uma cópia do computador dos bots por dia e guarda as últimas 7: arquivos, memórias e logins do navegador de todos os bots. Fazer cópia agora faz uma na hora. Voltar para esta desliga o computador, volta para a cópia e liga de novo (antes, ele faz uma cópia de agora, por garantia).
Só no app de desktop
Estas opções aparecem em Configurações → Computador quando você abre o Tob pelo app do Mac, do Windows ou do Linux:
- Rotear o tráfego por este computador: os sites que os bots abrem veem a internet deste computador (o seu endereço e o seu país), não a do servidor. A sua rede local continua fechada para eles. Só funciona com o app aberto e o computador acordado; fora disso, os bots ficam sem abrir sites (e avisam).
- Execução neste computador: deixa os bots abrirem arquivos e rodarem tarefas no seu computador, com o seu usuário. Perguntar sempre (o padrão) abre uma janela pedindo a sua aprovação a cada comando; Sempre permitir roda sem perguntar, até em rotinas; Nunca permitir desliga. Essa regra vale para todos os bots, inclusive os do Codex.
- Chave de segurança (Configurações → Geral): deixa os bots usarem uma chave como a YubiKey ligada a este computador, quando um site no navegador deles pedir. Você aprova cada uso.
Conectores
Conectores são os serviços que os bots podem usar com o seu login: Linear, Granola, Notion, Atlassian (Jira e Confluence), Sentry, Craft, Gmail, Google Drive, Slack, GitHub, Supabase, Stripe, Buffer, Cloudflare, PostHog, Postman, Hugging Face, Firecrawl, Parallel, Context7, Datadog, Intercom, Klaviyo, Brevo, Semrush, Ahrefs, Apollo.io, Clay e outros, ou + Outro conector (o endereço de qualquer servidor MCP remoto). Ficam em Configurações → Conectores.
- Toque em Conectar no serviço. Conforme o serviço, você entra pela página dele, cola uma chave de API, ou usa o client ID e secret de um app seu. Alguns funcionam até sem login, com um limite menor (Parallel e Context7).
- Pronto: o conector já fica ligado em todos os bots, e os bots criados depois também nascem com ele. Para tirar um conector de um bot, vá no painel do bot → Configurações → Conectores e desligue.
O login fica criptografado no servidor, e é o servidor quem chama o serviço: os bots nunca veem o token. O que só lê roda direto; o que muda algo pede a sua aprovação (a não ser num bot autônomo). Os sites liberados do bot não valem para os conectores.
Composio: para Gmail, Slack, Google Drive e outros apps sem criar um app seu em cada serviço, conecte o Composio com a sua conta Composio (pela página de login dele ou pela chave de consumidor, em AI Clients no painel do Composio). Os bots usam os apps que você conectou lá; se faltar um, o bot manda o link no chat. Os logins desses apps ficam no Composio, não no seu servidor. A aprovação vale para cada ação (por exemplo, enviar um e-mail), e Permitir sempre libera só aquela ação. No Gmail, no Google Drive, no Slack, no Canva e no HubSpot, o Composio vem primeiro; conectar com um app seu fica em Avançado: usar um app seu. Google Calendar, Google Docs, Google Slides, Outlook, OneDrive, X, Figma, Vercel e Kommo entram só pelo Composio.
Serviços brasileiros: Mercado Livre, Mercado Pago (para quem integra pagamentos), Clicksign (assinatura de contratos), Z-API (WhatsApp), Open Finance da Cumbuca (extrato do seu banco, entrando com o CPF), Reportei (relatórios de marketing), NFE.io (com chave) e Zapier, que abre Hotmart, Kiwify, Eduzz, Pipefy, Blip, RD Station e outros.
Cofre
O cofre guarda senhas de sites e chaves de programas para os bots usarem sem ver o valor: o computador deles digita a senha no site, ou entrega a chave ao programa, na hora do uso, e a resposta que volta para o bot sai sem o valor. Também guarda as suas informações de contato, para os bots preencherem formulários. Fica em Configurações → Cofre.
- Logins de sites: nome, site (o cofre só digita nesse site e nos subdomínios dele), usuário, senha e, se quiser, o código de 2 fatores (a chave que o site mostra, ou o link
otpauth://). - Chaves de programas: o nome da variável de ambiente (ex.:
GH_TOKENpara ogh), o valor e os programas que podem receber. A chave fica guardada até você remover; se preferir, escolha um prazo em Vale por, e depois dele o bot pede o valor de novo. - Informações de contato: um rótulo (Casa, Trabalho…), nome completo, endereço, telefones e e-mails. Não são segredo: o bot lê quando precisa preencher um formulário.
- Em cada item: Dicas (diga ao bot quando usar o item), quais bots podem usar e Pedir minha aprovação a cada uso. Num contato, você aprova uma vez por tarefa. Desligado, o bot usa sem perguntar, inclusive nas rotinas.
- O bot também pode pedir uma senha ou chave que falta, com um cartão na conversa (veja A conversa). O que você digita vai direto para o cofre.
Tudo o que está no cofre fica criptografado no servidor.
Dispositivos e celular
Cada dispositivo entra no Tob com um token só dele. Para pôr outro navegador ou dispositivo, use Configurações → Dispositivos → Gerar convite: o Tob mostra um QR e um código de uso único, que vale 10 minutos. No outro dispositivo, abra o Tob, digite o código (ou aponte a câmera para o QR) e espere; no dispositivo que mostrou o convite, toque em Aprovar.
- Para tirar um dispositivo, toque em Remover na lista: ele perde o acesso e as notificações, sem mexer nos outros.
- Sair deste dispositivo (Configurações → Geral) apaga o token salvo nele. Os bots e as conversas continuam no servidor.
- O computador onde o Tob está instalado entra direto e não aparece na lista. Um dispositivo que entrou colando o
HUB_TOKEN(a chave mestra do servidor) ganha sozinho um token só dele e passa a aparecer nela.
Usar um Tob num servidor
O app do Tob abre o Tob deste computador ou um Tob na sua rede Tailscale, num endereço https://….ts.net. Um endereço aberto na internet não abre no app, de propósito: quem chega ao Tob comanda os seus bots, as suas contas de IA e o seu cofre. Pelo Tailscale, ele só aparece para os dispositivos da sua rede e não fica exposto na internet.
Para levar o app para um Tob num servidor (uma VPS, por exemplo):
- Instale o Tailscale no servidor e neste computador, com a mesma conta.
- No servidor, publique o Tob na sua rede com
sudo tailscale serve --bg 8787. O comandotailscale serve statusmostra o endereço, comohttps://servidor.sua-rede.ts.net. - No app, abra o menu Trocar de hub… (⌘⇧H no Mac, Ctrl+Shift+H no Windows e no Linux), cole o endereço e toque em Conectar.
- Como ainda não há ninguém no servidor para aprovar um convite, o primeiro dispositivo entra em Tenho o HUB_TOKEN, com o
HUB_TOKENdo arquivo.envna pasta do Tob no servidor. Logo depois, ele troca sozinho por um token só dele. - Os outros dispositivos entram por convite, como acima.
O Tob deste computador continua instalado: para voltar a ele, use Trocar de hub… de novo. Os bots e as conversas de um Tob não passam para o outro.
No celular
O celular chega ao Tob pela sua rede Tailscale, seja o Tob do seu computador ou o de uma VPS. Ele continua fechado para a internet: só os aparelhos da sua rede o enxergam.
- Instale o Tailscale no computador (ou na VPS) onde o Tob roda e no celular, e entre com a mesma conta nos dois.
- No computador do Tob, abra o terminal e publique o Tob na sua rede com
tailscale serve --bg 8787(no Linux e numa VPS, comsudona frente). No Mac, se o terminal não achar o comando, use/Applications/Tailscale.app/Contents/MacOS/Tailscale serve --bg 8787. Na primeira vez, o Tailscale pode pedir para ligar os certificados HTTPS da sua rede: abra o link que ele mostra e confirme. O comandotailscale serve statusmostra o endereço, comohttps://computador.sua-rede.ts.net. - No celular, com o Tailscale ligado, abra esse endereço no app do Tob ou no navegador.
- No computador, em Configurações → Dispositivos → Gerar convite, aparece um código. Digite o código no celular e toque em Aprovar no computador.
App de iPhone: está em teste (beta) e chega em breve pelo TestFlight, ainda fora da App Store. Até lá, o navegador do celular abre o mesmo Tob: no Safari, use Compartilhar → Adicionar à Tela de Início para ele abrir como app.
Licença e planos
Em Configurações → Licença você vê o plano deste computador e ativa a licença.
- Grátis: tudo funciona, com 1 bot, para sempre. Se você tinha mais bots (depois do teste, por exemplo), nada é apagado: os outros ficam pausados, só para leitura, e você escolhe qual fica ativo. Dá para trocar o bot ativo uma vez por dia. Grupos esperam, porque precisam de mais de um bot.
- Teste de 7 dias: libera tudo (bots ilimitados, grupos, braço direito falando com os outros), uma vez por computador, sem cartão.
- Pro: pagamento único (R$ 95 no Brasil, US$ 18 fora), bots ilimitados neste computador para sempre, com as atualizações. Vale para 1 computador com o Tob.
Depois da compra, a chave chega por e-mail: cole em Chave da licença e toque em Ativar. Para levar a licença para outro computador, toque em Desativar neste computador e ative no outro (ou libere em runtob.com/licenca, onde também dá para recuperar a chave). A licença se confirma pela internet de tempos em tempos; sem internet por mais de 30 dias, o Tob volta ao grátis até conectar, sem apagar nada.
A licença não inclui IA: os bots continuam pensando com as suas contas. Reembolso integral em até 7 dias: runtob.com/reembolso. No app de iPhone não tem botão de compra; compre pelo computador ou pelo site.
Preferências
- Configurações → Geral: o seu nome, a memória comum, Mostrar as ferramentas usadas, a Língua do app (Automática segue o dispositivo; Português ou English), as Notificações deste dispositivo e, no app de desktop, a versão e Procurar atualizações.
- Configurações → Aparência: formato, cor e olhos de cada bot. O ícone escolhido ao criar o bot pode ser trocado aqui a qualquer momento: escolha o bot no alto e toque em outro formato ou cor (e Usar em todos os bots para os olhos), e o Movimento: os bots se mexem enquanto trabalham mesmo com "Reduzir movimento" ligado no sistema; ligue Parar os movimentos quando o sistema pedir se preferir que eles fiquem parados. Vale por dispositivo.
- Notificações chegam quando uma rotina termina, quando um bot pede aprovação e quando uma tarefa termina sem nenhum app aberto.
- Configurações → Geral → Ajuda: abre esta documentação e escreve para o suporte. Enviar feedback e Relatar um bug abrem um e-mail para [email protected], com [Feedback] ou [Bug] no assunto; nada é enviado sem você. Cada parte das Configurações tem um link para a seção daqui que fala dela, e no app de desktop o menu Ajuda faz o mesmo.
- Atualizações: o app de desktop se atualiza sozinho. Quando há versão nova, aparece o botão Atualizar no pé da lista. Os bots, as conversas e os logins ficam. O que mudou em cada versão está em Novidades.
- Versão do servidor: o servidor do Tob (o hub e o computador dos bots) tem versões próprias. Em Configurações → Geral → Servidor aparece a versão dele. Quando sai uma nova, aparece o botão Atualizar no pé da lista (o mesmo do app de desktop: um clique atualiza o que tiver de novo, o servidor, o app ou os dois) e em Configurações: o Tob baixa a versão nova enquanto os bots trabalham, espera eles terminarem o que estão fazendo e reinicia nela em um ou dois minutos. Bots, conversas e logins ficam. Se a versão nova não subir, ele volta sozinho para a de antes e diz o motivo. Depois, apaga sozinho as versões antigas que ficaram no disco. O app de desktop também pega a versão nova sozinho na próxima vez que abrir, e rodar de novo o comando de instalar faz o mesmo. Num servidor feito a partir do código (Dokploy, um clone do repositório), essa parte não aparece: ele se atualiza pelo próprio Deploy.
Segurança e limites
O Tob roda no seu computador e não manda dados de uso para ninguém (veja a Privacidade). Mesmo assim, alguns limites valem saber:
- Todos os bots dividem o mesmo computador, cada um com o seu próprio usuário. A pasta, a memória, as skills e o navegador de um bot ficam fechados para os outros, e o login de cada conta de IA só é lido pelos bots que usam essa conta. Mesmo assim, eles dividem o resto da máquina (um bot vê a lista de programas que os outros estão rodando), e os bots com Usar o Claude desta máquina ligado rodam com um usuário comum entre eles. Os sites liberados de cada bot continuam sendo um filtro de boa-fé, não uma parede.
- O computador dos bots não alcança a sua rede local, a Tailscale nem o próprio servidor, só a internet. Para liberar, use
BOTS_LOCAL_NETWORK=1no.envdo servidor. - Sites podem tentar enganar um bot (com texto escondido numa página, por exemplo) para ele fazer algo que você não pediu, anotar uma informação falsa na memória ou pedir algo a outro bot. As aprovações, os sites liberados e o cofre ajudam; o modo autônomo e as rotinas tiram essa barreira.
- O que vai para o provedor de IA: a conversa, as instruções, a memória do bot e, nos bots da equipe, a memória comum e o resumo dos outros bots. Escolha o provedor de cada bot pensando nisso.
- As senhas do cofre e os tokens dos conectores não passam pelo modelo. Os logins das ferramentas de linha de comando (como o
gh) que você fizer no terminal do bot ficam em arquivos que o bot consegue ler.
Se algo der errado
- O bot não responde
- Confira o botão do computador no pé da lista: os bots só respondem com o computador dos bots ligado. Confira também se a conta de IA do bot tem login (Configurações → Contas de IA); sem conta, o bot avisa na aba Configurações dele.
- "A conta … bateu o limite"
- A assinatura dessa conta chegou a um limite de uso. Com Oferecer outra conta no limite ligado e outra conta do mesmo provedor, aparece um cartão para você escolher com qual a tarefa segue; sem outra conta, espere a hora que a linha mostra ou adicione uma conta em Configurações → Contas de IA (veja Uso e limites das assinaturas).
- "O login venceu: entre de novo"
- Em Configurações → Contas de IA, abra a conta e toque em Entrar de novo. Contas do Claude antigas também mostram esse botão para passar o login para o Claude Code.
- "Não deu para listar os modelos da conta"
- A conta ainda não tem login ou a chave está errada. Os bots continuam no modelo padrão da conta.
- Um site não abre para o bot
- Veja os sites liberados do bot. Se você roteia o tráfego pelo seu computador, o app de desktop precisa estar aberto e o computador acordado.
- A conversa ficou lenta ou o bot esqueceu o começo
- A conversa pode estar perto do limite do modelo. Use Resumir e continuar ou + Nova conversa no painel do bot (Detalhes).
- Um bot está "pausado no plano grátis"
- No plano grátis só um bot responde. Toque em Usar este bot para trocar (uma vez por dia), ative o teste ou a licença em Configurações → Licença. Nada foi apagado.
- Problemas na instalação (Docker, porta ocupada, espaço em disco)
- Veja "Se algo der errado" em runtob.com/instalar.
- Ainda precisa de ajuda?
- Escreva para [email protected].