SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor · Zaktualizowano 2026-11-11

Samodzielny hosting OpenBot AI na własnym serwerze VPS

Dowiedz się jak wdrożyć OpenBot z nadzorcą kontenerów. Sprawdź konfigurację COMPUTER_SUPERVISOR_URL, izolację przeglądarek Chromium oraz realne zużycie pamięci RAM przez agentów.

Co otrzymuje się podczas samodzielnego hostowania współpracowników AI OpenBot

Samodzielne hostowanie współpracowników AI OpenBot polega na uruchomieniu jednego serwera gateway na sprzęcie pozostającym pod kontrolą użytkownika oraz supervisora, który przydziela każdemu botowi osobny kontener. Kontener przypisany do bota istnieje tylko wtedy, gdy ustawiono COMPUTER_SUPERVISOR_URL. Bez tego wszystkie boty korzystają z jednego komputera wskazanego w AGENT_COMPUTER_URL. Po wdrożeniu supervisora każdy kontener bota zawiera własną przeglądarkę Chromium i własny wolumen workspace, a profil przeglądarki jest zachowywany między sesjami. Każde działanie bota na komputerze, pliku, serwerze MCP (model context protocol) lub komponencie UI przechodzi przez ten gateway. Gateway sprawdza działanie względem polityki przed jego wykonaniem i rejestruje je po wykonaniu. Jeżeli pętla agenta opakowywana przez ten gateway jest jeszcze nieznanym zagadnieniem, ścieżka etapowa w nauce agentów AI od podstaw prowadzi najpierw przez samodzielne napisanie niewielkiej pętli, zanim bot otrzyma dostęp do przeglądarki i danych logowania.

OpenBot jest publikowany przez CopilotKit na licencji MIT pod adresem github.com/CopilotKit/openbot. Pierwsze oznaczone wydanie, v0.0.1, opublikowano 17 August 2026, a v0.2.0 ukazało się 12 October 2026. Na dzień 10 November 2026 najnowszym wydaniem jest v1.0.0, opublikowane 9 November 2026, trzy dni po v0.3.0, a plik README w main nie zawiera już informacji o wersji beta. Należy traktować ten projekt jako poważną architekturę z wciąż obecnymi niedopracowanymi elementami. Poniższe wdrożenie przypina v0.2.0, a każdy krok opisuje właśnie tę wersję. v0.3.0 zmieniło zatwierdzanie, współdzielenie przeglądarki oraz wartości domyślne chartu Helm, dlatego przed rozpoczęciem pracy z nowszym tagiem należy zapoznać się z informacjami o wydaniach v0.3.0 i v1.0.0. Bieżące main przydziela każdej osobie kontener, a botowi oznaczonemu jako Isolated przydziela osobny kontener.

Najciekawszy element tej architektury jest zarazem najbardziej kosztowny. Przeglądarka dla każdego agenta powoduje największe zużycie pamięci, którego wiele osób nie uwzględnia w planowaniu, dlatego w tym przypadku najpierw należy określić wymagania sprzętowe, a dopiero potem przeprowadzić instalację.

W jaki sposób bramka podejmuje każdą akcję

Serwer API na porcie 3001 stanowi kontrolowaną ścieżkę dostępu do komputera bota. Komputer udostępnia również niskopoziomowe punkty końcowe usług, zabezpieczone tokenami. Dokumentacja projektu zaleca zachowanie ich prywatności i nieużywanie ich do omijania bramki, dzięki czemu bramka pozostaje jedyną ścieżką dostępu, gdy wspomniane punkty końcowe są nieosiągalne. Przed wykonaniem akcji w przeglądarce bramka rozpoznaje cel na podstawie zrzutu strony, ocenia reguły polityki CEL (common expression language) w odniesieniu do kontekstu, zapisuje wiersz audytu zawierający decyzję i dopiero wtedy wywołuje kontener. Jeśli po tym kroku wykonanie zakończy się niepowodzeniem, zapisywany jest drugi wiersz. Dokumentacja jasno określa granicę: komputer nie decyduje o polityce, to bramka serwera jest granicą akcji. Ten podział posiada nazwę poza OpenBot, ponieważ pętla, definicje narzędzi, sprawdzanie uprawnień oraz stan sesji tworzą łącznie mechanizm otaczający model, a niniejsza bramka stanowi połowę odpowiedzialną za uprawnienia.

