Bots e servidor de bots

Um bot é um agente do Maestrly que roda em Docker num servidor de bots que você controla, com desktop Linux, contas de modelo, memória e rotinas próprios. Você cria, conversa e acompanha os bots pela aba Bots do app desktop. Bots numa VPS continuam trabalhando com o seu computador desligado.

Experimental: a aba Bots é marcada como Experimental. Faça backup dos dados dos bots antes de alterar ou remover um servidor.

O que é um bot

Cada bot tem:

uma conversa com você, com o mesmo campo de mensagem dos chats do desktop;
um desktop Linux próprio, com navegador, terminais, gerenciador de arquivos e os programas que ele abrir;
um modelo principal escolhido entre as contas do ambiente, além de memória e rotinas agendadas próprias;
um teto de aprovação que limita o que ele faz sem perguntar a você.

Os bots rodam no servidor de bots: o Docker deste computador ou uma VPS Linux. Bots neste computador param quando ele dorme ou desliga. Bots numa VPS seguem trabalhando; quando você reconectar, abra um bot para ver o que ele fez e confira Aguardando você para o que depende de você.

Configurar o servidor de bots

Abra Configurações → Servidor de bots e escolha onde os bots rodam:

Opção	O que você precisa	O que acontece
Neste computador	Docker com o plugin Compose, rodando. Funcionam Docker Desktop, OrbStack, Colima, Rancher Desktop e Docker Engine.	O Maestrly verifica o Docker, e Instalar servidor de bots baixa as imagens, inicia o servidor e pareia este computador.
Num servidor (VPS)	Ubuntu 22.04+ ou Debian 12+ em `x86_64` ou `arm64`, acesso SSH como root ou com um usuário com `sudo` sem senha, pelo menos 4 GB de memória e 20 GB livres em disco.	Instalar no servidor instala o Docker se precisar, inicia o servidor e pareia este computador por SSH.
Já tenho um servidor configurado	Um servidor de bots que você mesmo administra.	Informe o Endereço do servidor, um Código de pareamento de uso único e o Nome do dispositivo, e clique em Conectar.

Se o Docker não estiver instalado neste computador, use Baixar o Docker, instale e clique em Verificar de novo. O Maestrly não instala o Docker aqui.

Para uma VPS, preencha Endereço do servidor, Usuário e Senha. Em Opções avançadas dá para mudar a Porta SSH ou Usar uma chave privada. A senha ou a chave serve só para a instalação: o Maestrly cria a própria chave de administrador, guarda no armazenamento seguro do sistema quando disponível e acessa o servidor por um túnel SSH. Você não precisa de certificado HTTPS nem de VPN.

O instalador também pergunta o que o servidor vai hospedar: Bots e artefatos, ou Apenas artefatos, que baixa só a imagem do servidor; o ambiente dos bots é baixado quando você cria o primeiro bot.

Planeje os recursos antes de instalar. O primeiro download tem vários GB, e cada ambiente tem limite de 4 GiB de memória por padrão. Para usar um segundo computador, rode a instalação na mesma VPS a partir dele: o Maestrly apenas pareia esse computador. Qualquer computador pareado controla todos os ambientes e bots do servidor.

Desconectar este computador desfaz o pareamento deste computador e mantém o servidor e os bots rodando. Remover servidor de bots apaga para sempre todos os bots, ambientes e dados depois que você digita remover.

Acesso à rede

Instalações feitas pelo app começam com os bots limitados à internet pública. Para que os bots usem um serviço da sua máquina ou do servidor, como o Ollama, ative Deixar os bots acessarem este computador e a rede local (Docker aqui) ou Deixar os bots acessarem a rede privada do servidor (VPS). Cada ambiente adota a mudança na próxima vez que iniciar ou reiniciar.

Ambientes

Um ambiente é um contêiner com uma pasta pessoal e um conjunto de contas de modelo, skills, servidores MCP e logins de sites. Até oito bots podem compartilhá-lo.

Compartilhado pelos bots do ambiente	De cada bot
Contêiner e limite de memória	Nome, papel, instruções e teto de aprovação
Pasta pessoal, arquivos e ferramentas instaladas	Conversa, fila e pausa
Contas de modelo: chaves de API e logins de assinaturas	Modelo principal e modelo de compactação
Skills e servidores MCP	Memória, rotinas e pedidos em Aguardando você
Logins de sites (cookies do navegador)	Desktop e tela próprios

