SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Auto-héberger OpenBot et ses coéquipiers IA sur un VPS

Déployez OpenBot avec un superviseur : conteneur et navigateur Chromium dédiés par bot, actions contrôlées par la gateway, profils persistants et coût en RAM.

Ce que vous obtenez en auto-hébergeant des coworkers IA OpenBot

Vous auto-hébergez les coworkers IA OpenBot en exécutant un serveur gateway sur du matériel que vous contrôlez, ainsi qu’un supervisor qui attribue à chaque bot son propre conteneur. Ce conteneur propre à chaque bot n’existe que lorsque COMPUTER_SUPERVISOR_URL est défini. Sinon, tous les bots partagent le même ordinateur à AGENT_COMPUTER_URL. Une fois le supervisor en place, chaque conteneur de bot possède son propre navigateur Chromium et son propre volume de workspace, avec un profil de navigateur conservé entre les sessions. Toute action effectuée par un bot sur un ordinateur, un fichier, un serveur MCP (model context protocol) ou un composant d’interface utilisateur passe par cette gateway. Celle-ci vérifie l’action par rapport à une policy avant son exécution, puis l’enregistre. Si la boucle agent que cette gateway encapsule vous est encore peu familière, le parcours progressif apprendre les agents IA depuis zéro vous fait en écrire une petite avant de donner à un bot un navigateur et vos identifiants.

OpenBot est publié par CopilotKit sous licence MIT à l’adresse github.com/CopilotKit/openbot. La première release taguée, v0.0.1, a été publiée le 17 août 2026, puis v0.2.0 le 12 octobre 2026. Au 10 novembre 2026, la dernière version est v1.0.0, publiée le 9 novembre 2026, trois jours après v0.3.0, et le README sur main ne comporte plus de mention beta. Considérez-le comme une architecture sérieuse, mais encore marquée par certaines limites de jeunesse. Le déploiement ci-dessous épingle v0.2.0, et chaque étape décrit cette release. v0.3.0 a modifié les approvals, le partage du navigateur et les valeurs par défaut du chart Helm. Consultez donc les notes de release v0.3.0 et v1.0.0 avant de commencer avec un tag plus récent. La version actuelle main attribue un conteneur à chaque personne et un conteneur propre à chaque bot marqué Isolated.

L’aspect intéressant de cette architecture est aussi celui qui coûte le plus cher. Un navigateur par agent représente le coût mémoire que la plupart des utilisateurs oublient de prévoir. Le dimensionnement passe donc avant l’installation ici.

Comment la passerelle décide de chaque action

Le serveur API sur le port 3001 est le chemin contrôlé vers l'ordinateur d'un bot. L'ordinateur expose également des points de terminaison de service de bas niveau protégés par des jetons. Le projet recommande de les garder privés et de ne jamais les utiliser pour contourner la passerelle ; ainsi, la passerelle reste le seul chemin tant que ces points de terminaison sont inaccessibles. Avant l'exécution d'une action dans le navigateur, la passerelle résout la cible à partir d'un instantané de page, évalue les règles de politique CEL (Common Expression Language) par rapport au contexte, écrit une ligne d'audit contenant la décision, et appelle seulement ensuite le conteneur. Si l'exécution échoue après cela, elle écrit une seconde ligne. La documentation définit clairement la limite : l'ordinateur ne décide pas de la politique, la passerelle du serveur est la limite de l'action. Cette séparation porte un nom en dehors d'OpenBot, car la boucle, les définitions d'outils, les vérifications de permissions et l'état de la session forment ensemble le harnais entourant un modèle, et cette passerelle constitue la moitié dédiée aux permissions.

L'évaluation de la politique échoue par défaut (fail-closed), et les règles de refus sont évaluées avant les règles d'autorisation. La direction de l'échec importe plus que la syntaxe de la règle. Une politique manquante ou vide n'autorise rien, et une règle défectueuse échoue en bloquant, qu'il s'agisse d'une règle de refus ou d'autorisation. Une erreur dans votre politique entraîne donc un bot bloqué plutôt qu'un bot libre d'agir sur vos comptes. La politique fournie par OpenBot est un cas différent. Sa valeur par défaut au démarrage est deny: [] avec allow: ["true"], ce qui autorise toute action jusqu'à ce que AGENT_COMPUTER_POLICY ou une politique administrateur enregistrée ne la remplace. Rédigez donc votre propre politique avant qu'un bot ne touche à quoi que ce soit de réel. Cette couche régit ce qu'un bot fait et non ce qu'il lit ; une page contenant des instructions destinées à l'agent reste un problème distinct, qui correspond à la même surface d'injection de prompt que celle à laquelle vous vous exposez lorsque vous transmettez à un agent les résultats de votre propre instance SearXNG.