Ocena polityki domyślnie blokuje dostęp (fail-closed), a reguły odmowy (deny) są oceniane przed regułami zezwolenia (allow). Kierunek niepowodzenia ma większe znaczenie niż składnia reguły. Brakująca lub pusta polityka nie zezwala na nic, a błędna reguła skutkuje blokadą niezależnie od tego, czy jest to reguła odmowy, czy zezwolenia. Dzięki temu błąd w polityce skutkuje zablokowaniem bota, a nie jego niekontrolowanym działaniem na kontach użytkownika. Polityka dostarczana z OpenBot to inna kwestia. Domyślne ustawienie przy starcie to deny: [] z allow: ["true"], co zezwala na każdą akcję, dopóki AGENT_COMPUTER_POLICY lub zapisana polityka administratora nie zastąpi tego ustawienia. Należy zatem napisać własną politykę, zanim bot uzyska dostęp do rzeczywistych zasobów. Ta warstwa reguluje działania bota, a nie to, co bot odczytuje. Strona zawierająca instrukcje skierowane do agenta pozostaje odrębnym problemem, co stanowi ten sam obszar ataku typu prompt injection, z którym użytkownik mierzy się, gdy przekazuje agentowi wyniki z własnej instancji SearXNG.

Ścieżka audytu przechowywana jest w PostgreSQL, dzięki czemu przetrwa restart. Przekazanie kontroli jest rejestrowane jako computer.help_requested, computer.control_taken oraz computer.control_released. W ten sposób można sprawdzić, kiedy bot prosi o interwencję człowieka oraz kiedy człowiek przejmuje kontrolę z powrotem. Sekrety są rejestrowane jako liczba znaków, nigdy jako wartości. Odczyty, zapisy i listowanie plików są widoczne w karcie Activity, gdzie zapisany plik pojawia się jako ścieżka i rozmiar, nigdy jako zawartość. Ten widok jest utrzymywany w przeglądarce i nie stanowi rekordu audytu. Jeśli wymagana jest ta sama granica kontroli bez użycia przeglądarki, artykuł ograniczanie akcji agenta AI poprzez zatwierdzenia omawia ten węższy przypadek.

Koszt jednego bota w pamięci RAM i na dysku

Projekt publikuje zmierzone wartości dla pojedynczego bota na architekturze arm64. Są to liczby dotyczące rozmiaru podane w dokumentacji wdrożeniowej; opisują one jednego bota na jednej architekturze, dlatego należy traktować je jako punkt wyjścia, a nie plan wydajnościowy.

WykresOpenBot published resource figures, one Bot on arm64 (October 2026)
Dane, na których opiera się ten wykres
[
  {
    "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
  }
]

Szczytowe zużycie pamięci dla jednego bota zmierzono na poziomie 0.55 GB, podczas gdy udokumentowane minimum wynosi 2 GB, a zalecana wartość to 4 GB. Różnica między pomiarem a minimum stanowi margines na wzrost zapotrzebowania Chromium pod obciążeniem, ponieważ zużycie pamięci przez przeglądarkę zależy od otwartych stron, a nie od procesu w stanie spoczynku. Dokumentacja określa zapotrzebowanie każdej dodatkowej otwartej strony na około 100 do 200 MB. Zużycie procesora w stanie bezczynności jest bliskie zeru i wynosi 0.06 rdzenia w górnej granicy zakresu pomiarowego, więc to nie procesor jest głównym kosztem. Obraz zajmuje 1.4 GB przy zalecanej objętości wolumenu 8 GB; różnica ta stanowi miejsce na /workspace, gdzie bot przechowuje swoje pliki. Obraz zawiera wyłącznie przeglądarki z rodziny Chromium. Przeglądarki Firefox i WebKit z pakietu Playwright zostały wykluczone.

Powyższe dane nie określają kosztu działania wielu botów jednocześnie, a projekt nie publikuje takich szacunków. Udokumentowane minimum to wartość, którą projekt uznaje za bezpieczną do publikacji, a nie wynik zaobserwowany pod obciążeniem. Z tego samego powodu wybór między PhotoPrism a Immich sprowadza się do ich zmierzonego minimalnego zapotrzebowania na pamięć RAM, a nie wartości deklarowanych. Należy przeprowadzić własne pomiary. Należy uruchomić jednego bota, zlecić mu realne zadanie z otwartą stroną i monitorować kontener podczas pracy.

