Como hospedar OpenBot AI em VPS com containers isolados
Aprenda a configurar o OpenBot com um supervisor para isolar cada agente em seu próprio container. Veja como gerenciar o gateway, o consumo de RAM e o uso do Chromium.
O que você obtém ao alojar os colegas de trabalho de IA do OpenBot
Você aloja os colegas de trabalho de IA do OpenBot executando um servidor gateway no hardware que controla, além de um supervisor que fornece a cada bot o seu próprio contentor. Esse contentor individual só existe quando COMPUTER_SUPERVISOR_URL está definido. Sem ele, todos os bots partilham o mesmo computador em AGENT_COMPUTER_URL. Com o supervisor configurado, cada contentor de bot inclui o seu próprio navegador Chromium e o seu próprio volume de workspace, com um perfil do navegador que persiste entre sessões. Todas as ações que um bot executa num computador, ficheiro, servidor MCP (model context protocol) ou componente de UI passam por esse gateway. O gateway verifica cada ação segundo uma política antes da execução e regista-a depois. Se o agent loop encapsulado pelo gateway ainda não lhe for familiar, o percurso faseado em aprender agentes de IA desde o zero faz com que escreva primeiro um agente simples antes de fornecer um navegador e as suas credenciais a um bot.
O OpenBot é publicado pela CopilotKit sob a licença MIT em github.com/CopilotKit/openbot. A primeira versão marcada, v0.0.1, foi publicada em 17 August 2026, e v0.2.0 foi publicada em 12 October 2026. Em 10 November 2026, a versão mais recente é v1.0.0, publicada em 9 November 2026, três dias depois de v0.3.0, e o README em main já não contém um aviso de beta. Trate-o como um design sólido, mas ainda com arestas iniciais. A implementação abaixo fixa v0.2.0, e cada passo descreve essa versão. v0.3.0 alterou as aprovações, a partilha do navegador e os valores predefinidos do Helm chart. Por isso, leia as notas de versão v0.3.0 e v1.0.0 antes de começar com uma tag mais recente. O main atual fornece um contentor a cada pessoa e um contentor próprio a cada bot marcado como Isolated.
A parte mais interessante dessa arquitetura também é a mais dispendiosa. Um navegador por agente é o custo de memória que a maioria das pessoas se esquece de planear. Por isso, neste guia, o dimensionamento vem antes da instalação.
Como o gateway decide cada ação
O servidor da API na porta 3001 é o caminho controlado para o computador de um bot. O computador também expõe endpoints de serviço de nível inferior protegidos por tokens. O projeto determina que esses endpoints sejam mantidos privados e nunca utilizados para contornar o gateway. Assim, o gateway só permanece como o único caminho enquanto esses endpoints estiverem inacessíveis. Antes de executar uma ação no navegador, o gateway resolve o alvo a partir de um snapshot da página, avalia as regras de política CEL (common expression language) com base no contexto, grava uma linha de auditoria com a decisão e só depois chama o container. Se a execução falhar depois disso, grava uma segunda linha. A documentação declara claramente o limite: o computador não decide a política; o gateway do servidor é o limite de execução das ações. Essa separação tem um nome fora do OpenBot, porque o loop, as definições das ferramentas, as verificações de permissões e o estado da sessão formam o harness que envolve um modelo, e este gateway é a metade responsável pelas permissões.
A avaliação da política falha de forma segura, e as regras de negação são avaliadas antes das regras de permissão. A direção da falha é mais importante do que a sintaxe da regra. Uma política ausente ou vazia não permite nada, e uma regra inválida falha bloqueando, seja uma regra de negação ou de permissão. Assim, um erro na política deixa o bot bloqueado, em vez de o deixar operar livremente nas suas contas. A política incluída no OpenBot é outra questão. O valor predefinido no arranque é deny: [] com allow: ["true"], o que permite todas as ações até AGENT_COMPUTER_POLICY ou até uma política de administrador guardada a substituir esse valor. Por isso, crie a sua própria política antes de um bot aceder a qualquer recurso real. Essa camada controla o que um bot faz, não o que lê. Assim, uma página com instruções dirigidas ao agente continua a ser um problema separado. É a mesma superfície de prompt injection que assume quando entrega a um agente resultados da sua própria instância SearXNG.
O registo de auditoria fica no PostgreSQL, por isso sobrevive a um reinício. As transferências de controlo são registadas como computer.help_requested, computer.control_taken e computer.control_released. É assim que identifica um pedido do bot para chamar um humano e que confirma a devolução do controlo pelo humano. Os segredos são registados como contagens de caracteres, nunca como valores. As leituras, escritas e listagens de ficheiros aparecem no separador Activity. Um ficheiro guardado é apresentado pelo caminho e pelo tamanho, nunca pelo conteúdo. Essa vista é mantida no navegador e não constitui o registo de auditoria. Se quiser o mesmo limite de controlo sem um navegador por trás, colocar ações de agentes de IA atrás de aprovações aborda esse caso mais restrito.
Quanto custa um bot em RAM e disco
O projeto publica valores medidos para um único Bot em arm64. Estes são os valores de dimensionamento apresentados na documentação de implementação. Eles descrevem um bot numa arquitetura, portanto devem ser usados como ponto de partida, não como um plano de capacidade.
Os dados por trás deste gráfico
[
{
"label": "Measured, one Bot",
"memory_gb": 0.55,
"disk_gb": 1.4,
"vcpu": 0.06
},
{
"label": "Documented minimum",
"memory_gb": 2,
"disk_gb": 4,
"vcpu": 1
},
{
"label": "Documented recommended",
"memory_gb": 4,
"disk_gb": 8,
"vcpu": 2
}
]O pico de memória medido foi de 0.55 GB para um Bot. O mínimo documentado é 2 GB, e a recomendação é de 4 GB. A diferença entre a medição e o mínimo deixa margem para o Chromium crescer sob carga, porque o consumo de memória de um browser acompanha as páginas abertas, e não o processo em repouso. A documentação estima que cada página adicional aberta ao mesmo tempo consuma entre 100 e 200 MB. O consumo de CPU em idle é quase nulo: 0.06 de um core no limite superior do intervalo medido. Portanto, a CPU não é o principal recurso a dimensionar. A imagem ocupa 1.4 GB, enquanto o volume recomendado é de 8 GB. A diferença deixa espaço para /workspace, onde o bot mantém os seus ficheiros. A imagem inclui apenas browsers da família Chromium. O Firefox e o WebKit do Playwright não estão incluídos.
Nada disso indica quanto vários bots consomem em conjunto, e o projeto não publica um valor para esse caso. Um mínimo documentado é o valor que o projeto considera adequado publicar, não necessariamente um valor observado sob carga. É também por isso que escolher entre PhotoPrism e Immich depende dos limites de RAM medidos, e não dos valores publicados. Faça as suas próprias medições. Inicie um bot, atribua-lhe uma tarefa real com uma página aberta e monitorize o container enquanto ele trabalha.
docker stats --no-stream
free -mUse a coluna MEM USAGE do container do bot como valor por bot. Depois, acrescente o gateway e o PostgreSQL e multiplique o valor por bot pelo número de bots que espera manter ativos ao mesmo tempo. Um bot em idle mantém o browser aberto até o timeout de idle o fechar, com 30 minutos por padrão. Por isso, inclua os browsers em idle no multiplicador. A aritmética é a mesma usada para dimensionar RAM e CPU para uma VPS com um coding agent, e a parte relacionada com o browser é explicada em executar um browser headless para agents numa VPS.
Um detalhe do Chromium afeta os planos pequenos. O OpenBot inicia o Chromium com --disable-dev-shm-usage, portanto o browser escreve em /tmp em vez de /dev/shm. Isso evita o crash que ocorre em hosts com um /dev/shm pequeno, mas transfere a pressão para o sistema de ficheiros raiz. Este é mais um motivo para o disco recomendado ser maior do que a imagem.
Como alojar o OpenBot num VPS?
Precisa de Docker, Bun 1.3 ou mais recente, um projeto e uma licença do CopilotKit Intelligence e acesso a um modelo, através de uma chave de API ou, em alternativa, do início de sessão num fornecedor compatível. O README de v0.2.0 exige Bun 1.3+ para a aplicação e o servidor da API; a versão atual de main aumenta esse requisito para 1.4+, por isso consulte o README da tag que clonou. Desde v0.0.15, o início de sessão no próprio fornecedor pode ser usado em vez de uma chave de API. A documentação de desenvolvimento também espera lsof, openssl e curl no sistema, além de npx do Node para aprovisionar o Intelligence. Clone uma versão marcada em vez de main, porque main num projeto tão recente muda sem aviso. Se já tiver uma instalação de v0.1.x, leia as notas de versão de v0.2.0 antes de atualizar: a atualização copia as ligações Composio armazenadas para uma tabela nova, e reverter depois para v0.1.2 oculta qualquer conta ligada após a atualização.
git clone --branch v0.2.0 https://github.com/CopilotKit/openbot.git
cd openbot
cp .env.example .env
bun installAprovisione o projeto Intelligence. Os dois primeiros comandos iniciam sessão e selecionam o projeto. O script auxiliar aprovisiona a chave de runtime desse projeto, cria ou reutiliza o contentor openbot Learning e grava ambas as definições no ficheiro de ambiente.
npx --yes copilotkit@latest login
npx --yes copilotkit@latest project select
bun scripts/setup-learning.tsGere a chave que cifra as credenciais armazenadas e coloque o resultado em .env como KEY_ENCRYPTION_KEY. Adicione o seu OPENAI_API_KEY ao mesmo ficheiro. O Bot de prova de conceito usa OpenAI. Para o LangGraph Bot, pode definir BOT_PROVIDER como anthropic ou google e adicionar a chave correspondente. Para usar um início de sessão num modelo em vez de uma chave, v0.2.0 .env.example aceita CLAUDE_CODE_OAUTH_TOKEN, o token de claude setup-token, e CHATGPT_AUTH_FILE, o ficheiro que um plano ChatGPT com sessão iniciada grava. O servidor da API lê estes valores para os agentes integrados, e o compose transmite-os ao harness do Bot escolhido.
openssl rand -base64 32Enquanto .env estiver aberto, consulte as definições dos computadores. .env.example deixa COMPUTER_SUPERVISOR_URL e SUPERVISOR_TOKEN vazios e aponta AGENT_COMPUTER_URL para o único computador partilhado na porta 4100. O ficheiro compose inclui o supervisor, e scripts/start.sh ativa por predefinição computadores individuais por Bot, fornecendo COMPUTER_SUPERVISOR_URL e SUPERVISOR_TOKEN ao servidor. Se iniciar o servidor manualmente, defina ambos os valores; sem um URL do supervisor, todos os Bots partilham o mesmo browser e as respetivas sessões iniciadas.
Depois, inicie os serviços.
bash scripts/start.shscripts/start.sh inicia os serviços Docker, executa as migrações da base de dados, inicia o servidor, o worker periódico e a aplicação, e verifica o estado de saúde. Quando termina, a aplicação responde na porta 3010 e a API na porta 3001. O script indica conflitos de portas e deixa em execução um serviço correspondente que já esteja ativo, por isso é seguro executá-lo duas vezes.
Verifique a partir do próprio servidor antes de expor qualquer serviço.
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3010
ss -ltnp | grep -E ':(3010|3001|4100|4500|5432)'Um 200 do primeiro comando significa que a aplicação está a servir pedidos. O segundo comando mostra a que endereços essas portas estão associadas, e essa é a resposta relevante num VPS. Uma linha com 127.0.0.1:3001 indica que a porta está acessível apenas no servidor. Uma linha com 0.0.0.0:3001 significa que qualquer pessoa com uma rota até ao servidor pode aceder-lhe.
A imagem de contentor único
A documentação de implementação também disponibiliza uma única imagem que contém a aplicação, a API e o Chromium, servida na porta 3001. Ela é publicada como ghcr.io/copilotkit/openbot com tags de versão, ou pode compilá-la a partir do seu clone.
docker build -t openbot .
docker run -p 127.0.0.1:3001:3001 --env-file .env \
-e EMBEDDED_POSTGRES=on -v openbot-data:/var/lib/postgresql openbotO EMBEDDED_POSTGRES=on executa o PostgreSQL dentro do contentor e aplica migrações no arranque. O volume nomeado mantém o histórico de auditoria entre reimplantações; sem ele, cada reconstrução descarta esse histórico. Monte-o no diretório pai, /var/lib/postgresql, e não no diretório de dados propriamente dito. A documentação alerta que montar o diretório de dados pode deixar o cluster não inicializado, fazendo com que a aplicação responda com um 502. Se apontar o DATABASE_URL para uma base de dados gerida, a extensão vector tem de estar ativada nela. Serviços geridos como RDS, Cloud SQL e Azure Database suportam a extensão, mas nenhum deles a ativa por si. As migrações também esperam que a role que as executa seja a proprietária da extensão; se a extensão foi criada com uma role diferente, elas param com must be owner of extension vector.
Execute as migrações como um passo de release quando a base de dados for externa.
docker run --rm --env-file .env --entrypoint sh openbot \
-c "cd /app/server && bun scripts/migrate.ts"Utilize scripts/migrate.ts e não drizzle-kit migrate, porque o CLI drizzle-kit é uma dependência de desenvolvimento que não está presente na imagem de produção. Mantenha o --entrypoint sh, pois sem ele a API inicia antes das migrações serem executadas.
Essa imagem deixa deliberadamente a porta do browser não publicada. Também exclui o supervisor, porque o supervisor necessita do socket do Docker, o qual as plataformas serverless não oferecem. Sem o supervisor, cada bot partilha o mesmo browser e, consequentemente, o mesmo conjunto de logins, o que elimina o isolamento que tornava vantajoso executar contentores por bot. Este caminho de contentor único é o que nunca atribui ao bot um contentor próprio. Se a razão pela qual está aqui é ter logins separados por bot, execute o stack do compose com COMPUTER_SUPERVISOR_URL e SUPERVISOR_TOKEN definidos, num host onde aceite o compromisso. Um processo que consiga comunicar com o socket do Docker pode iniciar um contentor privilegiado, sendo, na prática, root no host. Esse é um bom motivo para manter o OpenBot numa máquina própria, no mesmo espírito de fornecer a agentes de codificação uma VM descartável.
Por que OPENBOT_SINGLE_USER é uma configuração de laptop
.env.example é distribuído com OPENBOT_SINGLE_USER=true. Essa configuração aceita todos os pedidos como se viessem de um único administrador fixo e ignora completamente o início de sessão. Num portátil, isto é conveniente, porque o único cliente que consegue aceder à porta é você. Num VPS, significa que qualquer pessoa que consiga aceder à porta 3010 é esse administrador, num sistema que armazena credenciais cifradas e executa um navegador já autenticado nas suas contas.
O servidor agora verifica parte deste problema. Se OPENBOT_SINGLE_USER=true estiver definida e uma entrada OPENBOT_PUBLIC_URL, OPENBOT_APP_URL ou TRUSTED_ORIGINS for encaminhada publicamente, o servidor recusa iniciar e identifica o endereço. Um endereço privado gera um aviso. Esta verificação lê os URLs na sua configuração, não as interfaces nas quais o Docker publica, pelo que os valores localhost predefinidos passam a verificação mesmo quando uma porta está aberta para a Internet. A ligação à interface continua a ser da sua responsabilidade.
Há duas formas corretas de o executar. Mantenha OPENBOT_SINGLE_USER=true, associe todas as portas a 127.0.0.1 e aceda à aplicação apenas através de um túnel SSH ou de uma interface de rede privada.
ssh -N -L 3010:127.0.0.1:3010 -L 3001:127.0.0.1:3001 you@your-vpsO app fica acessível em http://localhost:3010 no seu próprio navegador. O Chrome e o Firefox tratam esse endereço como um contexto seguro e mantêm os cookies de início de sessão Secure definidos através dele. O Safari é a exceção: também considera localhost um contexto seguro, mas, em 10 November 2026, ainda se recusa a armazenar um cookie Secure definido através de http://localhost simples. Este é um erro do WebKit que continua em aberto. Por isso, abra o túnel no Chrome ou no Firefox, ou coloque TLS à frente. A própria tela em tempo real não precisa de um contexto seguro: a documentação de implantação informa que o app não depende de nenhuma das APIs do navegador que http:// simples desativa.
A outra opção é desativar o modo de utilizador único e configurar um provedor de identidade real. Google, Microsoft Entra, Okta, SAML e OIDC são suportados. Google, Entra e Okta são configurados no ambiente. Os provedores SAML e OIDC são registados em Admin, Identity providers, depois de a implantação estar em execução. Qualquer provedor também precisa de BETTER_AUTH_SECRET com 32 caracteres ou mais, de BETTER_AUTH_URL definido como o URL base público da API para os callbacks OAuth e de INITIAL_ADMIN_EMAILS. TRUSTED_ORIGINS não faz parte dessa lista obrigatória, mas contém as origens do app que a API aceita, além de todos os hosts no documento de descoberta de um provedor OIDC registado. O valor padrão de OPENBOT_APP_URL é a primeira entrada. Portanto, defina-o como a origem pública do app. As credenciais do provedor devem estar completas. Um provedor configurado pela metade interrompe a inicialização em vez de voltar ao acesso aberto.
Se o motivo para adicionar contas for que cada pessoa da equipa quer ter o seu próprio agente, e não apenas o seu próprio navegador, OneCLI foi desenvolvido desde o início para esse modelo, com um agente isolado em sandbox por pessoa e as chaves dos modelos mantidas num único gateway.
Se a aplicação estiver acessível através de um nome público, coloque TLS (transport layer security) à frente dela. Uma página servida por http:// simples em qualquer endereço que não seja localhost não é um contexto seguro. Por isso, os cookies marcados como Secure não são armazenados, e o início de sessão falha de uma forma que parece um erro no OpenBot.
Proteger as portas de nível inferior
A nota de segurança do OpenBot diz que os endpoints dos serviços de nível inferior estão protegidos por tokens, que deve mantê-los privados e que não deve usá-los para contornar o gateway. Os tokens são a segunda proteção. A primeira é impedir totalmente o acesso à porta.
O agent-computer escuta na porta 4100 e exige COMPUTER_TOKEN. Os endpoints do bot escutam nas portas 4200 e 4201, e o agent harness escuta na porta 4202. O supervisor escuta na porta 4500 no host e na porta 4300 dentro do contentor, e o ficheiro compose associa-o a 127.0.0.1:4500. O PostgreSQL escuta na porta 5432. Nenhuma destas portas deve estar numa interface pública. Numa instalação para um único utilizador, o mesmo se aplica à aplicação e à API.
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw enable
sudo ufw status verboseExiste aqui uma armadilha que afeta quem presume que o firewall é suficiente. Publicar uma porta de contentor com -p 3001:3001 faz com que o Docker instale uma regra DNAT. Assim, o tráfego é processado no caminho FORWARD e nunca passa pela cadeia INPUT, controlada pela política de negação predefinida do ufw. A porta continua aberta enquanto ufw status ainda apresenta Status: active. Associe a porta publicada à interface de loopback diretamente no mapeamento, como em -p 127.0.0.1:3001:3001, ou defina o endereço do host no ficheiro compose. Verifique com ss -ltnp, não com ufw status. Esta armadilha não é específica do OpenBot. Por isso, faça a mesma verificação em todos os outros contentores que publicou no servidor, incluindo o que estiver a servir uma biblioteca Jellyfin reconstruída como uma videoclube dos anos 90.
O OpenBot pode funcionar offline com o Intelligence auto-hospedado
Defina isto antes de planejar a implantação. O OpenBot depende de um projeto do CopilotKit Intelligence, que mantém threads persistentes e a memória das conversas no serviço hospedado ou na sua própria infraestrutura. O servidor fixado v0.2.0 valida INTELLIGENCE_API_URL, INTELLIGENCE_GATEWAY_WS_URL e INTELLIGENCE_API_KEY na inicialização. Ele verifica os três em conjunto e recusa iniciar se algum estiver ausente. COPILOTKIT_LICENSE_TOKEN é opcional, e somente um Intelligence auto-hospedado com sua própria licença o utiliza. Em 10 November 2026, o Intelligence hospedado gratuito inclui 1,000 interações por organização a cada mês, mas, desde v0.1.0, o OpenBot exibe um banner de auto-hospedagem, a menos que a implantação tenha um plano pago do Intelligence ou defina OPENBOT_SELF_HOST_BANNER=false. O próprio Intelligence pode ser auto-hospedado, portanto é possível fazer uma implantação totalmente local, embora isso exija mais trabalho do que o quickstart mostra. A implantação offline em produção exige Annual; o modelo self-hosted pay as you go precisa se conectar para reportar o uso para faturamento. A Developer Edition gratuita permite avaliação local fora de produção com uma licença renovável de 30 dias; a instalação e a renovação exigem acesso à internet. A CLI local do Intelligence grava sua chave como CPK_INTELLIGENCE_API_KEY, enquanto a versão fixada v0.2.0 lê apenas INTELLIGENCE_API_KEY; portanto, copie o valor para esse campo nesta versão. A versão atual main aceita a chave da CLI diretamente e dá prioridade a ela.
O modelo é a segunda dependência. Nenhum modelo vem incluído. BOT_PROVIDER aceita openai, anthropic ou google para o LangGraph Bot, e OPENAI_BASE_URL direciona o caminho da OpenAI para qualquer endpoint compatível. É nesse ponto que se encaixa executar o Ollama em um VPS para auto-hospedar um LLM se você quiser manter os tokens no seu próprio hardware. O controle do navegador exige muito do modelo, portanto teste um modelo local em uma tarefa real antes de adotá-lo.
Escalar para além de uma réplica
O gateway resolve as referências de elementos com base num instantâneo da página. Esse instantâneo está agora no PostgreSQL, pelo que uma segunda réplica pode atuar sobre um instantâneo criado pela primeira. O chart oficial do Helm executa duas réplicas da API por predefinição e mantém no PostgreSQL tudo aquilo que uma réplica precisa de preservar. Também desativa o computador integrado e recusa instalar um juntamente com mais de uma réplica. Um navegador dentro do pod da API manteria as sessões de um bot, e escalar a API multiplicá-las-ia. A imagem única é o caso a ter em atenção, porque cada réplica tem o seu próprio navegador e, por isso, as sessões de um bot permanecem na instância que as serviu. Num VPS, o navegador de cada bot continua a ser executado no mesmo host, pelo que o crescimento é feito aumentando a capacidade da máquina. O isolamento entre bots continua a ser assegurado pelos contentores individuais de cada bot, tal como as sandbox de agentes autoalojados mantêm os erros de um agente afastados dos restantes.
Modos de falha e o que verá
O arranque termina imediatamente depois de preencher .env. O servidor valida a configuração antes de disponibilizar qualquer serviço. Cada uma destas situações interrompe o arranque, em vez de causar uma degradação silenciosa: um bloco Intelligence incompleto, KEY_ENCRYPTION_KEY em falta, um fornecedor OAuth com um ID de cliente mas sem segredo, ou o modo de utilizador único juntamente com um URL público. Leia o primeiro erro, corrija esse campo e tente arrancar novamente.
As migrações falham numa base de dados gerida. Existem duas causas prováveis. A extensão vector pode não estar ativada e o role que executa a migração não consegue criá-la, fazendo com que a migração encontre um tipo de coluna que o PostgreSQL não conhece. Ou a extensão foi criada por outro role e a migração termina com must be owner of extension vector. Crie a extensão com o role que executa as migrações e, em seguida, execute novamente a etapa de migração.
A aplicação carrega, mas o início de sessão nunca fica ativo. Está a servir através de http:// simples num endereço público. Esse não é um contexto seguro, pelo que o cookie Secure é descartado. Coloque TLS à frente da aplicação ou use o túnel SSH para que o browser veja localhost. Através do túnel, use Chrome ou Firefox, porque o Safari continua a descartar cookies Secure definidos através de http://localhost simples.
Os bots partilham sessões que esperava que fossem separadas. O supervisor não está a ser utilizado. Por isso, não existe um computador por bot e todos os bots usam o browser partilhado em AGENT_COMPUTER_URL. Confirme que COMPUTER_SUPERVISOR_URL está definido e que o supervisor consegue aceder ao socket do Docker.
Um bot para e pede ajuda. É esse o funcionamento previsto. O registo de auditoria grava computer.help_requested, assume o controlo no ecrã ativo e a transferência fica registada em ambos os lados.
FAQ
O OPENBOT_SINGLE_USER é seguro para manter ativo numa implementação num VPS?
Apenas quando o gateway não pode ser alcançado pela Internet. OPENBOT_SINGLE_USER=true aceita todos os pedidos como um único administrador fixo, sem autenticação. Assim, qualquer pessoa que consiga abrir a porta controla a implementação, as credenciais armazenadas e o navegador com sessão iniciada. Neste modo, o servidor recusa iniciar quando um URL público configurado ou uma origem confiável é encaminhado publicamente, mas essa verificação não consegue determinar como as portas são publicadas. É aceitável quando todas as portas estão vinculadas a 127.0.0.1 e acede à aplicação através de um túnel SSH ou de uma interface de rede privada. Numa interface pública, desative-o e configure Google, Microsoft Entra, Okta ou OIDC juntamente com BETTER_AUTH_SECRET, BETTER_AUTH_URL e INITIAL_ADMIN_EMAILS, e defina TRUSTED_ORIGINS como a origem pública da aplicação.
De quanta RAM precisa um bot OpenBot?
Os valores publicados pelo projeto para um único Bot em arm64 indicam um pico de memória de 0.55 GB, com 2 GB como mínimo documentado e 4 GB recomendado. Não existe um valor publicado para vários bots em simultâneo, porque cada um mantém o seu próprio Chromium. Execute um bot numa tarefa real, consulte a memória desse contentor em docker stats, adicione o gateway e a base de dados e, em seguida, multiplique o resultado pelo número de bots que espera ter em execução ao mesmo tempo.
Preciso de uma conta CopilotKit para alojar o OpenBot localmente?
Sim. O OpenBot depende de um projeto CopilotKit Intelligence para manter threads e memória de forma persistente, e o servidor v0.2.0 fixado recusa iniciar se o URL da API Intelligence, o URL WebSocket do gateway e a chave da API não estiverem todos definidos. Está disponível um plano alojado gratuito desde 10 November 2026, e é possível fazer uma implementação de produção offline com o Intelligence alojado localmente no plano Annual e um modelo local. Também precisa de fornecer o acesso ao seu próprio modelo, uma chave de API do modelo ou uma autenticação num fornecedor compatível, porque o OpenBot não inclui nenhum modelo.
Por que motivo cada bot recebe o seu próprio navegador em vez de partilhar um?
Porque um perfil de navegador é uma identidade. Um navegador partilhado implica cookies e sessões partilhados. Assim, se um bot tiver sessão iniciada numa conta, todos os bots terão sessão iniciada nessa conta. Os contentores individuais por bot dão a cada colaborador o seu próprio perfil e as suas próprias sessões, mas apenas quando COMPUTER_SUPERVISOR_URL aponta o servidor para o supervisor. Sem essa configuração, todos os bots partilham um navegador. O custo é a memória, porque um Chromium por bot é o maior componente individual do dimensionamento.
Quais portas do OpenBot devem estar abertas na firewall?
Nenhuma das portas de nível inferior. O agent-computer na porta 4100, os endpoints dos bots nas portas 4200 e 4201, o agent harness na porta 4202, o supervisor na porta 4500 e o PostgreSQL na porta 5432 devem permanecer privados. O projeto protege-os com tokens e recomenda que continue a mantê-los inacessíveis. Publique apenas o que uma pessoa precisa de abrir e lembre-se de que uma porta de contentor publicada com -p 3001:3001 pode ser alcançada independentemente de uma regra ufw default-deny, porque a regra DNAT do Docker coloca esse tráfego no caminho FORWARD, em vez de INPUT.