Os bots de um mesmo ambiente confiam uns nos outros. Eles rodam como o mesmo usuário Linux, então um bot que pode rodar comandos consegue ler arquivos, conversas e credenciais dos outros. Use ambientes separados para trabalhos que precisam ficar isolados, por exemplo um por cliente.

Selecione um ambiente na aba Bots para abrir a visão dele: um resumo dos bots e dos recursos ao lado da Tela. Use Reiniciar, Parar ou Iniciar ambiente, e ajuste o Limite de memória (padrão do servidor, ou de 2 a 16 GB). Reiniciar, parar e arquivar mostram todos os bots afetados antes de você confirmar. Arquivar, nas configurações, remove o contêiner e arquiva os bots, mas mantém os dados; para restaurar, use Ambientes arquivados na página Servidor, que abre pelo cartão do servidor no topo da aba Bots.

Criar um bot

Na aba Bots, clique em +.
Preencha Nome e O que ele faz.
Em Onde ele roda, escolha Novo ambiente para ter contêiner, contas, arquivos e logins de sites próprios, ou Ambiente existente para entrar num que já está configurado e com login feito.
Num ambiente novo, use Contas, skills e MCP para levar itens deste computador. Usar os recomendados seleciona tudo que funciona fora deste computador.
Defina até onde ele vai sem perguntar e com quais bots pode conversar, e clique em Criar bot.

A criação continua no servidor mesmo se você fechar a janela. Chaves de API, credenciais do GitHub Copilot e do Cursor, skills globais e servidores MCP são copiados. Sessões do ChatGPT (Codex), Claude, Grok e Google AI (Antigravity) nunca são copiadas: você entra de novo pelo ambiente, que ganha uma sessão própria.

Conversar com um bot

Selecione um bot para abrir a Conversa. Clique em Computador no cabeçalho para acompanhar o desktop dele ao lado do chat.

Anexos: arraste arquivos para o campo de mensagem ou use +. Envie imagens PNG, JPEG, WebP ou GIF de até 5 MiB, PDFs de até 10 MiB (quatro por mensagem) e arquivos de texto ou código UTF-8 de até 256 KiB, com no máximo oito arquivos e 20 MiB por mensagem. DOCX, XLSX e ZIP não são aceitos como anexo.
Downloads: peça ao bot para compartilhar um arquivo que ele criou, em qualquer formato, de até 100 MiB. Baixar salva na pasta Downloads deste computador sem sobrescrever arquivos existentes, e Mostrar na pasta abre o local.
Campo de mensagem: escolha o modelo do bot, o esforço de raciocínio, o modo Fast quando houver e o teto de acesso; acompanhe o uso de contexto e o custo estimado; dite pelo microfone.
Busca: pressione Command+F (Ctrl+F no Windows e no Linux) para buscar na conversa.
Pausar e retomar: Pausar segura o bot e o trabalho na fila; Retomar deixa ele continuar. Os outros bots do ambiente não são afetados.
Janela separada: Abrir chat em nova janela mantém a conversa aberta enquanto você vê outros bots.

Acompanhar ou assumir o controle

A barra abaixo da tela mostra quem está no controle. Assumir controle pausa o bot no próximo passo seguro e passa seu teclado e mouse para o desktop dele; copiar e colar texto simples funciona enquanto você controla. Devolver aceita uma nota opcional: o bot lê a nota, tira uma captura de tela nova e continua. Se o seu computador desconectar, o controle volta para o bot depois de cinco minutos. Linhas de ferramenta do navegador, do computador ou do terminal oferecem Ver no computador.

Aguardando você e alertas

Aguardando você, na aba Bots, reúne pedidos de permissão, perguntas e pedidos de ajuda de todos os bots. A decisão é sua; um bot não aprova por você. Com o seu computador conectado, os bots usam os Sons de alerta de Configurações → Aparência e sons: Turno pronto ou Turno falhou quando um bot termina o que você pediu, e Pedido de permissão quando ele precisa de você. Rotinas e conversas entre bots terminam em silêncio. Desligue Alertas dos bots para silenciar os bots sem silenciar seus próprios chats.