docker stats --no-stream
free -m

Należy przyjąć wartość z kolumny MEM USAGE dla kontenera bota jako koszt jednostkowy, dodać do tego zapotrzebowanie bramy i PostgreSQL, a następnie pomnożyć wynik przez liczbę botów, które mają działać jednocześnie. Bezczynny bot utrzymuje proces przeglądarki do momentu upłynięcia limitu czasu bezczynności, domyślnie 30 minut, więc bezczynne przeglądarki należy uwzględnić w mnożniku. Obliczenia są identyczne z tymi stosowanymi przy doborze pamięci RAM i procesora dla agenta programistycznego na VPS, a kwestia przeglądarki została omówiona w uruchamianiu przeglądarki bez interfejsu graficznego dla agentów na VPS.

Jeden szczegół dotyczący Chromium wpływa na małe plany. OpenBot uruchamia Chromium z flagą --disable-dev-shm-usage, dzięki czemu przeglądarka zapisuje dane w /tmp zamiast w /dev/shm. Pozwala to uniknąć awarii występujących na hostach z małym /dev/shm i przenosi obciążenie na główny system plików, co stanowi kolejny powód, dla którego zalecany rozmiar dysku jest większy niż rozmiar obrazu.

Jak samodzielnie uruchomić OpenBot na VPS?

Potrzebne są Docker, Bun 1.3 lub nowszy, projekt i licencja CopilotKit Intelligence oraz dostęp do modelu: klucz API albo logowanie u obsługiwanego dostawcy zamiast klucza. Plik README w v0.2.0 wymaga Bun 1.3+ dla aplikacji i serwera API, natomiast bieżące main podnosi to wymaganie do 1.4+. Należy więc przeczytać plik README dla klonowanego tagu. Logowanie u dostawcy może zastępować klucz API od v0.0.15. Dokumentacja deweloperska wymaga również lsof, openssl i curl w systemie oraz npx z Node do aprowizacji Intelligence. Należy sklonować oznaczone wydanie zamiast main, ponieważ main w tak młodym projekcie zmienia się bez ostrzeżenia. W przypadku istniejącej instalacji v0.1.x przed aktualizacją należy przeczytać informacje o wydaniu v0.2.0. Aktualizacja kopiuje zapisane połączenia Composio do nowej tabeli, a późniejszy powrót do v0.1.2 ukrywa każde konto połączone po aktualizacji.

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

Należy aprowizować projekt Intelligence. Pierwsze dwa polecenia służą do zalogowania się i wybrania projektu. Następnie skrypt pomocniczy aprowizuje klucz środowiska wykonawczego tego projektu, tworzy kontener openbot Learning lub używa istniejącego kontenera oraz zapisuje oba ustawienia w pliku środowiskowym.

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

Należy wygenerować klucz szyfrujący zapisane dane uwierzytelniające i zapisać wynik w .env jako KEY_ENCRYPTION_KEY. W tym samym pliku należy dodać OPENAI_API_KEY. Bot proof-of-concept korzysta z OpenAI. W przypadku LangGraph Bot można ustawić BOT_PROVIDER na anthropic lub google i dodać odpowiedni klucz. Aby użyć logowania do modelu zamiast klucza, v0.2.0 .env.example przyjmuje CLAUDE_CODE_OAUTH_TOKEN, czyli token z claude setup-token, oraz CHATGPT_AUTH_FILE, czyli plik zapisywany przez zalogowany plan ChatGPT. Serwer API odczytuje te wartości dla wbudowanych agentów, a compose przekazuje je do wybranego środowiska Bot.

openssl rand -base64 32

Przy otwartym .env należy sprawdzić ustawienia komputerów. .env.example pozostawia COMPUTER_SUPERVISOR_URL i SUPERVISOR_TOKEN puste oraz wskazuje AGENT_COMPUTER_URL na jeden współdzielony komputer na porcie 4100. Plik compose zawiera supervisor, a scripts/start.sh domyślnie włącza osobne komputery dla botów, przekazując do serwera COMPUTER_SUPERVISOR_URL i SUPERVISOR_TOKEN. W przypadku samodzielnego uruchamiania serwera należy ustawić obie wartości. Bez adresu URL supervisora wszystkie boty współdzielą tę samą przeglądarkę i dane logowania.

