OpenBot-AI-Mitarbeiter auf einem VPS selbst hosten
So isolieren Sie OpenBot-AI-Mitarbeiter mit Supervisor, Container und Browser. Erfahren Sie, wie das Gateway Aktionen prüft und wie viel RAM der Betrieb kostet.
Was Sie erhalten, wenn Sie OpenBot AI-Mitarbeiter selbst hosten
Sie hosten OpenBot AI-Mitarbeiter selbst, indem Sie einen Gateway-Server auf Hardware betreiben, die Sie kontrollieren, ergänzt durch einen Supervisor, der jedem Bot einen eigenen Container zuweist. Dieser Container pro Bot existiert nur, wenn COMPUTER_SUPERVISOR_URL gesetzt ist. Ohne diese Einstellung teilen sich alle Bots denselben Computer unter AGENT_COMPUTER_URL. Mit dem aktiven Supervisor verfügt jeder Bot-Container über einen eigenen Chromium-Browser und ein eigenes Arbeitsbereich-Volume, inklusive eines Browser-Profils, das über Sitzungen hinweg erhalten bleibt. Jede Aktion, die ein Bot auf einem Computer, einer Datei, einem MCP-Server (Model Context Protocol) oder einer UI-Komponente ausführt, läuft über dieses Gateway. Das Gateway prüft die Aktion vor der Ausführung gegen eine Richtlinie und protokolliert sie anschließend. Falls die Agenten-Schleife, die das Gateway umschließt, noch Neuland für Sie ist, führt Sie der strukturierte Pfad in KI-Agenten von Grund auf lernen dazu, eine kleine Schleife selbst zu schreiben, bevor Sie einem Bot einen Browser und Ihre Zugangsdaten anvertrauen.
OpenBot wird von CopilotKit unter der MIT-Lizenz auf github.com/CopilotKit/openbot veröffentlicht. Das erste getaggte Release, v0.0.1, wurde am 17. August 2026 veröffentlicht, gefolgt von v0.2.0 am 12. Oktober 2026. Stand 10. November 2026 ist v1.0.0 die aktuelle Version, veröffentlicht am 9. November 2026, drei Tage nach v0.3.0; die README unter main enthält keinen Beta-Hinweis mehr. Betrachten Sie es als ein ernsthaftes Design mit anfänglichen Ecken und Kanten. Die unten beschriebene Bereitstellung verwendet v0.2.0, und jeder Schritt darin bezieht sich auf dieses Release. v0.3.0 hat Genehmigungen, Browser-Sharing und die Helm-Chart-Standardwerte geändert; lesen Sie daher die Release-Notes zu v0.3.0 und v1.0.0, bevor Sie mit einem neueren Tag beginnen. Das aktuelle main weist jeder Person einen Container zu und gibt einem als Isolated markierten Bot einen eigenen Container.
Der interessante Teil dieser Architektur ist zugleich der kostspielige Teil. Ein Browser für jeden Agenten verursacht Speicherkosten, die bei der Planung oft vergessen werden; daher steht die Dimensionierung hier vor der Installation.
Wie das Gateway jede Aktion entscheidet
Der API-Server auf Port 3001 ist der kontrollierte Pfad zum Computer eines Bots. Der Computer stellt zudem untergeordnete Service-Endpunkte bereit, die durch Token geschützt sind. Das Projekt gibt vor, diese privat zu halten und niemals zu verwenden, um das Gateway zu umgehen. Das Gateway bleibt also nur dann der einzige Pfad, solange diese Endpunkte nicht erreichbar sind. Bevor eine Browser-Aktion ausgeführt wird, löst das Gateway das Ziel aus einem Seiten-Snapshot auf, wertet CEL-Richtlinienregeln (Common Expression Language) anhand des Kontexts aus, schreibt eine Audit-Zeile mit der Entscheidung und ruft erst danach den Container auf. Schlägt die Ausführung danach fehl, schreibt es eine zweite Zeile. Die Dokumentation definiert die Grenze eindeutig: Der Computer entscheidet nicht über Richtlinien, das Server-Gateway ist die Grenze für Aktionen. Diese Trennung hat außerhalb von OpenBot einen Namen, da die Schleife, die Tool-Definitionen, die Berechtigungsprüfungen und der Sitzungsstatus zusammen das um ein Modell gewickelte Framework bilden, und dieses Gateway ist die Berechtigungshälfte davon.
Die Richtlinienauswertung schlägt fehl und verweigert den Zugriff, und Verbotsregeln werden vor Erlaubnisregeln ausgewertet. Die Richtung des Fehlers ist wichtiger als die Regelsyntax. Eine fehlende oder leere Richtlinie erlaubt nichts, und eine fehlerhafte Regel führt zum Blockieren, unabhängig davon, ob es sich um eine Verbots- oder Erlaubnisregel handelt. Ein Fehler in Ihrer Richtlinie führt also eher zu einem blockierten Bot als zu einem Bot, der unkontrolliert auf Ihre Konten zugreift. Die Richtlinie, die OpenBot mitliefert, ist ein anderer Fall. Ihr Standardwert beim Start ist deny: [] mit allow: ["true"], was jede Aktion erlaubt, bis AGENT_COMPUTER_POLICY oder eine gespeicherte Administratorrichtlinie sie ersetzt. Schreiben Sie daher Ihre eigene Richtlinie, bevor ein Bot auf reale Daten zugreift. Diese Ebene steuert, was ein Bot tut, nicht was er liest. Eine Seite, die Anweisungen für den Agenten enthält, bleibt daher ein separates Problem; dies ist dieselbe Angriffsfläche für Prompt-Injection, die Sie in Kauf nehmen, wenn Sie einem Agenten Ergebnisse aus Ihrer eigenen SearXNG-Instanz übergeben.
Der Audit-Trail liegt in PostgreSQL und übersteht daher einen Neustart. Übergaben der Kontrolle werden als computer.help_requested, computer.control_taken und computer.control_released aufgezeichnet; so sehen Sie, wie ein Bot nach einem Menschen fragt und wie der Mensch die Kontrolle zurückgibt. Geheimnisse werden als Zeichenanzahl aufgezeichnet, niemals als Werte. Dateilese- und Schreibvorgänge sowie Auflistungen erscheinen im Reiter Activity, wo eine gespeicherte Datei als Pfad und Größe angezeigt wird, niemals mit ihrem Inhalt. Diese Ansicht wird im Browser gehalten und ist nicht der Audit-Datensatz. Wenn Sie dieselbe Kontrollgrenze ohne einen Browser im Hintergrund wünschen, behandelt das Absichern von KI-Agenten-Aktionen durch Freigaben diesen engeren Anwendungsfall.
Wie viel ein Bot an RAM und Speicherplatz benötigt
Das Projekt veröffentlicht gemessene Werte für einen einzelnen Bot auf arm64. Diese Größenangaben stammen aus der Deployment-Dokumentation. Sie beschreiben einen Bot auf einer Architektur und sind daher ein Ausgangspunkt, keine Kapazitätsplanung.
Die Daten hinter diesem Diagramm
[
{
"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
}
]Der Spitzenverbrauch wurde für einen Bot mit 0.55 GB gemessen. Das dokumentierte Minimum beträgt 2 GB, die Empfehlung 4 GB. Die Differenz zwischen Messwert und Minimum lässt Chromium unter Last wachsen. Der Speicherbedarf eines Browsers hängt von den geöffneten Seiten ab, nicht vom Leerlaufverbrauch des Prozesses. Laut Dokumentation benötigt jede zusätzlich gleichzeitig geöffnete Seite ungefähr 100 bis 200 MB. Die CPU-Auslastung im Leerlauf liegt am oberen Ende des Messbereichs bei 0.06 eines Kerns und ist damit nicht der entscheidende Kostenfaktor. Das Image ist 1.4 GB groß. Empfohlen wird ein Volume mit 8 GB. Die Differenz bietet Platz für /workspace, wo der Bot seine Dateien speichert. Das Image enthält nur Browser aus der Chromium-Familie. Firefox und WebKit von Playwright sind nicht enthalten.
Diese Angaben zeigen nicht, wie viel mehrere Bots zusammen benötigen. Dazu veröffentlicht das Projekt keinen Wert. Ein dokumentiertes Minimum ist ein Wert, den ein Projekt guten Gewissens angibt. Es handelt sich nicht um einen Wert, der unter Last beobachtet wurde. Deshalb läuft auch die Entscheidung zwischen PhotoPrism und Immich auf deren gemessene RAM-Untergrenzen und nicht auf deren veröffentlichte Angaben hinaus. Messen Sie selbst. Starten Sie einen Bot, geben Sie ihm eine realistische Aufgabe mit einer geöffneten Seite und überwachen Sie den Container während der Ausführung.
docker stats --no-stream
free -mVerwenden Sie die Spalte MEM USAGE für den Container des Bots als Wert pro Bot. Addieren Sie Gateway und PostgreSQL und multiplizieren Sie anschließend den Wert pro Bot mit der erwarteten Anzahl gleichzeitig aktiver Bots. Ein inaktiver Bot behält seinen Browser geöffnet, bis das Inaktivitäts-Timeout ihn schließt. Standardmäßig beträgt dieses Timeout 30 Minuten. Berücksichtigen Sie daher auch inaktive Browser beim Multiplikator. Die Berechnung entspricht der für die Dimensionierung von RAM und CPU für eine Coding-Agent-VPS. Der Browseranteil wird unter der Ausführung eines Headless-Browsers für Agents auf einer VPS erläutert.
Ein Detail von Chromium ist für kleine Pläne relevant. OpenBot startet Chromium mit --disable-dev-shm-usage. Dadurch schreibt der Browser nach /tmp statt nach /dev/shm. Das verhindert den Absturz, der auf Hosts mit einem kleinen /dev/shm auftritt. Gleichzeitig wird die Belastung auf Ihr Root-Dateisystem verlagert. Das ist ein weiterer Grund dafür, dass der empfohlene Speicherplatz größer als das Image ist.
Wie hostet man OpenBot selbst auf einem VPS?
Sie benötigen Docker, Bun 1.3 oder neuer, ein CopilotKit Intelligence-Projekt samt Lizenz sowie Zugriff auf ein Modell, entweder über einen API-Key oder eine unterstützte Anbieter-Anmeldung als Alternative. Die v0.2.0 README verlangt Bun 1.3+ für die App und den API-Server; die aktuelle main hebt dies auf 1.4+ an, lesen Sie daher die README des von Ihnen geklonten Tags. Eine anbieterspezifische Anmeldung kann seit v0.0.15 einen API-Key ersetzen. Die Entwicklungsdokumentation setzt zudem lsof, openssl und curl auf dem System voraus, zuzüglich npx von Node für die Bereitstellung von Intelligence. Klonen Sie ein getaggtes Release statt main, da sich main bei einem so jungen Projekt ohne Vorwarnung ändert. Falls Sie bereits eine v0.1.x-Installation betreiben, lesen Sie die v0.2.0-Release-Notes vor dem Wechsel: Das Upgrade kopiert gespeicherte Composio-Verbindungen in eine neue Tabelle; ein anschließender Rollback auf v0.1.2 macht Konten, die nach dem Upgrade verbunden wurden, unsichtbar.
git clone --branch v0.2.0 https://github.com/CopilotKit/openbot.git
cd openbot
cp .env.example .env
bun installStellen Sie das Intelligence-Projekt bereit. Die ersten beiden Befehle melden Sie an und wählen das Projekt aus. Das Hilfsskript stellt dann den Runtime-Key des Projekts bereit, erstellt oder verwendet dessen openbot Learning-Container und schreibt beide Einstellungen in Ihre Umgebungsdatei.
npx --yes copilotkit@latest login
npx --yes copilotkit@latest project select
bun scripts/setup-learning.tsGenerieren Sie den Schlüssel, der gespeicherte Anmeldedaten verschlüsselt, und speichern Sie die Ausgabe in .env als KEY_ENCRYPTION_KEY. Fügen Sie Ihren OPENAI_API_KEY in derselben Datei hinzu. Der Proof-of-Concept-Bot verwendet OpenAI. Für den LangGraph-Bot können Sie BOT_PROVIDER auf anthropic oder google setzen und den passenden Schlüssel hinzufügen. Um eine Modell-Anmeldung anstelle eines Keys zu verwenden, akzeptiert v0.2.0 .env.example die Werte CLAUDE_CODE_OAUTH_TOKEN, das Token aus claude setup-token sowie CHATGPT_AUTH_FILE, die Datei, die ein angemeldeter ChatGPT-Plan schreibt. Der API-Server liest diese für seine integrierten Agenten aus, und Compose übergibt sie an das von Ihnen gewählte Bot-Harness.
openssl rand -base64 32Während .env geöffnet ist, prüfen Sie die Computereinstellungen. .env.example lässt COMPUTER_SUPERVISOR_URL und SUPERVISOR_TOKEN leer und verweist AGENT_COMPUTER_URL auf den einen gemeinsam genutzten Computer auf Port 4100. Die Compose-Datei enthält den Supervisor, und scripts/start.sh aktiviert standardmäßig Computer pro Bot, indem COMPUTER_SUPERVISOR_URL und SUPERVISOR_TOKEN an den Server übermittelt werden. Wenn Sie den Server selbst starten, setzen Sie beide Werte; ohne eine Supervisor-URL teilt sich jeder Bot diesen einen Browser und dessen Logins.
Starten Sie anschließend.
bash scripts/start.shscripts/start.sh startet die Docker-Dienste, führt die Datenbankmigrationen durch, startet den Server, den Routine-Worker sowie die App und prüft deren Status. Nach Abschluss antwortet die App auf Port 3010 und die API auf Port 3001. Das Skript meldet Portkonflikte und lässt bereits laufende, passende Dienste unverändert, sodass ein zweimaliger Aufruf sicher ist.
Prüfen Sie dies vom Server aus, bevor Sie Dienste nach außen freigeben.
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3010
ss -ltnp | grep -E ':(3010|3001|4100|4500|5432)'Ein 200 beim ersten Befehl bedeutet, dass die App Anfragen verarbeitet. Der zweite Befehl zeigt an, an welche Adressen diese Ports gebunden sind; dies ist die entscheidende Information auf einem VPS. Eine Zeile mit 127.0.0.1:3001 ist nur lokal auf dem Server verfügbar. Eine Zeile mit 0.0.0.0:3001 bedeutet, dass jeder, der den Server erreichen kann, auch auf den Dienst zugreifen kann.
Das einzelne Container-Image
Die Bereitstellungsdokumentation enthält auch ein einzelnes Image, das die Anwendung, die API und Chromium enthält und auf Port 3001 bereitgestellt wird. Es wird als ghcr.io/copilotkit/openbot mit Versions-Tags veröffentlicht. Alternativ können Sie es aus Ihrem Clone erstellen.
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 führt PostgreSQL im Container aus und wendet beim Start Migrationen an. Das benannte Volume bewahrt den Audit-Verlauf bei einer erneuten Bereitstellung. Ohne dieses Volume geht der Verlauf bei jedem Neuaufbau verloren. Binden Sie es im übergeordneten Verzeichnis /var/lib/postgresql ein, nicht direkt im Datenverzeichnis. Die Dokumentation warnt davor, dass das Einbinden des Datenverzeichnisses dazu führen kann, dass der Cluster nicht initialisiert wird. Die Anwendung antwortet dann mit einem 502-Fehler. Wenn Sie DATABASE_URL stattdessen auf eine verwaltete Datenbank verweisen, muss die Erweiterung vector dort aktiviert sein. Verwaltete Dienste wie RDS, Cloud SQL und Azure Database unterstützen die Erweiterung. Keiner dieser Dienste aktiviert sie automatisch. Die Migrationen erwarten außerdem, dass die Rolle, unter der sie ausgeführt werden, Eigentümerin der Erweiterung ist. Wurde die Erweiterung unter einer anderen Rolle erstellt, brechen die Migrationen mit must be owner of extension vector ab.
Führen Sie Migrationen als Release-Schritt aus, wenn die Datenbank extern betrieben wird.
docker run --rm --env-file .env --entrypoint sh openbot \
-c "cd /app/server && bun scripts/migrate.ts"Verwenden Sie scripts/migrate.ts und nicht drizzle-kit migrate, weil die drizzle-kit-CLI eine Entwicklungsabhängigkeit ist und im Produktions-Image fehlt. Behalten Sie --entrypoint sh bei. Ohne diese Option startet die API, bevor die Migrationen ausgeführt wurden.
Dieses Image veröffentlicht den Browser-Port absichtlich nicht. Es enthält außerdem keinen Supervisor, weil der Supervisor den Docker-Socket benötigt und serverlose Plattformen diesen nicht bereitstellen. Ohne den Supervisor verwenden alle Bots denselben Browser und damit denselben Satz an Anmeldungen. Dadurch fehlt die Isolation, die Container pro Bot sinnvoll macht. Dieser Weg mit einem einzelnen Container ist der einzige, bei dem kein Bot einen eigenen Container erhält. Wenn separate Anmeldungen pro Bot der Grund für Ihre Entscheidung sind, führen Sie den Compose-Stack mit gesetzten Variablen COMPUTER_SUPERVISOR_URL und SUPERVISOR_TOKEN auf einem Host aus, auf dem Sie dieses Risiko akzeptieren. Ein Prozess, der mit dem Docker-Socket kommunizieren kann, kann einen privilegierten Container starten. In der Praxis hat er damit Root-Rechte auf dem Host. Das ist ein guter Grund, OpenBot auf einer eigenen Maschine zu betreiben. Das entspricht dem Ansatz, Coding-Agenten eine wegwerfbare VM bereitzustellen.
Warum OPENBOT_SINGLE_USER eine Einstellung für Laptops ist
.env.example wird mit OPENBOT_SINGLE_USER=true ausgeliefert. Diese Einstellung akzeptiert jede Anfrage als einen festen Administrator und überspringt die Anmeldung vollständig. Auf einem Laptop ist dies komfortabel, da nur Sie als Client den Port erreichen können. Auf einem VPS bedeutet dies jedoch, dass jeder, der Port 3010 erreicht, als dieser Administrator agiert – auf einem System, das verschlüsselte Anmeldedaten speichert und einen Browser steuert, der bereits bei Ihren Konten angemeldet ist.
Der Server überwacht dies nun teilweise. Wenn OPENBOT_SINGLE_USER=true gesetzt ist und ein OPENBOT_PUBLIC_URL-, OPENBOT_APP_URL- oder TRUSTED_ORIGINS-Eintrag öffentlich geroutet wird, verweigert der Server den Start und nennt die entsprechende Adresse. Eine private Adresse führt lediglich zu einer Warnung. Diese Prüfung liest die URLs in Ihrer Konfiguration, nicht die Schnittstellen, die Docker veröffentlicht. Daher passieren die Standardwerte für localhost die Prüfung, selbst wenn ein Port zum Internet hin offen ist. Das Binding bleibt weiterhin Ihre Aufgabe.
Es gibt zwei korrekte Methoden für den Betrieb. Behalten Sie OPENBOT_SINGLE_USER=true bei, binden Sie jeden Port an 127.0.0.1 und erreichen Sie die Anwendung ausschließlich über einen SSH-Tunnel oder eine private Netzwerkschnittstelle.
ssh -N -L 3010:127.0.0.1:3010 -L 3001:127.0.0.1:3001 you@your-vpsDie Anwendung ist dann unter http://localhost:3010 in Ihrem Browser verfügbar. Chrome und Firefox behandeln diese Adresse als sicheren Kontext und behalten Secure-Anmelde-Cookies bei, die darüber gesetzt wurden. Safari bildet hier die Ausnahme: Es meldet localhost zwar ebenfalls als sicheren Kontext, verweigert aber (Stand 10. November 2026) weiterhin das Speichern eines Secure-Cookies über unverschlüsseltes http://localhost. Dies ist ein bekannter WebKit-Bug. Öffnen Sie den Tunnel daher in Chrome oder Firefox oder schalten Sie TLS davor. Der Live-Bildschirm selbst benötigt keinen sicheren Kontext: Die Bereitstellungsdokumentation besagt, dass die Anwendung keine der Browser-APIs benötigt, die bei einfachem http:// eingeschränkt sind. Der andere Weg besteht darin, den Single-User-Modus zu deaktivieren und einen echten Identitätsanbieter zu konfigurieren. Google, Microsoft Entra, Okta, SAML und OIDC werden unterstützt. Google, Entra und Okta werden über die Umgebungsvariablen konfiguriert, während SAML- und OIDC-Anbieter unter Admin, Identity providers registriert werden, sobald die Bereitstellung läuft. Jeder Anbieter benötigt zudem BETTER_AUTH_SECRET mit mindestens 32 Zeichen, BETTER_AUTH_URL gesetzt auf die öffentliche API-Basis-URL für OAuth-Callbacks, sowie INITIAL_ADMIN_EMAILS. TRUSTED_ORIGINS steht nicht auf der Liste der erforderlichen Variablen, enthält aber die App-Ursprünge, die die API akzeptiert, sowie jeden Host im Discovery-Dokument eines registrierten OIDC-Anbieters. Da OPENBOT_APP_URL standardmäßig den ersten Eintrag verwendet, setzen Sie diesen auf Ihren öffentlichen App-Ursprung. Die Anmeldedaten des Anbieters müssen vollständig sein, da ein unvollständig konfigurierter Anbieter den Start verhindert, anstatt auf einen offenen Zugriff zurückzufallen. Falls Sie Konten hinzufügen, weil jedes Teammitglied einen eigenen Agenten statt eines eigenen Browsers benötigt: OneCLI ist von Grund auf für dieses Szenario konzipiert, mit einem isolierten Agenten pro Person und den Modellschlüsseln in einem zentralen Gateway.
Wenn die Anwendung über einen öffentlichen Namen erreichbar ist, schalten Sie TLS (Transport Layer Security) davor. Eine Seite, die über unverschlüsseltes http:// auf etwas anderem als localhost bereitgestellt wird, ist kein sicherer Kontext. Daher werden Cookies mit der Markierung Secure nicht gespeichert, und die Anmeldung schlägt fehl, was wie ein Fehler in OpenBot aussieht.
Untere Ports mit der Firewall absichern
In OpenBots eigenem Sicherheitshinweis steht, dass die Endpunkte der unteren Dienste durch Tokens geschützt sind, privat bleiben sollen und nicht zum Umgehen des Gateways verwendet werden dürfen. Tokens sind der zweite Schutz. Der erste Schutz besteht darin, dass der Port überhaupt nicht erreichbar ist.
Der Agent-Computer lauscht auf 4100 und benötigt COMPUTER_TOKEN. Die Bot-Endpunkte lauschen auf 4200 und 4201, und der Agent-Harness lauscht auf 4202. Der Supervisor lauscht auf dem Host auf 4500 und innerhalb seines Containers auf 4300. Die Compose-Datei bindet ihn an 127.0.0.1:4500. PostgreSQL lauscht auf 5432. Keiner dieser Ports gehört an eine öffentliche Schnittstelle. Bei einer Einzelbenutzerinstallation gilt das auch für die Anwendung und die API.
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw enable
sudo ufw status verboseHier gibt es eine Falle, in die Anwender geraten, die davon ausgehen, dass die Firewall ausreicht. Wenn Sie einen Container-Port mit -p 3001:3001 veröffentlichen, richtet Docker eine DNAT-Regel ein. Der Datenverkehr wird dann im FORWARD-Pfad verarbeitet und durchläuft nie die INPUT-Kette, für die ufws standardmäßige Deny-Regel gilt. Der Port bleibt offen, obwohl ufw status weiterhin Status: active ausgibt. Binden Sie den veröffentlichten Port direkt in der Zuordnung an Loopback, zum Beispiel mit -p 127.0.0.1:3001:3001, oder setzen Sie die Hostadresse in Ihrer Compose-Datei. Prüfen Sie dies mit ss -ltnp, nicht mit ufw status. Diese Falle ist nicht spezifisch für OpenBot. Führen Sie daher dieselbe Prüfung für jeden anderen Container aus, den Sie auf diesem Host veröffentlicht haben, einschließlich des Dienstes, der eine als Videothek der 90er-Jahre neu aufgebaute Jellyfin-Mediathek bereitstellt.
OpenBot kann mit selbst gehosteter Intelligence offline betrieben werden
Stellen Sie dies fest, bevor Sie die Bereitstellung planen. OpenBot ist von einem CopilotKit Intelligence-Projekt abhängig, das dauerhafte Threads und Konversationsverläufe auf dem gehosteten Dienst oder Ihrer eigenen Infrastruktur speichert. Der fixierte v0.2.0-Server validiert INTELLIGENCE_API_URL, INTELLIGENCE_GATEWAY_WS_URL und INTELLIGENCE_API_KEY beim Start. Er prüft die drei Werte als Set und verweigert den Start, falls einer davon fehlt. COPILOTKIT_LICENSE_TOKEN ist optional und wird nur von einer selbst gehosteten Intelligence mit eigener Lizenz verwendet. Stand 10. November 2026 beinhaltet die kostenlose gehostete Intelligence 1.000 Interaktionen pro Organisation und Monat, aber seit v0.1.0 zeigt OpenBot ein Banner für das Self-Hosting an, sofern die Bereitstellung keinen kostenpflichtigen Intelligence-Plan besitzt oder OPENBOT_SELF_HOST_BANNER=false gesetzt ist. Intelligence ist selbst hostbar, daher ist eine vollständig lokale Bereitstellung möglich, erfordert jedoch mehr Aufwand als im Quickstart beschrieben. Eine Offline-Produktionsumgebung erfordert den Annual-Plan; eine selbst gehostete nutzungsbasierte Abrechnung muss eine Verbindung herstellen, um die Nutzung für die Rechnungsstellung zu melden. Die kostenlose Developer Edition unterstützt die lokale Evaluierung außerhalb der Produktion mit einer verlängerbaren 30-Tage-Lizenz; Installation und Verlängerung erfordern Internetzugriff. Das lokale Intelligence-CLI schreibt seinen Schlüssel als CPK_INTELLIGENCE_API_KEY, während das fixierte v0.2.0-Release nur INTELLIGENCE_API_KEY liest; kopieren Sie daher den Wert für dieses Release. Das aktuelle main akzeptiert den CLI-Schlüssel direkt und priorisiert diesen.
Das Modell ist die zweite Abhängigkeit. Nichts wird standardmäßig mitgeliefert. BOT_PROVIDER akzeptiert openai, anthropic oder google für den LangGraph Bot, und OPENAI_BASE_URL leitet den OpenAI-Pfad an einen beliebigen kompatiblen Endpunkt weiter. Hier setzt Ollama auf einem VPS ausführen, um ein LLM selbst zu hosten an, wenn Sie möchten, dass die Token auf Ihrer eigenen Hardware verbleiben. Die Browser-Steuerung stellt hohe Anforderungen an ein Modell; testen Sie daher ein lokales Modell an einer echten Aufgabe, bevor Sie sich darauf festlegen.
Über eine einzelne Replica hinaus skalieren
Das Gateway löst Elementreferenzen anhand eines Seiten-Snapshots auf. Dieser Snapshot liegt jetzt in PostgreSQL. Daher kann eine zweite Replica mit einem Snapshot arbeiten, den die erste Replica erstellt hat. Das offizielle Helm-Chart führt standardmäßig zwei API-Replicas aus und speichert alles, was eine Replica zum Überleben benötigt, in PostgreSQL. Außerdem deaktiviert es den eingebetteten Computer und verweigert dessen Installation, wenn mehr als eine Replica vorhanden ist. Ein Browser im API-Pod würde die Logins eines Bots speichern. Bei einer Skalierung der API würden sich diese Logins vervielfachen. Das Single-Image ist der zu beachtende Fall, weil jede Replica ihren eigenen Browser enthält. Die Logins eines Bots bleiben daher auf der Instanz, die sie bedient hat. Auf einem einzelnen VPS laufen die Browser aller Bots weiterhin auf demselben Host. Sie skalieren daher, indem Sie den Rechner leistungsfähiger machen. Die Isolation zwischen Bots wird weiterhin durch die Container pro Bot erreicht. Das funktioniert genauso wie bei Self-Hosted-Agent-Sandboxes, die Fehler eines Agents von den anderen fernhalten.
Fehlermodi und was Sie sehen werden
Der Startvorgang bricht unmittelbar nach dem Ausfüllen von .env ab. Der Server validiert die Konfiguration, bevor er Dienste bereitstellt. Jeder der folgenden Punkte verhindert den Start, anstatt den Dienst in einem eingeschränkten Zustand auszuführen: ein unvollständiger Intelligence-Block, ein fehlendes KEY_ENCRYPTION_KEY, ein OAuth-Anbieter mit Client-ID ohne Secret oder der Single-User-Modus in Kombination mit einer öffentlichen URL. Lesen Sie die erste Fehlermeldung, korrigieren Sie das entsprechende Feld und starten Sie erneut.
Migrationen schlagen bei einer verwalteten Datenbank fehl. Es gibt zwei wahrscheinliche Ursachen. Die Erweiterung vector ist möglicherweise nicht aktiviert und die migrierende Rolle kann sie nicht erstellen, wodurch die Migration auf einen PostgreSQL-Spaltentyp stößt, der nicht bekannt ist. Alternativ wurde die Erweiterung unter einer anderen Rolle erstellt, und die Migration bricht mit must be owner of extension vector ab. Erstellen Sie die Erweiterung mit der Rolle, die die Migrationen ausführt, und wiederholen Sie anschließend den Migrationsschritt.
Die Anwendung lädt, aber die Anmeldung bleibt nicht bestehen. Sie betreiben den Dienst über unverschlüsseltes http:// an einer öffentlichen Adresse, was keinen sicheren Kontext darstellt, weshalb das Secure-Cookie verworfen wird. Schalten Sie TLS vor oder verwenden Sie einen SSH-Tunnel, damit der Browser localhost erkennt. Verwenden Sie über den Tunnel Chrome oder Firefox, da Safari weiterhin Secure-Cookies verwirft, die über unverschlüsseltes http://localhost gesetzt wurden.
Bots teilen sich Anmeldungen, die eigentlich getrennt sein sollten. Der Supervisor ist nicht in Verwendung, daher gibt es keinen rechnerbasierten Kontext pro Bot und jeder Bot nutzt den gemeinsam genutzten Browser unter AGENT_COMPUTER_URL. Stellen Sie sicher, dass COMPUTER_SUPERVISOR_URL gesetzt ist und der Supervisor den Docker-Socket erreichen kann.
Ein Bot hält an und bittet um Hilfe. Dies entspricht dem vorgesehenen Verhalten. Der Audit-Trail protokolliert computer.help_requested, Sie übernehmen die Kontrolle auf dem Live-Bildschirm und die Übergabe wird auf beiden Seiten aufgezeichnet.
FAQ
Ist es sicher, OPENBOT_SINGLE_USER für ein VPS-Deployment aktiviert zu lassen?
Nur dann, wenn das Gateway nicht aus dem Internet erreichbar ist. OPENBOT_SINGLE_USER=true akzeptiert jede Anfrage als einen festen Administrator ohne Anmeldung. Jeder, der den Port öffnen kann, übernimmt damit die Kontrolle über das Deployment, die gespeicherten Anmeldedaten und den angemeldeten Browser. In diesem Modus verweigert der Server den Start, wenn eine konfigurierte öffentliche URL oder ein vertrauenswürdiger Ursprung öffentlich geroutet wird. Diese Prüfung kann jedoch nicht erkennen, wie Ihre Ports veröffentlicht werden. Es ist akzeptabel, wenn jeder Port an 127.0.0.1 gebunden ist und Sie die Anwendung über einen SSH-Tunnel oder eine private Netzwerkschnittstelle erreichen. Auf einer öffentlichen Schnittstelle sollten Sie diese Option deaktivieren und Google, Microsoft Entra, Okta oder OIDC zusammen mit BETTER_AUTH_SECRET, BETTER_AUTH_URL und INITIAL_ADMIN_EMAILS konfigurieren sowie TRUSTED_ORIGINS auf Ihren öffentlichen Anwendungsursprung setzen.
Wie viel RAM benötigt ein OpenBot-Bot?
Die veröffentlichten Zahlen des Projekts für einen einzelnen Bot auf arm64 geben den Spitzenwert des Speichers mit 0.55 GB an, wobei 2 GB als dokumentiertes Minimum und 4 GB empfohlen werden. Es gibt keine veröffentlichte Zahl für mehrere Bots gleichzeitig, da jeder Bot eine eigene Chromium-Instanz verwendet. Führen Sie einen Bot für eine reale Aufgabe aus, lesen Sie den Speicherverbrauch dieses Containers in docker stats ab, addieren Sie Gateway und Datenbank und multiplizieren Sie den Wert mit der Anzahl der Bots, die Sie gleichzeitig betreiben möchten.
Benötige ich ein CopilotKit-Konto, um OpenBot selbst zu hosten?
Ja. OpenBot ist für dauerhafte Threads und Speicher von einem CopilotKit Intelligence-Projekt abhängig. Der festgelegte v0.2.0-Server verweigert den Start, sofern die Intelligence-API-URL, die Gateway-WebSocket-URL und der API-Schlüssel nicht gesetzt sind. Ein kostenloser gehosteter Plan ist seit dem 10. November 2026 verfügbar. Ein Offline-Produktions-Deployment wird mit selbst gehosteter Intelligence im Rahmen eines Annual-Plans und einem lokalen Modell unterstützt. Sie müssen zudem Ihren eigenen Modellzugang, einen Modell-API-Schlüssel oder eine unterstützte Anbieteranmeldung bereitstellen, da OpenBot ohne vorinstalliertes Modell ausgeliefert wird.
Warum erhält jeder Bot einen eigenen Browser, anstatt sich einen zu teilen?
Weil ein Browser-Profil eine Identität darstellt. Ein gemeinsam genutzter Browser bedeutet geteilte Cookies und geteilte Sitzungen; ein Bot, der bei einem Konto angemeldet ist, würde bedeuten, dass alle Bots bei diesem Konto angemeldet sind. Container pro Bot geben jedem Mitarbeiter ein eigenes Profil und eigene Anmeldedaten, jedoch nur, wenn COMPUTER_SUPERVISOR_URL den Server auf den Supervisor verweist. Ohne diese Konfiguration teilt sich jeder Bot einen Browser. Der Preis dafür ist der Arbeitsspeicher, da eine Chromium-Instanz pro Bot den größten Einzelposten bei der Dimensionierung darstellt.
Welche OpenBot-Ports sollten in der Firewall geöffnet sein?
Keiner der Low-Level-Ports. Der Agent-Computer auf 4100, die Bot-Endpunkte auf 4200 und 4201, das Agent-Harness auf 4202, der Supervisor auf 4500 und PostgreSQL auf 5432 bleiben alle privat. Das Projekt schützt diese mit Token und empfiehlt, sie ohnehin nicht erreichbar zu halten. Veröffentlichen Sie nur das, was ein Benutzer zwingend öffnen muss. Denken Sie daran, dass ein mit -p 3001:3001 veröffentlichter Container-Port ungeachtet einer ufw-Default-Deny-Regel erreichbar ist, da die DNAT-Regel von Docker diesen Datenverkehr in den FORWARD-Pfad leitet, anstatt ihn über INPUT zu führen.