La piste d'audit réside dans PostgreSQL, elle survit donc à un redémarrage. Les transferts de contrôle sont enregistrés sous forme de computer.help_requested, computer.control_taken et computer.control_released ; c'est ainsi que vous voyez un bot demander une intervention humaine et qu'un humain redonne le contrôle. Les secrets sont enregistrés sous forme de nombre de caractères, jamais en tant que valeurs. Les lectures, écritures et listages de fichiers apparaissent dans l'onglet Activité, où un fichier enregistré apparaît par son chemin et sa taille, jamais par son contenu. Cette vue est conservée dans le navigateur et ne constitue pas l'enregistrement d'audit. Si vous souhaitez la même limite de contrôle sans navigateur, le filtrage des actions d'un agent IA par des approbations couvre ce cas plus restreint.

Ce que coûte un bot en RAM et sur le disque

Le projet publie des mesures pour un seul Bot sur arm64. Ce sont les chiffres de dimensionnement indiqués dans la documentation de déploiement. Ils décrivent un bot sur une architecture donnée. Considérez-les donc comme un point de départ, et non comme un plan de capacité.

GraphiqueOpenBot published resource figures, one Bot on arm64 (October 2026)
Les données de ce graphique
[
  {
    "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 mémoire maximale mesurée est de 0.55 Go pour un Bot. Le minimum documenté est de 2 Go et la recommandation est de 4 Go. L’écart entre la mesure et le minimum laisse à Chromium la possibilité d’augmenter sa consommation sous charge, car la mémoire utilisée par un navigateur dépend des pages ouvertes et non du processus au repos. La documentation estime qu’une page supplémentaire ouverte simultanément consomme environ 100 à 200 Mo. Le CPU au repos est presque nul, à 0.06 cœur au sommet de la plage mesurée. Le CPU n’est donc pas le facteur dimensionnant. L’image occupe 1.4 Go, contre un volume recommandé de 8 Go. La différence laisse de la place pour /workspace, où le bot conserve ses fichiers. L’image contient uniquement les navigateurs de la famille Chromium. Firefox et WebKit de Playwright n’y sont pas inclus.

Ces chiffres ne vous indiquent pas ce que coûtent plusieurs bots ensemble, et le projet ne publie aucun chiffre à ce sujet. Un minimum documenté correspond à la valeur qu’un projet accepte d’indiquer dans sa documentation, et non à une valeur nécessairement observée sous charge. C’est aussi pourquoi choisir entre PhotoPrism et Immich dépend de leurs seuils de RAM mesurés plutôt que de leurs valeurs publiées. Faites vos propres mesures. Démarrez un bot, donnez-lui une tâche réelle avec une page ouverte et surveillez le conteneur pendant son exécution.

docker stats --no-stream
free -m

Utilisez la colonne MEM USAGE du conteneur du bot comme valeur par bot. Multipliez cette valeur par le nombre de bots que vous prévoyez d’avoir simultanément, puis ajoutez la gateway et PostgreSQL. Un bot inactif conserve son navigateur jusqu’à l’expiration du délai d’inactivité, fixé par défaut à 30 minutes. Incluez donc les navigateurs inactifs dans le multiplicateur. Le calcul est le même que pour dimensionner la RAM et le CPU d’une VPS pour un agent de codage. La partie concernant le navigateur est traitée dans exécuter un navigateur headless pour des agents sur une VPS.

Un détail de Chromium concerne les petits plans. OpenBot lance Chromium avec --disable-dev-shm-usage. Le navigateur écrit donc dans /tmp au lieu de /dev/shm. Cela évite le crash qui se produit sur les hôtes disposant d’un /dev/shm de petite taille. En contrepartie, la pression se reporte sur votre système de fichiers racine. C’est une raison supplémentaire pour laquelle le disque recommandé est plus grand que l’image.

Comment auto-héberger OpenBot sur un VPS ?

Vous avez besoin de Docker, de Bun 1.3 ou version ultérieure, d’un projet et d’une licence CopilotKit Intelligence, ainsi que d’un accès à un modèle, soit par une clé d’API, soit par la connexion à un provider compatible. Le fichier README de v0.2.0 demande Bun 1.3+ pour l’application et le serveur d’API ; la version actuelle de main porte cette exigence à 1.4+. Consultez donc le README du tag que vous clonez. La connexion propre à un provider peut remplacer une clé d’API depuis v0.0.15. La documentation de développement attend également lsof, openssl et curl sur la machine, ainsi que npx fourni par Node pour le provisioning d’Intelligence. Clonez une release taguée plutôt que main, car main évolue sans préavis sur un projet aussi récent. Si vous utilisez déjà une installation v0.1.x, lisez les notes de version de v0.2.0 avant de migrer vers cette version : la mise à niveau copie les connexions Composio enregistrées dans une nouvelle table. Un retour à v0.1.2 masque ensuite tout compte connecté après la mise à niveau.

git clone --branch v0.2.0 https://github.com/CopilotKit/openbot.git
cd openbot
cp .env.example .env
bun install

Provisionnez le projet Intelligence. Les deux premières commandes vous connectent et sélectionnent le projet. Le script auxiliaire provisionne ensuite la clé runtime de ce projet, crée ou réutilise son conteneur openbot Learning, puis écrit ces deux paramètres dans votre fichier d’environnement.

npx --yes copilotkit@latest login
npx --yes copilotkit@latest project select
bun scripts/setup-learning.ts

Générez la clé qui chiffre les identifiants enregistrés et placez sa sortie dans .env sous le nom KEY_ENCRYPTION_KEY. Ajoutez votre OPENAI_API_KEY dans le même fichier. Le Bot de démonstration utilise OpenAI. Pour le Bot LangGraph, vous pouvez définir BOT_PROVIDER sur anthropic ou google, puis ajouter la clé correspondante. Pour utiliser une connexion à un modèle plutôt qu’une clé, le v0.2.0 .env.example accepte CLAUDE_CODE_OAUTH_TOKEN, le token provenant de claude setup-token, ainsi que CHATGPT_AUTH_FILE, le fichier écrit par un plan ChatGPT connecté. Le serveur d’API les lit pour ses agents intégrés, et compose les transmet au harness Bot que vous avez sélectionné.

openssl rand -base64 32

Pendant que .env est ouvert, vérifiez les paramètres des ordinateurs. .env.example laisse COMPUTER_SUPERVISOR_URL et SUPERVISOR_TOKEN vides et définit AGENT_COMPUTER_URL sur l’ordinateur partagé unique du port 4100. Le fichier compose inclut le supervisor, et scripts/start.sh active par défaut les ordinateurs dédiés à chaque bot en fournissant COMPUTER_SUPERVISOR_URL et SUPERVISOR_TOKEN au serveur. Si vous démarrez vous-même le serveur, définissez les deux valeurs. Sans URL de supervisor, tous les bots partagent le même navigateur et ses sessions.

Démarrez ensuite les services.

bash scripts/start.sh

scripts/start.sh démarre les services Docker, exécute les migrations de la base de données, lance le serveur, le worker périodique et l’application, puis vérifie leur état. À la fin, l’application répond sur le port 3010 et l’API sur le port 3001. Le script signale les conflits de ports et laisse en place un service correspondant déjà démarré. Vous pouvez donc l’exécuter deux fois sans risque.

Vérifiez le fonctionnement depuis le serveur lui-même avant d’exposer quoi que ce soit.

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 après la première commande signifie que l’application répond. La deuxième commande affiche les adresses auxquelles ces ports sont liés. C’est le résultat important sur un VPS. Une ligne contenant 127.0.0.1:3001 indique que le service est accessible uniquement depuis la machine. Une ligne contenant 0.0.0.0:3001 signifie que toute personne pouvant joindre le serveur par le réseau peut y accéder.

L’image de conteneur unique

La documentation de déploiement fournit également une image unique qui contient l’application, l’API et Chromium, avec un service sur le port 3001. Elle est publiée sous ghcr.io/copilotkit/openbot avec des tags de version. Vous pouvez aussi la construire depuis votre 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 openbot

EMBEDDED_POSTGRES=on exécute PostgreSQL dans le conteneur et applique les migrations au démarrage. Le volume nommé conserve l’historique d’audit lors d’un redéploiement. Sans ce volume, chaque reconstruction supprime cet historique. Montez-le sur le répertoire parent, /var/lib/postgresql, et non sur le répertoire de données lui-même. La documentation avertit que le montage du répertoire de données peut laisser le cluster non initialisé. L’application répond alors avec une erreur 502. Si vous configurez DATABASE_URL pour utiliser une base de données gérée, l’extension vector doit y être activée. Les services gérés tels que RDS, Cloud SQL et Azure Database prennent en charge cette extension, mais aucun ne l’active pour vous. Les migrations supposent également que le rôle qui les exécute est propriétaire de l’extension. Si l’extension a été créée avec un autre rôle, elles s’arrêtent avec must be owner of extension vector.

Exécutez les migrations comme étape de release lorsque la base de données est externe.

docker run --rm --env-file .env --entrypoint sh openbot \
  -c "cd /app/server && bun scripts/migrate.ts"

Utilisez scripts/migrate.ts et non drizzle-kit migrate, car la CLI drizzle-kit est une dépendance de développement absente de l’image de production. Conservez --entrypoint sh, car sans cette option l’API démarre avant l’exécution des migrations.

Cette image ne publie volontairement pas le port du navigateur. Elle n’inclut pas non plus le supervisor, car celui-ci a besoin du socket Docker, que les plateformes serverless ne fournissent pas. Sans le supervisor, tous les bots partagent un seul navigateur et donc un même jeu d’identifiants. L’isolation qui justifiait l’exécution d’un conteneur par bot disparaît alors. Cette méthode avec un seul conteneur est la seule qui ne fournit jamais à un bot son propre conteneur. Si vous êtes ici pour disposer d’identifiants distincts pour chaque bot, exécutez la stack Compose avec COMPUTER_SUPERVISOR_URL et SUPERVISOR_TOKEN définis, sur un hôte où vous acceptez ce compromis. Un processus capable de communiquer avec le socket Docker peut démarrer un conteneur privilégié. En pratique, il dispose donc des privilèges root sur l’hôte. C’est une bonne raison de conserver OpenBot sur une machine dédiée, dans le même esprit que l’attribution d’une VM jetable aux agents de programmation.

Pourquoi OPENBOT_SINGLE_USER est un paramètre pour ordinateur portable

.env.example est fourni avec OPENBOT_SINGLE_USER=true. Ce paramètre accepte chaque requête sous l’identité d’un administrateur unique et désactive complètement la connexion. Sur un ordinateur portable, c’est pratique, car vous êtes le seul client à pouvoir atteindre le port. Sur un VPS, toute personne qui atteint le port 3010 devient cet administrateur, sur un système qui stocke des identifiants chiffrés et utilise un navigateur déjà connecté à vos comptes.

Le serveur contrôle désormais une partie de ce point. Si OPENBOT_SINGLE_USER=true est défini et qu’une entrée OPENBOT_PUBLIC_URL, OPENBOT_APP_URL ou TRUSTED_ORIGINS est routée publiquement, le serveur refuse de démarrer et indique l’adresse concernée. Une adresse privée déclenche un avertissement. Ce contrôle lit les URL de votre configuration, et non les interfaces sur lesquelles Docker publie les ports. Les valeurs localhost par défaut passent donc le contrôle, même si un port est ouvert sur Internet. Le binding reste à votre charge.

Il existe deux méthodes correctes pour l’exécuter. Conservez OPENBOT_SINGLE_USER=true, liez chaque port à 127.0.0.1 et accédez à l’application uniquement via un tunnel SSH ou une interface réseau privée.

ssh -N -L 3010:127.0.0.1:3010 -L 3001:127.0.0.1:3001 you@your-vps

L’application est alors accessible à l’adresse http://localhost:3010 dans votre propre navigateur. Chrome et Firefox traitent cette adresse comme un contexte sécurisé et conservent les cookies de connexion Secure définis par son intermédiaire. Safari fait exception : il considère également localhost comme un contexte sécurisé, mais au 10 novembre 2026, il refuse toujours d’enregistrer un cookie Secure défini via http://localhost en clair. Il s’agit d’un bug WebKit toujours ouvert. Ouvrez donc le tunnel dans Chrome ou Firefox, ou placez TLS devant l’application. L’écran en temps réel lui-même n’a pas besoin d’un contexte sécurisé : la documentation de déploiement indique que l’application ne dépend d’aucune API du navigateur désactivée par http:// en clair. L’autre solution consiste à désactiver le mode mono-utilisateur et à configurer un véritable fournisseur d’identité. Google, Microsoft Entra, Okta, SAML et OIDC sont pris en charge. Google, Entra et Okta se configurent dans l’environnement, tandis que les fournisseurs SAML et OIDC s’enregistrent dans Admin, Identity providers, une fois le déploiement terminé. Tout fournisseur nécessite également BETTER_AUTH_SECRET avec au moins 32 caractères, BETTER_AUTH_URL défini sur l’URL de base publique de l’API pour les callbacks OAuth, ainsi que INITIAL_ADMIN_EMAILS. TRUSTED_ORIGINS ne figure pas dans la liste des paramètres obligatoires, mais il contient les origines d’application acceptées par l’API, ainsi que tous les hôtes présents dans le document de découverte d’un fournisseur OIDC enregistré. Sa première entrée est utilisée par défaut dans OPENBOT_APP_URL. Définissez-le donc sur l’origine publique de votre application. Les identifiants des fournisseurs doivent être complets, car un fournisseur partiellement configuré empêche le démarrage au lieu de revenir à un accès ouvert. Si vous ajoutez des comptes parce que chaque membre de l’équipe veut son propre agent plutôt que son propre navigateur, OneCLI est conçu dès le départ pour ce modèle, avec un agent isolé dans un sandbox par personne et les clés des modèles conservées dans une gateway unique.

Si l’application est accessible via un nom public, placez TLS (Transport Layer Security) devant celle-ci. Une page servie en http:// sans chiffrement, sur autre chose que localhost, n’est pas un contexte sécurisé. Les cookies marqués Secure ne sont donc pas enregistrés et la connexion échoue d’une manière qui ressemble à un bug dans OpenBot.

Sécuriser les ports de bas niveau par pare-feu

La note de sécurité d'OpenBot précise que les points de terminaison des services de bas niveau sont protégés par des jetons, qu'ils doivent rester privés et qu'il ne faut pas les utiliser pour contourner la passerelle. Les jetons constituent la seconde protection. La première est que le port ne doit pas être accessible du tout.

L'agent-computer écoute sur 4100 et nécessite COMPUTER_TOKEN. Les points de terminaison du bot écoutent sur 4200 et 4201, et le harness de l'agent écoute sur 4202. Le superviseur écoute sur 4500 sur l'hôte et 4300 à l'intérieur de son conteneur, et le fichier compose le lie à 127.0.0.1:4500. PostgreSQL écoute sur 5432. Aucun de ces éléments ne doit figurer sur une interface publique, et dans un déploiement mono-utilisateur, l'application et l'API ne le doivent pas non plus.

sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw enable
sudo ufw status verbose

Il existe un piège ici qui surprend ceux qui pensent que le pare-feu suffit. Publier un port de conteneur avec -p 3001:3001 pousse Docker à installer une règle DNAT, de sorte que le trafic est traité dans le chemin FORWARD et ne passe jamais par la chaîne INPUT régie par la règle de refus par défaut d'ufw. Le port reste ouvert alors que ufw status affiche toujours Status: active. Liez le port publié à l'interface de bouclage (loopback) dans le mappage lui-même, comme -p 127.0.0.1:3001:3001, ou définissez l'adresse de l'hôte dans votre fichier compose. Vérifiez avec ss -ltnp, et non avec ufw status. Rien dans ce piège n'est spécifique à OpenBot ; effectuez donc la même vérification pour chaque autre conteneur que vous avez publié sur la machine, y compris celui qui sert une bibliothèque Jellyfin reconstruite comme un vidéoclub des années 90.

OpenBot peut fonctionner hors ligne avec Intelligence auto-hébergée

Établissez ce point avant de planifier le déploiement. OpenBot dépend d’un projet Intelligence de CopilotKit, qui conserve les threads persistants et la mémoire des conversations sur le service hébergé ou sur votre propre infrastructure. Le serveur v0.2.0 épinglé valide INTELLIGENCE_API_URL, INTELLIGENCE_GATEWAY_WS_URL et INTELLIGENCE_API_KEY au démarrage. Il vérifie les trois éléments comme un ensemble et refuse de démarrer si l’un d’eux manque. COPILOTKIT_LICENSE_TOKEN est facultatif ; seul un service Intelligence auto-hébergé avec sa propre licence l’utilise. Au 10 novembre 2026, le service Intelligence hébergé gratuit inclut 1,000 interactions par organisation et par mois, mais depuis v0.1.0 OpenBot affiche une bannière d’auto-hébergement, sauf si le déploiement dispose d’un forfait Intelligence payant ou définit OPENBOT_SELF_HOST_BANNER=false. Intelligence peut lui-même être auto-hébergé. Un déploiement entièrement local est donc possible, mais il demande davantage de travail que ne l’indique le quickstart. Un déploiement de production hors ligne nécessite Annual. Une installation auto-hébergée en pay as you go doit se connecter pour transmettre la consommation nécessaire à la facturation. La Developer Edition gratuite prend en charge l’évaluation locale hors production avec une licence renouvelable de 30 jours ; l’installation et le renouvellement nécessitent un accès à Internet. La CLI Intelligence locale écrit sa clé dans CPK_INTELLIGENCE_API_KEY, tandis que la release v0.2.0 épinglée ne lit que INTELLIGENCE_API_KEY. Pour cette release, copiez donc la valeur dans cet emplacement. La version actuelle main accepte directement la clé de la CLI et lui donne la priorité.

Le modèle constitue la deuxième dépendance. Aucun modèle n’est fourni par défaut. BOT_PROVIDER accepte openai, anthropic ou google pour le LangGraph Bot, et OPENAI_BASE_URL dirige le chemin OpenAI vers n’importe quel endpoint compatible. C’est ce qui permet d’exécuter Ollama sur un VPS pour auto-héberger un LLM si vous voulez conserver les tokens sur votre propre matériel. Le contrôle d’un navigateur sollicite fortement un modèle. Testez donc un modèle local sur une tâche réelle avant de vous engager.

Mise à l'échelle au-delà d'une réplique

La passerelle résout les références d'éléments à partir d'un instantané de page. Cet instantané est désormais stocké dans PostgreSQL, ce qui permet à une seconde réplique d'utiliser un instantané pris par la première. Le chart Helm officiel exécute deux répliques de l'API par défaut et conserve dans PostgreSQL tout ce dont une réplique a besoin pour fonctionner. Il désactive également l'ordinateur intégré et refuse d'en installer un si plus d'une réplique est présente. Un navigateur au sein du pod API contiendrait les identifiants d'un bot, et la mise à l'échelle de l'API multiplierait ces instances. L'image unique est le point à surveiller, car chaque réplique transporte son propre navigateur ; les identifiants d'un bot restent donc sur l'instance qui les a servis. Sur un VPS unique, le navigateur de chaque bot s'exécute toujours sur le même hôte, vous augmentez donc la capacité en renforçant la machine. L'isolation entre les bots est toujours assurée par les conteneurs dédiés, de la même manière que les sandboxes d'agents auto-hébergés empêchent les erreurs d'un agent d'affecter les autres.

Modes de défaillance et symptômes observés

Le démarrage s’arrête immédiatement après le renseignement de .env. Le serveur valide la configuration avant de traiter les requêtes. Chacun de ces cas arrête le démarrage au lieu de provoquer une dégradation silencieuse : bloc Intelligence partiel, KEY_ENCRYPTION_KEY manquant, fournisseur OAuth avec un ID client mais sans secret, ou mode mono-utilisateur associé à une URL publique. Lisez la première erreur, corrigez ce champ, puis redémarrez.

Les migrations échouent sur une base de données managée. Deux causes sont probables. L’extension vector n’est peut-être pas activée et le rôle chargé de la migration ne peut pas la créer. La migration rencontre alors un type de colonne que PostgreSQL ne connaît pas. Il est également possible que l’extension ait été créée par un autre rôle. La migration s’arrête alors avec must be owner of extension vector. Créez l’extension avec le rôle qui exécute les migrations, puis relancez l’étape de migration.

L’application se charge, mais la connexion n’est jamais conservée. Vous utilisez http:// en clair sur une adresse publique. Il ne s’agit pas d’un contexte sécurisé, et le cookie Secure est donc rejeté. Placez TLS devant l’application ou utilisez le tunnel SSH afin que le navigateur voie localhost. Dans le tunnel, utilisez Chrome ou Firefox, car Safari continue de supprimer les cookies Secure définis via http://localhost en clair.

Les bots partagent des sessions que vous pensiez distinctes. Le supervisor n’est pas utilisé. Il n’y a donc pas d’ordinateur dédié par bot, et tous les bots utilisent le navigateur partagé sur AGENT_COMPUTER_URL. Vérifiez que COMPUTER_SUPERVISOR_URL est défini et que le supervisor peut accéder au socket Docker.

Un bot s’arrête et demande de l’aide. C’est le comportement prévu. La piste d’audit enregistre computer.help_requested, vous prenez le contrôle sur l’écran en direct et la prise en main est enregistrée par les deux parties.

FAQ

OPENBOT_SINGLE_USER peut-il rester activé sans risque pour un déploiement sur un VPS ?

Uniquement si la gateway n’est pas accessible depuis Internet. OPENBOT_SINGLE_USER=true accepte toutes les requêtes pour un seul administrateur défini, sans authentification. Toute personne capable d’ouvrir le port prend le contrôle du déploiement, des identifiants qu’il stocke et du navigateur où la session est ouverte. Dans ce mode, le serveur refuse de démarrer lorsqu’une URL publique configurée ou une origine approuvée est routée publiquement. Cette vérification ne peut toutefois pas déterminer comment vos ports sont publiés. Ce mode convient lorsque chaque port est lié à 127.0.0.1 et que vous accédez à l’application via un tunnel SSH ou une interface réseau privée. Sur une interface publique, désactivez-le et configurez Google, Microsoft Entra, Okta ou OIDC avec BETTER_AUTH_SECRET, BETTER_AUTH_URL et INITIAL_ADMIN_EMAILS. Définissez TRUSTED_ORIGINS sur l’origine publique de votre application.

De combien de RAM un bot OpenBot a-t-il besoin ?

Les chiffres publiés par le projet pour un seul Bot sur arm64 indiquent un pic de mémoire de 0.55 Go, avec 2 Go comme minimum documenté et 4 Go recommandés. Aucun chiffre n’est publié pour plusieurs bots exécutés simultanément, car chacun utilise son propre Chromium. Exécutez un bot sur une tâche réelle, consultez la mémoire de son conteneur dans docker stats, ajoutez la gateway et la base de données, puis multipliez le total par le nombre de bots que vous prévoyez d’exécuter simultanément.

Ai-je besoin d’un compte CopilotKit pour auto-héberger OpenBot ?

Oui. OpenBot dépend d’un projet CopilotKit Intelligence pour conserver les threads et la mémoire. Le serveur v0.2.0 épinglé refuse de démarrer si l’URL de l’API Intelligence, l’URL WebSocket de la gateway et la clé API ne sont pas toutes définies. Une offre hosted gratuite est disponible depuis le 10 novembre 2026. Le déploiement de production hors ligne est également pris en charge avec Intelligence auto-hébergé dans l’offre Annual et un modèle local. Vous devez aussi fournir votre propre accès à un modèle, une clé API de modèle ou une authentification auprès d’un fournisseur pris en charge, car aucun modèle n’est livré avec OpenBot.

Pourquoi chaque bot utilise-t-il son propre navigateur au lieu d’en partager un ?

Parce qu’un profil de navigateur constitue une identité. Un navigateur partagé signifie des cookies et des sessions partagés. Ainsi, si un bot est connecté à un compte, tous les bots le sont. Les conteneurs distincts par bot donnent à chaque coworker son propre profil et ses propres connexions, mais uniquement lorsque COMPUTER_SUPERVISOR_URL indique au serveur quel supervisor utiliser. Sans cette configuration, tous les bots partagent un seul navigateur. Le coût concerne la mémoire, car un Chromium par bot représente le poste de consommation le plus important dans le dimensionnement.

Quels ports OpenBot faut-il ouvrir sur le firewall ?

Aucun des ports de niveau inférieur. L’agent-computer sur 4100, les endpoints des bots sur 4200 et 4201, l’agent harness sur 4202, le supervisor sur 4500 et PostgreSQL sur 5432 doivent tous rester privés. Le projet les protège avec des tokens et vous demande de les maintenir inaccessibles dans tous les cas. Ne publiez que les ports nécessaires à l’accès utilisateur. Gardez également à l’esprit qu’un port de conteneur publié avec -p 3001:3001 reste accessible, même si la règle par défaut de ufw est deny, car la règle DNAT de Docker place ce trafic dans le chemin FORWARD plutôt que dans INPUT.

Cet article vous a-t-il été utile ?