Następnie należy uruchomić usługi.

bash scripts/start.sh

scripts/start.sh uruchamia usługi Docker, wykonuje migracje bazy danych, uruchamia serwer, worker zadań cyklicznych i aplikację oraz sprawdza ich stan. Po zakończeniu aplikacja odpowiada na porcie 3010, a API na porcie 3001. Skrypt zgłasza konflikty portów i pozostawia już uruchomioną zgodną usługę bez zmian, dlatego ponowne wykonanie jest bezpieczne.

Przed udostępnieniem usługi należy sprawdzić ją bezpośrednio na serwerze.

curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3010
ss -ltnp | grep -E ':(3010|3001|4100|4500|5432)'

200 z pierwszego polecenia oznacza, że aplikacja obsługuje żądania. Drugie polecenie pokazuje adresy, na których nasłuchują te porty. Na VPS jest to najważniejsza informacja. Wiersz 127.0.0.1:3001 oznacza, że port jest dostępny tylko lokalnie na serwerze. Wiersz 0.0.0.0:3001 oznacza, że może się z nim połączyć każdy, kto ma trasę do tego serwera.

Pojedynczy obraz kontenera

Dokumentacja wdrożeniowa udostępnia również pojedynczy obraz zawierający aplikację, API oraz Chromium, działający na porcie 3001. Jest on publikowany jako ghcr.io/copilotkit/openbot wraz z tagami wersji; można go również zbudować samodzielnie z klonu repozytorium.

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 uruchamia PostgreSQL wewnątrz kontenera i wykonuje migracje podczas startu. Nazwany wolumen przechowuje historię audytu po ponownym wdrożeniu; bez niego każde przebudowanie usuwa tę historię. Należy go zamontować w katalogu nadrzędnym, /var/lib/postgresql, a nie bezpośrednio w katalogu danych. Dokumentacja ostrzega, że montowanie katalogu danych może spowodować, iż klaster pozostanie niezainicjowany, co skutkuje zwracaniem przez aplikację błędu 502. Jeśli zamiast tego wskażesz DATABASE_URL na zarządzaną bazę danych, musi być na niej włączone rozszerzenie vector. Usługi zarządzane, takie jak RDS, Cloud SQL oraz Azure Database, obsługują to rozszerzenie, jednak żadna z nich nie włącza go automatycznie. Migracje wymagają również, aby rola, która je wykonuje, była właścicielem rozszerzenia; jeśli zostało ono utworzone przez inną rolę, proces zatrzyma się z błędem must be owner of extension vector.

W przypadku zewnętrznej bazy danych migracje należy uruchamiać jako krok wdrożeniowy.

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

Użyj scripts/migrate.ts, a nie drizzle-kit migrate, ponieważ drizzle-kit CLI jest zależnością programistyczną, której nie ma w obrazie produkcyjnym. Zachowaj --entrypoint sh, ponieważ bez tego API uruchomi się przed zakończeniem migracji.

Ten obraz celowo nie publikuje portu przeglądarki. Pominięto w nim również nadzorcę (supervisor), ponieważ wymaga on dostępu do gniazda Docker, czego platformy serverless nie oferują. Bez nadzorcy każdy bot współdzieli jedną przeglądarkę, a tym samym jeden zestaw danych logowania, co eliminuje izolację uzasadniającą uruchamianie osobnych kontenerów dla każdego bota. Ta ścieżka z pojedynczym kontenerem nigdy nie zapewnia botowi własnego, odizolowanego środowiska. Jeśli powodem korzystania z tego rozwiązania jest potrzeba osobnych danych logowania dla każdego bota, uruchom stos compose z ustawionymi zmiennymi COMPUTER_SUPERVISOR_URL oraz SUPERVISOR_TOKEN na hoście, na którym akceptujesz związane z tym ryzyko. Proces mający dostęp do gniazda Docker może uruchomić uprzywilejowany kontener, co w praktyce oznacza posiadanie uprawnień root na hoście. Jest to istotny powód, aby utrzymywać OpenBot na dedykowanej maszynie, zgodnie z zasadą udostępniania agentom programistycznym tymczasowej maszyny wirtualnej.

Dlaczego OPENBOT_SINGLE_USER jest ustawieniem laptopa

