Aloja compañeros de IA OpenBot en tu VPS
Configura OpenBot con supervisor para dar a cada bot su contenedor, navegador Chromium y workspace. El gateway valida y registra cada acción y muestra el coste de RAM.
Lo que se obtiene al alojar los compañeros de IA de OpenBot
Para alojar los compañeros de IA de OpenBot, ejecute un único servidor gateway en hardware bajo su control y un supervisor que proporcione a cada bot su propio contenedor. Ese contenedor independiente sólo existe cuando se establece COMPUTER_SUPERVISOR_URL. Sin él, todos los bots comparten el mismo equipo en AGENT_COMPUTER_URL. Con el supervisor configurado, cada contenedor de bot incluye su propio navegador Chromium y su propio volumen de espacio de trabajo, con un perfil del navegador que persiste entre sesiones. Toda acción que un bot realiza en un equipo, un archivo, un servidor MCP (model context protocol) o un componente de la interfaz de usuario pasa por ese gateway. El gateway comprueba la acción según una política antes de ejecutarla y la registra después. Si el bucle del agente que envuelve ese gateway aún no le resulta familiar, la ruta gradual de aprendizaje de agentes de IA desde cero le permite escribir primero uno pequeño antes de proporcionar a un bot un navegador y sus credenciales.
CopilotKit publica OpenBot con licencia MIT en github.com/CopilotKit/openbot. La primera versión etiquetada, v0.0.1, se publicó el 17 de agosto de 2026, y v0.2.0 le siguió el 12 de octubre de 2026. A fecha del 10 de noviembre de 2026, la última versión es v1.0.0, publicada el 9 de noviembre de 2026, tres días después de v0.3.0, y el README de main ya no incluye un aviso de beta. Considérelo un diseño sólido con algunos aspectos aún inmaduros. La implementación siguiente fija v0.2.0 y cada paso describe esa versión. v0.3.0 modificó las aprobaciones, el uso compartido del navegador y los valores predeterminados del chart de Helm, así que lea las notas de la versión v0.3.0 y v1.0.0 antes de empezar con una etiqueta más reciente. La versión actual main proporciona un contenedor a cada persona y asigna un contenedor propio a cada bot marcado como Isolated.
La parte más interesante de esta arquitectura también es la más costosa. Un navegador por agente es el coste de memoria que más se suele olvidar al planificar, por lo que aquí el dimensionamiento se realiza antes de la instalación.
Cómo decide el gateway cada acción
El servidor API del puerto 3001 es la ruta controlada hacia el equipo de un bot. El equipo también expone endpoints de servicio de nivel inferior protegidos mediante tokens. El proyecto indica que deben mantenerse privados y que nunca deben utilizarse para eludir el gateway. Por tanto, el gateway sólo es la ruta exclusiva mientras esos endpoints no sean accesibles. Antes de ejecutar una acción del navegador, el gateway resuelve el destino a partir de una instantánea de la página, evalúa las reglas de política CEL (common expression language) con el contexto, escribe una fila de auditoría con la decisión y sólo después llama al contenedor. Si la ejecución falla después de ese punto, escribe una segunda fila. La documentación establece claramente el límite: el equipo no decide la política; el gateway del servidor es el límite de las acciones. Esta separación tiene un nombre fuera de OpenBot, porque el bucle, las definiciones de herramientas, las comprobaciones de permisos y el estado de la sesión forman en conjunto el armazón que envuelve a un modelo, y este gateway es la parte de permisos.
La evaluación de la política falla de forma cerrada, y las reglas de denegación se evalúan antes que las reglas de autorización. La dirección del fallo importa más que la sintaxis de las reglas. Una política ausente o vacía no permite ninguna acción, y una regla incorrecta falla bloqueando tanto si es una regla de denegación como si es una regla de autorización. Por tanto, un error en la política deja al bot bloqueado en lugar de permitirle actuar sin restricciones sobre sus cuentas. La política que OpenBot incluye es un asunto distinto. Su valor predeterminado de inicio es deny: [] con allow: ["true"], lo que permite todas las acciones hasta que AGENT_COMPUTER_POLICY o una política de administrador guardada la sustituya. Por eso, escriba su propia política antes de que un bot interactúe con algo real. Esta capa controla lo que hace un bot, no lo que lee. Por tanto, una página que contenga instrucciones dirigidas al agente sigue siendo un problema independiente. Es la misma superficie de inyección de prompts que asume cuando entrega a un agente resultados de su propia instancia de SearXNG.
El registro de auditoría se almacena en PostgreSQL, por lo que sobrevive a un reinicio. Las transferencias de control se registran como computer.help_requested, computer.control_taken y computer.control_released. Así puede ver cuándo un bot solicita la intervención de una persona y cuándo la persona devuelve el control. Los secretos se registran como recuentos de caracteres, nunca como valores. Las lecturas, escrituras y listados de archivos aparecen en la pestaña Activity. Allí, un archivo guardado se muestra mediante su ruta y tamaño, nunca mediante su contenido. Esta vista se conserva en el navegador y no constituye el registro de auditoría. Si quiere el mismo límite de control sin un navegador detrás, controlar las acciones de agentes de IA mediante aprobaciones aborda ese caso más específico.
Cuánta RAM y disco consume un bot
El proyecto publica cifras medidas para un solo bot en arm64. Esas son las cifras de dimensionamiento que muestran los documentos de despliegue y describen un bot en una arquitectura concreta, así que deben tomarse como punto de partida, no como un plan de capacidad.
Los datos de este 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
}
]La memoria máxima medida fue de 0.55 GB para un bot, mientras que el mínimo documentado es de 2 GB y la recomendación es de 4 GB. La diferencia entre la medición y el mínimo deja margen para que Chromium crezca con la carga, porque el uso de memoria de un navegador depende de las páginas que tiene abiertas, no del proceso en reposo. La documentación estima que cada página adicional abierta al mismo tiempo consume entre 100 y 200 MB. El uso de CPU en reposo es casi nulo: alcanza 0.06 de un núcleo en el extremo superior del rango medido, así que la CPU no es el recurso principal que se debe dimensionar. La imagen ocupa 1.4 GB, frente a un volumen recomendado de 8 GB, y la diferencia deja espacio para /workspace, donde el bot guarda sus archivos. La imagen sólo incluye navegadores de la familia Chromium. Firefox y WebKit de Playwright no se incluyen.
Nada de esto indica cuánto consumen varios bots juntos, y el proyecto no publica ninguna cifra al respecto. Un mínimo documentado es la cifra que un proyecto considera razonable publicar, no una cifra observada bajo carga. Por eso elegir entre PhotoPrism e Immich depende de sus límites inferiores de RAM medidos, no de los publicados. Mida su propio entorno. Inicie un bot, asígnele una tarea real con una página abierta y supervise el contenedor mientras trabaja.
docker stats --no-stream
free -mTome la columna MEM USAGE del contenedor del bot como cifra por bot, añada el gateway y PostgreSQL, y multiplique la cifra por bot por el número de bots que espera tener activos al mismo tiempo. Un bot en reposo conserva su navegador hasta que se alcanza el tiempo de espera de inactividad, que es de 30 minutos de forma predeterminada, así que incluya los navegadores inactivos en el multiplicador. El cálculo es el mismo que se usa para dimensionar la RAM y la CPU de una VPS para un agente de programación, y la parte relativa al navegador se explica en ejecutar un navegador sin interfaz para agentes en una VPS.
Un detalle de Chromium afecta a los planes pequeños. OpenBot inicia Chromium con --disable-dev-shm-usage, así que el navegador escribe en /tmp en lugar de /dev/shm. Esto evita el fallo que se produce en hosts con un /dev/shm pequeño y traslada la presión al sistema de archivos root, otra razón por la que el disco recomendado es mayor que la imagen.
¿Cómo puedes alojar OpenBot en tu propio VPS?
Necesitas Docker, Bun 1.3 o posterior, un proyecto y una licencia de CopilotKit Intelligence, y acceso a un modelo, ya sea mediante una clave de API o mediante el inicio de sesión de un proveedor compatible. El README de v0.2.0 exige Bun 1.3+ para la aplicación y el servidor de API; la versión actual de main eleva ese requisito a 1.4+, así que lee el README de la etiqueta que clones. Desde v0.0.15, el inicio de sesión del propio proveedor puede sustituir a una clave de API. La documentación de desarrollo también espera lsof, openssl y curl en el equipo, además de npx de Node para aprovisionar Intelligence. Clona una versión etiquetada en lugar de main, porque main cambia sin previo aviso en un proyecto tan reciente. Si ya ejecutas una instalación de v0.1.x, lee las notas de la versión v0.2.0 antes de migrar: la actualización copia las conexiones almacenadas de Composio a una tabla nueva, y volver después a v0.1.2 oculta cualquier cuenta conectada tras la actualización.
git clone --branch v0.2.0 https://github.com/CopilotKit/openbot.git
cd openbot
cp .env.example .env
bun installAprovisiona el proyecto de Intelligence. Los dos primeros comandos inician sesión y seleccionan el proyecto. El script auxiliar aprovisiona la clave de runtime de ese proyecto, crea o reutiliza su contenedor openbot Learning y escribe ambos valores en el archivo de entorno.
npx --yes copilotkit@latest login
npx --yes copilotkit@latest project select
bun scripts/setup-learning.tsGenera la clave que cifra las credenciales almacenadas y coloca la salida en .env como KEY_ENCRYPTION_KEY. Añade tu OPENAI_API_KEY en el mismo archivo. El Bot de prueba de concepto usa OpenAI. Para el Bot de LangGraph, puedes establecer BOT_PROVIDER en anthropic o google y añadir la clave correspondiente. Para usar el inicio de sesión de un modelo en lugar de una clave, v0.2.0 .env.example acepta CLAUDE_CODE_OAUTH_TOKEN, el token de claude setup-token, y CHATGPT_AUTH_FILE, el archivo que escribe un plan de ChatGPT con sesión iniciada. El servidor de API los lee para sus agentes integrados, y compose los pasa al arnés del Bot que hayas elegido.
openssl rand -base64 32Mientras .env está abierto, revisa la configuración de los equipos. .env.example deja COMPUTER_SUPERVISOR_URL y SUPERVISOR_TOKEN vacíos y apunta AGENT_COMPUTER_URL al único equipo compartido en el puerto 4100. El archivo de compose incluye el supervisor, y scripts/start.sh habilita de forma predeterminada los equipos independientes por Bot al proporcionar COMPUTER_SUPERVISOR_URL y SUPERVISOR_TOKEN al servidor. Si inicias el servidor manualmente, establece ambos valores; sin una URL del supervisor, todos los Bots comparten ese navegador y sus sesiones.
Ahora, inicia los servicios.
bash scripts/start.shscripts/start.sh inicia los servicios de Docker, ejecuta las migraciones de la base de datos, inicia el servidor, el worker periódico y la aplicación, y comprueba su estado. Cuando termina, la aplicación responde en el puerto 3010 y la API en el puerto 3001. El script informa de los conflictos de puertos y deja sin cambios un servicio coincidente que ya esté en ejecución, por lo que es seguro ejecutarlo dos veces.
Compruébalo desde el propio servidor antes de exponer nada.
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3010
ss -ltnp | grep -E ':(3010|3001|4100|4500|5432)'Un 200 del primer comando significa que la aplicación está sirviendo contenido. El segundo comando muestra a qué direcciones están vinculados esos puertos, y esa es la respuesta importante en un VPS. Una línea que indique 127.0.0.1:3001 sólo es accesible desde el propio equipo. Una línea que indique 0.0.0.0:3001 significa que cualquiera que pueda enrutar tráfico al servidor puede acceder a él.
La imagen de contenedor única
La documentación de despliegue también incluye una imagen única que contiene la aplicación, la API y Chromium, y que se sirve en el puerto 3001. Se publica como ghcr.io/copilotkit/openbot con etiquetas de versión, o puede compilarla a partir de su clon.
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 openbotEMBEDDED_POSTGRES=on ejecuta PostgreSQL dentro del contenedor y aplica las migraciones durante el arranque. El volumen con nombre conserva el historial de auditoría entre despliegues, y sin él cada recompilación elimina ese historial. Móntelo en el directorio principal, /var/lib/postgresql, y no directamente en el directorio de datos. La documentación advierte que montar el directorio de datos puede dejar el clúster sin inicializar, tras lo cual la aplicación responde con un 502. Si apunta DATABASE_URL a una base de datos gestionada, la extensión vector debe estar habilitada allí. Los servicios gestionados como RDS, Cloud SQL y Azure Database admiten la extensión, pero ninguno la habilita automáticamente. Las migraciones también esperan que el rol que las ejecuta sea el propietario de la extensión. Si la extensión se creó con otro rol, se detienen con must be owner of extension vector.
Ejecute las migraciones como paso de la versión cuando la base de datos sea externa.
docker run --rm --env-file .env --entrypoint sh openbot \
-c "cd /app/server && bun scripts/migrate.ts"Use scripts/migrate.ts y no drizzle-kit migrate, porque la CLI drizzle-kit es una dependencia de desarrollo que no está incluida en la imagen de producción. Mantenga --entrypoint sh, porque sin él la API se inicia antes de que se ejecuten las migraciones.
Esa imagen deja deliberadamente sin publicar el puerto del navegador. También excluye el supervisor, porque el supervisor necesita el socket de Docker, que las plataformas serverless no proporcionan. Sin el supervisor, todos los bots comparten un navegador y, por tanto, el mismo conjunto de credenciales, lo que elimina el aislamiento que justificaba ejecutar contenedores separados para cada bot. Esta opción de contenedor único es la única que nunca proporciona a un bot su propio contenedor. Si necesita credenciales separadas para cada bot, ejecute la pila de compose con COMPUTER_SUPERVISOR_URL y SUPERVISOR_TOKEN definidos, en un host donde acepte esta compensación. Un proceso que pueda comunicarse con el socket de Docker puede iniciar un contenedor privilegiado, por lo que en la práctica tiene acceso root al host. Por eso conviene mantener OpenBot en una máquina independiente, siguiendo el mismo criterio que proporcionar a los agentes de programación una VM desechable.
Por qué OPENBOT_SINGLE_USER es un ajuste para portátiles
.env.example se entrega con OPENBOT_SINGLE_USER=true. Ese ajuste acepta cada solicitud como un único administrador fijo y omite por completo el inicio de sesión. En un portátil es práctico, porque el único cliente que puede alcanzar el puerto eres tú. En un VPS, significa que cualquier persona que alcance el puerto 3010 es ese administrador, en un sistema que almacena credenciales cifradas y controla un navegador que ya tiene sesiones iniciadas en tus cuentas.
El servidor ahora controla parte de este caso. Si OPENBOT_SINGLE_USER=true está definido y una entrada OPENBOT_PUBLIC_URL, OPENBOT_APP_URL o TRUSTED_ORIGINS se enruta públicamente, el servidor se niega a iniciar e indica la dirección. Una dirección privada genera una advertencia. Esta comprobación lee las URL de la configuración, no las interfaces que publica Docker, por lo que los valores predeterminados de localhost la superan incluso cuando un puerto está abierto a Internet. El enlace de los puertos sigue siendo responsabilidad tuya.
Hay dos formas seguras de ejecutarlo. Mantén OPENBOT_SINGLE_USER=true, enlaza todos los puertos a 127.0.0.1 y accede a la aplicación únicamente mediante un túnel SSH o una interfaz de red privada.
ssh -N -L 3010:127.0.0.1:3010 -L 3001:127.0.0.1:3001 you@your-vpsLa aplicación estará disponible en http://localhost:3010 en tu propio navegador. Chrome y Firefox tratan esa dirección como un contexto seguro y conservan las cookies de inicio de sesión Secure establecidas a través de ella. Safari es la excepción: también informa de localhost como contexto seguro, pero a 10 de noviembre de 2026 todavía se niega a almacenar una cookie Secure establecida mediante http://localhost sin cifrar. Es un error de WebKit que sigue abierto. Abre el túnel en Chrome o Firefox, o coloca TLS delante. La pantalla en tiempo real no necesita un contexto seguro: la documentación de despliegue indica que la aplicación no depende de ninguna de las API del navegador que http:// sin cifrar deshabilita. La otra opción es desactivar el modo de usuario único y configurar un proveedor de identidad real. Se admiten Google, Microsoft Entra, Okta, SAML y OIDC. Google, Entra y Okta se configuran en el entorno, mientras que los proveedores SAML y OIDC se registran en Admin, Identity providers, una vez que el despliegue está en ejecución. Cualquier proveedor también necesita BETTER_AUTH_SECRET con 32 caracteres o más, BETTER_AUTH_URL establecido en la URL base pública de la API para las devoluciones de OAuth y INITIAL_ADMIN_EMAILS. TRUSTED_ORIGINS no figura en esa lista obligatoria, pero contiene los orígenes de aplicación que acepta la API, además de todos los hosts del documento de descubrimiento de un proveedor OIDC registrado, y OPENBOT_APP_URL toma como valor predeterminado su primera entrada. Por tanto, establécelo en el origen público de la aplicación. Las credenciales del proveedor deben estar completas, porque un proveedor configurado a medias detiene el arranque en lugar de volver al acceso abierto. Si el motivo para añadir cuentas es que cada persona del equipo quiere su propio agente y no su propio navegador, OneCLI está diseñado desde el principio para ese modelo, con un agente aislado en un sandbox por persona y las claves de los modelos almacenadas en una única gateway.
Si se puede acceder a la aplicación mediante un nombre público, coloca TLS (seguridad de la capa de transporte) delante de ella. Una página servida mediante http:// sin cifrar en cualquier dirección que no sea localhost no es un contexto seguro, por lo que las cookies marcadas como Secure no se almacenan y el inicio de sesión falla de una forma que parece un error de OpenBot.
Proteja los puertos de nivel inferior
La propia nota de seguridad de OpenBot indica que los endpoints de los servicios de nivel inferior están protegidos mediante tokens, que debe mantenerlos privados y que no debe usarlos para omitir el gateway. Los tokens son la segunda protección. La primera consiste en que el puerto no sea accesible en absoluto.
El agent-computer escucha en 4100 y requiere COMPUTER_TOKEN. Los endpoints del bot escuchan en 4200 y 4201, y el agent harness escucha en 4202. El supervisor escucha en 4500 en el host y en 4300 dentro de su contenedor, y el archivo compose lo enlaza a 127.0.0.1:4500. PostgreSQL escucha en 5432. Ninguno de esos servicios debe estar en una interfaz pública. En una implementación de un solo usuario, tampoco deben estarlo la aplicación ni la API.
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw enable
sudo ufw status verboseAquí hay una trampa que afecta a quienes suponen que el firewall es suficiente. Publicar un puerto de contenedor con -p 3001:3001 hace que Docker instale una regla DNAT, de modo que el tráfico se gestione en la ruta FORWARD y nunca pase por la cadena INPUT, que es la que controla la denegación predeterminada de ufw. El puerto permanece abierto aunque ufw status siga mostrando Status: active. Enlace el puerto publicado a loopback directamente en la asignación, como -p 127.0.0.1:3001:3001, o establezca la dirección del host en el archivo compose. Verifíquelo con ss -ltnp, no con ufw status. Esta trampa no es específica de OpenBot, así que haga la misma comprobación para todos los demás contenedores que haya publicado en el equipo, incluido el que esté sirviendo una biblioteca de Jellyfin reconstruida como un videoclub de los años 90.
OpenBot puede funcionar sin conexión con Intelligence autohospedado
Establezca esto antes de planificar el despliegue. OpenBot depende de un proyecto de Intelligence de CopilotKit, que almacena los hilos persistentes y la memoria de las conversaciones en el servicio alojado o en su propia infraestructura. El servidor fijado v0.2.0 valida INTELLIGENCE_API_URL, INTELLIGENCE_GATEWAY_WS_URL y INTELLIGENCE_API_KEY durante el arranque. Comprueba los tres como un conjunto y no arranca si falta alguno. COPILOTKIT_LICENSE_TOKEN es opcional y sólo lo utiliza un Intelligence autohospedado con su propia licencia. A fecha del 10 de noviembre de 2026, el Intelligence alojado gratuito incluye 1,000 interacciones por organización cada mes, pero desde v0.1.0 OpenBot muestra un aviso de autohospedaje a menos que el despliegue tenga un plan de Intelligence de pago o establezca OPENBOT_SELF_HOST_BANNER=false. Intelligence también se puede autohospedar, por lo que es posible realizar un despliegue completamente local, aunque requiere más trabajo del que muestra la guía de inicio rápido. El despliegue de producción sin conexión requiere Annual; el modelo self-hosted pay as you go debe conectarse para informar del uso con fines de facturación. La Developer Edition gratuita permite realizar evaluaciones locales que no sean de producción con una licencia renovable de 30 días; la instalación y la renovación requieren acceso a Internet. La CLI local de Intelligence escribe su clave como CPK_INTELLIGENCE_API_KEY, mientras que la versión fijada v0.2.0 sólo lee INTELLIGENCE_API_KEY, por lo que debe copiar el valor a esa variable en esta versión. La versión actual main acepta directamente la clave de la CLI y le da prioridad.
El modelo es la segunda dependencia. El paquete no incluye ningún modelo. BOT_PROVIDER acepta openai, anthropic o google para el LangGraph Bot, y OPENAI_BASE_URL dirige la ruta de OpenAI a cualquier endpoint compatible. Ahí encaja ejecutar Ollama en un VPS para autohospedar un LLM si quiere que los tokens permanezcan en su propio hardware. El control del navegador exige mucho del modelo, así que pruebe un modelo local con una tarea real antes de adoptarlo.
Escalar más allá de una réplica
La puerta de enlace resuelve las referencias a elementos mediante una instantánea de la página. Esa instantánea ahora se almacena en PostgreSQL, por lo que una segunda réplica puede actuar sobre una instantánea creada por la primera. El chart oficial de Helm ejecuta dos réplicas de la API de forma predeterminada y almacena en PostgreSQL todo lo que una réplica necesita conservar. También deshabilita el navegador integrado y rechaza instalarlo junto con más de una réplica. Un navegador dentro del pod de la API conservaría las sesiones de un bot, y escalar la API las multiplicaría. El caso de una sola imagen requiere atención, porque cada réplica incluye su propio navegador, por lo que las sesiones de un bot permanecen en la instancia que las atendió. En un VPS, el navegador de cada bot sigue ejecutándose en el mismo host, por lo que el crecimiento se consigue ampliando los recursos del servidor. El aislamiento entre bots sigue procediendo de los contenedores individuales de cada bot, del mismo modo que los entornos aislados de agentes autohospedados mantienen los errores de un agente separados de los demás.
Modos de fallo y lo que verá
El proceso de arranque termina inmediatamente después de completar .env. El servidor valida la configuración antes de atender solicitudes. Cada uno de estos problemas detiene el arranque en lugar de fallar de forma silenciosa: un bloque Intelligence incompleto, la ausencia de KEY_ENCRYPTION_KEY, un proveedor OAuth con un ID de cliente pero sin secreto, o el modo de usuario único junto con una URL pública. Lea el primer error, corrija ese campo y vuelva a iniciar el servidor.
Las migraciones fallan en una base de datos administrada. Hay dos causas probables. La extensión vector puede no estar habilitada y el rol que ejecuta la migración no puede crearla. En ese caso, la migración encuentra un tipo de columna que PostgreSQL no reconoce. También puede que la extensión se haya creado con otro rol y la migración se detenga con must be owner of extension vector. Cree la extensión con el rol que ejecuta las migraciones y vuelva a ejecutar el paso de migración.
La aplicación carga, pero el inicio de sesión nunca se mantiene. Está sirviendo mediante http:// sin cifrar en una dirección pública. Eso no es un contexto seguro, por lo que se descarta la cookie Secure. Configure TLS delante de la aplicación o use el túnel SSH para que el navegador vea localhost. Con el túnel, use Chrome o Firefox, porque Safari todavía descarta las cookies Secure configuradas mediante http://localhost sin cifrar.
Los bots comparten inicios de sesión que esperaba que fueran independientes. El supervisor no está en uso. Por tanto, no hay un equipo independiente por bot y todos usan el navegador compartido en AGENT_COMPUTER_URL. Confirme que COMPUTER_SUPERVISOR_URL esté configurado y que el supervisor pueda acceder al socket de Docker.
Un bot se detiene y solicita ayuda. Ese es el comportamiento previsto. El registro de auditoría registra computer.help_requested, usted toma el control en la pantalla activa y la transferencia queda registrada en ambos lados.
FAQ
¿Es seguro dejar OPENBOT_SINGLE_USER activado en una implementación en un VPS?
Sólo cuando no se puede acceder a la pasarela desde Internet. OPENBOT_SINGLE_USER=true acepta todas las solicitudes como un único administrador fijo y sin inicio de sesión, por lo que cualquiera que pueda abrir el puerto controla la implementación, sus credenciales almacenadas y el navegador con la sesión iniciada. En este modo, el servidor se niega a iniciar cuando una URL pública configurada o un origen de confianza se enruta públicamente, pero esa comprobación no puede detectar cómo se publican los puertos. Es aceptable cuando todos los puertos están vinculados a 127.0.0.1 y se accede a la aplicación mediante un túnel SSH o una interfaz de red privada. En una interfaz pública, desactívelo y configure Google, Microsoft Entra, Okta u OIDC junto con BETTER_AUTH_SECRET, BETTER_AUTH_URL y INITIAL_ADMIN_EMAILS, y establezca TRUSTED_ORIGINS en el origen público de la aplicación.
¿Cuánta RAM necesita un bot de OpenBot?
Las cifras publicadas por el proyecto para un Bot individual en arm64 sitúan el uso máximo de memoria en 0.55 GB, con 2 GB como mínimo documentado y 4 GB como valor recomendado. No hay una cifra publicada para varios bots simultáneos, porque cada uno mantiene su propio Chromium. Ejecute un bot con una tarea real, consulte la memoria de ese contenedor en docker stats, añada la pasarela y la base de datos, y multiplique el resultado por el número de bots que espera tener activos al mismo tiempo.
¿Necesito una cuenta de CopilotKit para alojar OpenBot por mi cuenta?
Sí. OpenBot depende de un proyecto de CopilotKit Intelligence para conservar hilos y memoria, y el servidor v0.2.0 fijado se niega a iniciar si no están definidas la URL de la API de Intelligence, la URL WebSocket de la pasarela y la clave de API. Hay un plan alojado gratuito disponible a fecha de 10 November 2026, y se admite la implementación de producción sin conexión con Intelligence autohospedado en Annual y un modelo local. También debe proporcionar su propio acceso al modelo, una clave de API del modelo o un inicio de sesión de un proveedor compatible en su lugar, porque OpenBot no incluye ningún modelo.
¿Por qué cada bot obtiene su propio navegador en lugar de compartir uno?
Porque un perfil de navegador es una identidad. Un navegador compartido implica cookies y sesiones compartidas, por lo que un bot que haya iniciado sesión en una cuenta significa que todos los bots tienen iniciada la sesión en esa cuenta. Los contenedores independientes por bot proporcionan a cada compañero su propio perfil y sus propios inicios de sesión, pero sólo cuando COMPUTER_SUPERVISOR_URL indica al servidor cuál es el supervisor. Sin esta configuración, todos los bots comparten un navegador. El coste es memoria, ya que un Chromium por bot es el componente individual que más recursos consume en el dimensionamiento.
¿Qué puertos de OpenBot deben estar abiertos en el firewall?
Ninguno de los puertos de las capas inferiores. El equipo del agente en 4100, los endpoints de los bots en 4200 y 4201, el arnés del agente en 4202, el supervisor en 4500 y PostgreSQL en 5432 deben permanecer privados. El proyecto los protege con tokens y solicita que, aun así, se mantengan inaccesibles. Publique sólo lo que una persona necesite para abrir, y recuerde que un puerto de contenedor publicado con -p 3001:3001 es accesible independientemente de una regla default-deny de ufw, porque la regla DNAT de Docker coloca ese tráfico en la ruta FORWARD en lugar de INPUT.