Configurar um ambiente

Na visão do ambiente, clique em Configurações do ambiente (a engrenagem). As abas valem para todos os bots do ambiente; as configurações deste computador continuam separadas.

Contas: Adicionar uma chave de API para Compatível com OpenAI (Chat Completions), OpenAI Responses ou Anthropic, com URL base opcional; entrar com ChatGPT (Codex), Claude, Grok ou Google AI; ou usar Trazer deste computador…. As sessões de assinatura são separadas das do seu computador, mas usam a cota da sua assinatura, sob os termos do provedor.
Modelos: escolha quais modelos aparecem em novas seleções. Ocultar um modelo mantém funcionando o que os bots já escolheram.
Skills e Ferramentas: instale, crie, edite e remova skills; adicione, edite e teste servidores MCP HTTP e stdio dentro do ambiente.
Componentes: veja os runtimes Claude Code, Codex e Google AI (Antigravity ACP), com Verificar atualizações, Atualizar, Atualizações automáticas e Restaurar versão anterior.
Preferências: renomeie o ambiente, defina o modelo de compactação padrão e a disponibilidade padrão da geração de imagens.
Arquivar: pare o ambiente e remova o contêiner, mantendo os dados.

As mudanças esperam até você clicar em Salvar alterações (Command+S, ou Ctrl+S no Windows e no Linux) ou Descartar. O ambiente precisa estar rodando; com servidor ou imagem antigos, o app pede para atualizar e reiniciar antes.

Ajustes do bot

Ajustes do bot, a engrenagem no cabeçalho da conversa, tem uma aba por seção: Identidade, Autonomia, Modelo, Conversas, Rotinas, Memória, Este computador, Ambiente e Arquivar. Em Modelo, escolha o Modelo principal e o modelo de Compactação do bot.

Autonomia define o teto de aprovação do bot. Ele não consegue aumentar esse teto.

Teto	Faz sozinho	Espera por você
Pedir aprovação	Leitura	Edições, comandos, sites novos e ferramentas MCP
Aprovar por mim	Ler e editar a própria pasta, abrir sites, ferramentas MCP	Comandos e trabalho fora dessa pasta
Acesso total	Comandos e edições em qualquer lugar do contêiner, inclusive arquivos de outros bots	Ações que exigem autorização separada

Rotinas

Em Rotinas, clique em Adicionar rotina e informe um título e um prompt autossuficiente. Agende num horário fixo, nos dias escolhidos e num Fuso horário (sem dias marcados, roda todo dia), ou a cada 15 minutos até 24 horas. As rotinas rodam no servidor, então numa VPS continuam com o seu computador desligado. Uma execução é pulada, e não repetida depois, quando o bot está pausado ou offline, quando o horário passou há mais de 15 minutos ou quando a execução anterior ainda não terminou. Use Rodar agora para testar e Histórico para ver as execuções recentes. Os bots podem criar até 10 rotinas próprias, marcadas como Criada pelo bot. Cada execução é um turno completo do modelo na sua conta, então prefira o maior intervalo que atenda.

Mensagens entre bots

Em Conversas, libere os bots com quem este pode trocar mensagens, no mesmo ambiente ou em outro. As mensagens aparecem nas duas conversas. O servidor permite no máximo 30 mensagens por bot por hora e bloqueia um par por 30 minutos depois de 20 mensagens em 30 minutos sem nenhuma mensagem sua.

Memória

Cada bot tem memória própria, separada da dos outros bots e da memória de projetos do seu computador. Revise, fixe, arquive ou exclua entradas na aba Memória. Memória sobre você, na aba Bots, guarda fatos e preferências sobre você: cada entrada vale para Todos os bots ou só para os bots de um ambiente, escolhido em Quem vê. Entradas salvas por um bot pertencem ao ambiente dele; Tornar global compartilha uma entrada com todos os bots.

Artefatos

Ative Publicar artefatos na aba Identidade de um bot para que ele publique páginas web no servidor de bots. A hospedagem também precisa estar ligada em Configurações → Artefatos. Um bot só trabalha com os próprios artefatos. Veja Artefatos.