.env.example jest dostarczany z OPENBOT_SINGLE_USER=true. To ustawienie akceptuje każde żądanie jako pochodzące od jednego, z góry określonego administratora i całkowicie pomija logowanie. Na laptopie jest to wygodne, ponieważ jedynym klientem, który może połączyć się z tym portem, jesteś Ty. Na VPS oznacza to, że każda osoba, która uzyska dostęp do portu 3010, działa jako ten administrator w systemie przechowującym zaszyfrowane dane uwierzytelniające i uruchamiającym przeglądarkę, w której użytkownik jest już zalogowany do swoich kont.

Serwer obecnie zabezpiecza część tego przypadku. Jeśli ustawiono OPENBOT_SINGLE_USER=true, a wpis OPENBOT_PUBLIC_URL, OPENBOT_APP_URL lub TRUSTED_ORIGINS jest publicznie routowany, serwer odmawia uruchomienia i wskazuje adres. W przypadku prywatnego adresu serwer uruchamia się, wyświetlając ostrzeżenie. To sprawdzenie analizuje adresy URL w konfiguracji, a nie interfejsy, na których Docker publikuje porty. Dlatego domyślne wartości localhost przechodzą sprawdzenie nawet wtedy, gdy port jest dostępny z Internetu. Sposób powiązania usługi z interfejsem pozostaje po stronie administratora.

Istnieją dwa poprawne sposoby uruchomienia tej usługi. Należy zachować OPENBOT_SINGLE_USER=true, powiązać każdy port z 127.0.0.1 oraz uzyskiwać dostęp do aplikacji wyłącznie przez tunel SSH lub prywatny interfejs sieciowy.

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

Aplikacja jest wtedy dostępna pod adresem http://localhost:3010 w używanej przeglądarce. Chrome i Firefox traktują ten adres jako bezpieczny kontekst i zachowują ustawione za jego pośrednictwem ciasteczka logowania Secure. Safari jest wyjątkiem: również zgłasza localhost jako bezpieczny kontekst, ale na dzień 10 listopada 2026 nadal odmawia zapisywania ciasteczka Secure ustawionego przez zwykłe http://localhost. Jest to nadal otwarty błąd WebKit. Tunel należy więc otworzyć w Chrome lub Firefox albo umieścić przed nim TLS. Sam ekran na żywo nie wymaga bezpiecznego kontekstu: dokumentacja wdrożenia wskazuje, że aplikacja nie korzysta z tych interfejsów API przeglądarki, które zwykłe http:// blokuje.

Drugim rozwiązaniem jest wyłączenie trybu jednego użytkownika i skonfigurowanie rzeczywistego dostawcy tożsamości. Obsługiwane są Google, Microsoft Entra, Okta, SAML i OIDC. Google, Entra i Okta konfiguruje się w środowisku, natomiast dostawców SAML i OIDC rejestruje się w sekcji Admin, Identity providers po uruchomieniu wdrożenia. Każdy dostawca wymaga również BETTER_AUTH_SECRET o długości co najmniej 32 znaków, BETTER_AUTH_URL ustawionego na publiczny bazowy adres URL API używany dla wywołań zwrotnych OAuth oraz INITIAL_ADMIN_EMAILS. TRUSTED_ORIGINS nie znajduje się na tej liście wymaganych ustawień, ale zawiera źródła aplikacji akceptowane przez API oraz każdy host z dokumentu wykrywania zarejestrowanego dostawcy OIDC. Domyślnie OPENBOT_APP_URL przyjmuje pierwszą wartość z tej listy, dlatego należy ustawić je na publiczne źródło aplikacji.

Dane uwierzytelniające dostawcy muszą być kompletne, ponieważ częściowo skonfigurowany dostawca zatrzymuje uruchamianie zamiast przełączać aplikację na otwarty dostęp. Jeżeli powodem dodawania kont jest to, że każda osoba w zespole chce mieć własnego agenta, a nie własną przeglądarkę, OneCLI od początku opiera się na takim modelu, z jednym izolowanym agentem dla każdej osoby i kluczami modeli przechowywanymi w jednej bramie.

Jeśli aplikacja jest dostępna pod publiczną nazwą, należy umieścić przed nią TLS (transport layer security). Strona udostępniana przez zwykły protokół http:// pod adresem innym niż localhost nie jest bezpiecznym kontekstem, dlatego pliki cookie oznaczone jako Secure nie są zapisywane, a logowanie kończy się niepowodzeniem, które wygląda jak błąd w OpenBot.

Zabezpieczanie portów niskiego poziomu za pomocą firewalla

Notatka dotycząca bezpieczeństwa OpenBot wskazuje, że punkty końcowe usług niskiego poziomu są chronione tokenami. Należy zachować je jako prywatne i nie używać ich do omijania bramy. Tokeny stanowią drugą linię ochrony. Pierwszą jest całkowity brak możliwości nawiązania połączenia z portem.

Komputer agenta nasłuchuje na porcie 4100 i wymaga COMPUTER_TOKEN. Punkty końcowe bota nasłuchują na portach 4200 i 4201, a środowisko agenta na porcie 4202. Supervisor nasłuchuje na porcie 4500 na hoście oraz 4300 wewnątrz kontenera, a plik compose wiąże go z 127.0.0.1:4500. PostgreSQL nasłuchuje na porcie 5432. Żaden z tych portów nie powinien być dostępny na publicznym interfejsie, a w przypadku wdrożenia dla pojedynczego użytkownika dotyczy to również aplikacji oraz API.

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

Istnieje pułapka, w którą wpadają osoby zakładające, że firewall jest wystarczający. Publikacja portu kontenera za pomocą -p 3001:3001 powoduje, że Docker instaluje regułę DNAT. W rezultacie ruch jest obsługiwany w ścieżce FORWARD i nigdy nie przechodzi przez łańcuch INPUT, który podlega domyślnej polityce odmowy ufw. Port pozostaje otwarty, podczas gdy ufw status nadal wyświetla Status: active. Należy powiązać opublikowany port z interfejsem loopback bezpośrednio w mapowaniu, jako -p 127.0.0.1:3001:3001, lub ustawić adres hosta w pliku compose. Weryfikację należy przeprowadzić za pomocą ss -ltnp, a nie ufw status. Ta pułapka nie jest specyficzna dla OpenBot, dlatego należy przeprowadzić taką samą kontrolę dla każdego innego kontenera opublikowanego na serwerze, w tym dla usługi udostępniającej bibliotekę Jellyfin przebudowaną na wzór wypożyczalni kaset wideo z lat 90.

OpenBot może działać offline z samodzielnie hostowaną usługą Intelligence

Należy ustalić to przed zaplanowaniem wdrożenia. OpenBot korzysta z projektu CopilotKit Intelligence, który przechowuje trwałe wątki i pamięć rozmów w hostowanej usłudze lub we własnej infrastrukturze. Przypięty serwer v0.2.0 podczas uruchamiania sprawdza INTELLIGENCE_API_URL, INTELLIGENCE_GATEWAY_WS_URL i INTELLIGENCE_API_KEY. Weryfikuje je jako zestaw i odmawia uruchomienia, jeśli brakuje któregokolwiek z nich. COPILOTKIT_LICENSE_TOKEN jest opcjonalne i jest używane wyłącznie przez samodzielnie hostowaną usługę Intelligence z własną licencją. Na dzień 10 November 2026 bezpłatna hostowana usługa Intelligence obejmuje 1,000 interakcji miesięcznie na organizację, ale od v0.1.0 OpenBot wyświetla baner dotyczący samodzielnego hostowania, chyba że wdrożenie ma płatny plan Intelligence lub ustawia OPENBOT_SELF_HOST_BANNER=false. Samą usługę Intelligence można hostować samodzielnie, dlatego możliwe jest w pełni lokalne wdrożenie, ale wymaga ono więcej pracy, niż pokazuje quickstart. Produkcyjne wdrożenie offline wymaga planu Annual. W modelu self-hosted pay as you go należy łączyć się z usługą w celu raportowania użycia na potrzeby rozliczeń. Bezpłatna Developer Edition obsługuje lokalną ocenę w środowisku innym niż produkcyjne na podstawie odnawialnej licencji 30-dniowej. Instalacja i odnowienie wymagają dostępu do Internetu. Lokalny interfejs CLI Intelligence zapisuje klucz jako CPK_INTELLIGENCE_API_KEY, natomiast przypięte wydanie v0.2.0 odczytuje wyłącznie INTELLIGENCE_API_KEY, dlatego w przypadku tego wydania należy skopiować wartość. Bieżące main akceptuje klucz CLI bezpośrednio i nadaje mu pierwszeństwo.