Trabalhar nos projetos dos seus computadores

Um bot pode iniciar e acompanhar conversas de desenvolvimento nos projetos dos computadores pareados com o servidor dele. Cada computador decide por si:

Nesse computador, abra o bot e vá em Ajustes do bot → Este computador.
Ative Dar a este bot acesso a este computador.
Escolha os Projetos locais, as Contas e modelos, o que o bot pode fazer (ler as próprias conversas, criar conversas e enviar mensagens, cancelar as execuções dele, responder perguntas comuns), o teto em Aprovações e o nome com que este computador aparece para o bot. Depois clique em Dar acesso.
Repita em cada computador que o bot deve alcançar. Outros computadores com acesso mostra os demais, online ou offline, e permite remover o acesso deles.

Cada conversa que o bot inicia roda nesse computador, numa worktree só dela, e aparece na sua barra lateral com o nome do bot. Aprovações de plano, e o que o teto deixar com você, esperam por você nesse computador; o bot nunca responde a elas. Escolha Acesso total só para um bot que você mesmo controla.

Nada se conecta ao seu computador: ele mantém uma conexão aberta com o servidor de bots, e as chamadas passam por ela. Se o computador estiver fechado, dormindo ou desconectado, a chamada falha na hora. Nada fica na fila, e nenhum outro computador assume. O bot vê nomes de projetos e modelos, nunca caminhos locais nem credenciais. Desligar o acesso encerra tudo na hora; as conversas e worktrees do bot ficam nesse computador. Para usar este recurso, atualize o app desktop, o servidor de bots e o ambiente do bot.

Atualizar os bots

Quando há atualização, a aba Bots mostra Atualização disponível e Atualizar bots, botão que também aparece em Configurações → Servidor de bots. Um clique atualiza o servidor instalado pelo Maestrly e depois reinicia cada ambiente na imagem nova assim que nenhum dos bots dele estiver trabalhando, esperando sua resposta ou sob o seu controle, mesmo com o seu computador desligado. A pasta pessoal mantém contas, logins de sites, arquivos e conversas. Enquanto espera, o ambiente mostra Atualização agendada, com Atualizar agora, que reinicia na hora e interrompe os bots, e Cancelar atualização. O Maestrly nunca volta um servidor para uma versão anterior; se outro computador já atualizou o servidor além deste app, atualize o app.

Os bots também mantêm o Claude Code e o Codex atualizados sozinhos (experimental). Cada ambiente procura novas versões estáveis a cada seis horas, verifica e testa a versão antes de usar, nunca interrompe um turno em andamento e nunca fica abaixo da versão que vem na imagem. Para verificar, atualizar ou voltar à versão anterior manualmente, use a aba Componentes do ambiente.

Segurança e limites

O servidor de bots roda numa infraestrutura que você controla: o Docker deste computador ou a sua própria VPS. O servidor controla o Docker, o que equivale a acesso root à máquina, então trate o servidor e quem o administra como confiáveis.
Um bot não usa a tela, o navegador, o terminal, as contas nem os arquivos locais do seu computador. Ele só alcança seus projetos pelo acesso que cada computador concede.
Um bot usa as credenciais e os arquivos que você leva para o ambiente dele, e todos os bots desse ambiente também podem usá-los. As chaves de API ficam criptografadas no ambiente, mas quem tem root no servidor consegue descriptografá-las.
Ambientes são contêineres separados, mas não são uma barreira de segurança contra o próprio servidor. Um programa iniciado por um bot que escuta numa porta de rede pode ser acessado a partir de outros ambientes.
Os bots só alcançam a internet pública, a menos que você libere redes privadas.
Códigos de pareamento valem uma vez e expiram em dez minutos. Qualquer computador pareado controla todos os bots, telas e configurações do servidor.
Os ambientes não têm Docker nem sudo. Eles incluem Node.js, Python, Git e ferramentas comuns de linha de comando; o que você instalar na pasta pessoal permanece.
O uso de modelos, incluindo rotinas e resumos da conversa, é cobrado nas suas próprias contas de provedor e cotas de assinatura.

Para servidores que você administra, backups, portas e solução de problemas, leia o guia técnico completo (em inglês).

A seguir: Artefatos.