Model jest drugą zależnością. Nic nie jest dostarczane w pakiecie. BOT_PROVIDER akceptuje openai, anthropic lub google dla LangGraph Bot, a OPENAI_BASE_URL kieruje ścieżkę OpenAI do dowolnego zgodnego endpointu. W tym miejscu zastosowanie ma uruchomienie Ollama na VPS w celu samodzielnego hostowania LLM, jeśli tokeny mają pozostać na własnym sprzęcie. Sterowanie przeglądarką stawia modelowi wysokie wymagania, dlatego przed podjęciem decyzji należy przetestować model lokalny na rzeczywistym zadaniu.

Skalowanie powyżej jednej repliki

Brama rozwiązuje odwołania do elementów w oparciu o migawkę strony. Migawka ta jest teraz przechowywana w PostgreSQL, dzięki czemu druga replika może operować na migawce wykonanej przez pierwszą. Oficjalny wykres Helm domyślnie uruchamia dwie repliki API i przechowuje w PostgreSQL wszystkie dane niezbędne do przetrwania repliki. Wyłącza on również wbudowany komputer i blokuje możliwość instalacji jednego egzemplarza przy więcej niż jednej replice. Przeglądarka wewnątrz poda API przechowywałaby dane logowania bota, a skalowanie API powieliłoby je. Pojedynczy obraz jest elementem wymagającym uwagi, ponieważ każda replika posiada własną przeglądarkę, więc dane logowania bota pozostają na instancji, która je obsłużyła. Na jednym VPS przeglądarka każdego bota nadal działa na tym samym hoście, więc skalowanie odbywa się poprzez zwiększenie zasobów serwera. Izolacja między botami nadal jest zapewniana przez kontenery przypisane do poszczególnych botów, w taki sam sposób, w jaki piaskownice agentów self-hosted chronią przed skutkami błędów jednego agenta w odniesieniu do pozostałych.

Tryby awarii i obserwowane objawy

Proces startowy kończy się natychmiast po uzupełnieniu .env. Serwer sprawdza konfigurację, zanim zacznie obsługiwać żądania. Każdy z tych problemów zatrzymuje uruchamianie, zamiast powodować ciche ograniczenie funkcjonalności: niepełny blok Intelligence, brak KEY_ENCRYPTION_KEY, dostawca OAuth z identyfikatorem klienta bez sekretu albo tryb jednego użytkownika używany razem z publicznym adresem URL. Odczytaj pierwszy błąd, popraw wskazane pole i uruchom serwer ponownie.

Migracje kończą się błędem w zarządzanej bazie danych. Możliwe są dwie przyczyny. Rozszerzenie vector może nie być włączone, a rola wykonująca migrację nie może go utworzyć. Wtedy migracja napotyka typ kolumny, którego PostgreSQL nie zna. Możliwe też, że rozszerzenie utworzono przy użyciu innej roli i migracja kończy się błędem must be owner of extension vector. Utwórz rozszerzenie przy użyciu roli wykonującej migracje, a następnie ponów etap migracji.

Aplikacja się ładuje, ale logowanie nie zostaje zachowane. Usługa działa przez zwykły http:// pod publicznym adresem, który nie jest bezpiecznym kontekstem, dlatego przeglądarka odrzuca plik cookie Secure. Skonfiguruj TLS przed aplikacją albo użyj tunelu SSH, aby przeglądarka widziała localhost. Przez tunel używaj Chrome lub Firefox, ponieważ Safari nadal odrzuca pliki cookie Secure ustawione przez zwykły http://localhost.

Boty używają wspólnych danych logowania, mimo że powinny być rozdzielone. Supervisor nie jest używany, dlatego nie ma osobnego komputera dla każdego bota i wszystkie boty korzystają ze współdzielonej przeglądarki pod adresem AGENT_COMPUTER_URL. Sprawdź, czy ustawiono COMPUTER_SUPERVISOR_URL oraz czy supervisor może uzyskać dostęp do gniazda Docker.

Bot zatrzymuje się i prosi o pomoc. Tak działa zamierzony mechanizm. Ślad audytowy rejestruje computer.help_requested, użytkownik przejmuje kontrolę na aktywnym ekranie, a przekazanie kontroli jest rejestrowane po obu stronach.

FAQ

Czy pozostawienie OPENBOT_SINGLE_USER włączonego we wdrożeniu VPS jest bezpieczne?

Tylko wtedy, gdy gateway nie jest dostępny z Internetu. OPENBOT_SINGLE_USER=true akceptuje każde żądanie jako pochodzące od jednego, stałego administratora, bez logowania. Każdy, kto może otworzyć port, uzyskuje kontrolę nad wdrożeniem, zapisanymi poświadczeniami i przeglądarką z aktywną sesją. W tym trybie serwer odmawia uruchomienia, gdy skonfigurowany publiczny URL lub zaufane źródło jest publicznie routowane, ale ta kontrola nie wykrywa sposobu publikowania portów. Jest to dopuszczalne, gdy każdy port jest związany z 127.0.0.1, a dostęp do aplikacji odbywa się przez tunel SSH lub prywatny interfejs sieciowy. W przypadku publicznego interfejsu należy wyłączyć tę opcję oraz skonfigurować Google, Microsoft Entra, Okta lub OIDC razem z BETTER_AUTH_SECRET, BETTER_AUTH_URL i INITIAL_ADMIN_EMAILS, a także ustawić TRUSTED_ORIGINS na origin publicznej aplikacji.

Ile pamięci RAM wymaga jeden bot OpenBot?

Opublikowane przez projekt dane dla pojedynczego bota na arm64 wskazują maksymalne zużycie pamięci na poziomie 0.55 GB. Udokumentowane minimum wynosi 2 GB, a zalecana wartość to 4 GB. Nie opublikowano danych dla kilku botów działających jednocześnie, ponieważ każdy z nich uruchamia własny proces Chromium. Uruchom jednego bota podczas rzeczywistego zadania, odczytaj pamięć tego kontenera w docker stats, dodaj zasoby gatewaya i bazy danych, a następnie pomnóż wynik przez oczekiwaną liczbę botów działających jednocześnie.

Czy do samodzielnego hostowania OpenBot potrzebne jest konto CopilotKit?

Tak. OpenBot korzysta z projektu CopilotKit Intelligence do trwałego przechowywania wątków i pamięci, a przypięty serwer v0.2.0 odmawia uruchomienia, jeśli nie zostaną ustawione URL interfejsu Intelligence API, URL WebSocket gatewaya oraz klucz API. Od 10 listopada 2026 dostępny jest bezpłatny plan hostowany. Produkcyjne wdrożenie offline jest obsługiwane z samodzielnie hostowanym Intelligence w planie Annual i modelem lokalnym. Należy również zapewnić własny dostęp do modelu, klucz API modelu albo logowanie u obsługiwanego dostawcy, ponieważ OpenBot nie zawiera żadnego modelu.

Dlaczego każdy bot otrzymuje własną przeglądarkę zamiast współdzielić jedną?

Ponieważ profil przeglądarki jest tożsamością. Współdzielona przeglądarka oznacza współdzielone pliki cookie i sesje. Bot zalogowany na konto powodowałby więc zalogowanie każdego bota na to samo konto. Kontenery przypisane do poszczególnych botów zapewniają każdemu współpracownikowi własny profil i własne logowania, ale tylko wtedy, gdy COMPUTER_SUPERVISOR_URL wskazuje serwer supervisor. Bez tego wszystkie boty współdzielą jedną przeglądarkę. Kosztem jest pamięć, ponieważ osobny proces Chromium dla każdego bota stanowi największą pojedynczą pozycję w szacowaniu zasobów.

Które porty OpenBot powinny być otwarte w zaporze?

Żadne z portów niższych warstw. Agent-computer na porcie 4100, endpointy botów na portach 4200 i 4201, agent harness na porcie 4202, supervisor na porcie 4500 oraz PostgreSQL na porcie 5432 powinny pozostać prywatne. Projekt chroni je tokenami i wymaga, aby pozostawały niedostępne. Należy publikować tylko te porty, które są potrzebne użytkownikowi do otwarcia aplikacji. Trzeba pamiętać, że port kontenera opublikowany za pomocą -p 3001:3001 pozostaje dostępny niezależnie od reguły ufw default-deny, ponieważ reguła DNAT platformy Docker kieruje ten ruch ścieżką FORWARD zamiast INPUT.

Czy ten artykuł był przydatny?