SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor ・更新日 2026-11-12

OpenBot AI coworkerをVPSで自己ホストする方法

OpenBotをVPSで自己ホストし、supervisorでAI coworkerごとに専用コンテナとChromiumを割り当てます。ゲートウェイのpolicy判定と、必要なRAMの見積もりを解説します。

自己ホストする OpenBot AI coworker で得られるもの

自己ホスト型の OpenBot AI coworker では、管理下のハードウェア上で 1 台のゲートウェイサーバーを実行し、各 bot に専用コンテナを割り当てる supervisor を併用します。この bot ごとのコンテナは、COMPUTER_SUPERVISOR_URL が設定されている場合にのみ作成されます。設定されていない場合、すべての bot が AGENT_COMPUTER_URL にある 1 台のコンピューターを共有します。supervisor を配置すると、各 bot のコンテナに専用の Chromium ブラウザーと専用の workspace volume が用意され、セッション間で保持されるブラウザープロファイルも使われます。bot がコンピューター、ファイル、MCP(model context protocol)サーバー、または UI コンポーネントに対して行うすべての操作は、このゲートウェイを経由します。ゲートウェイは操作の実行前にポリシーと照合し、実行後に記録します。ゲートウェイがラップする agent loop の仕組みにまだ慣れていない場合は、AI agent をゼロから学ぶ の段階的な手順に従い、bot にブラウザーやログイン情報を渡す前に、小さな agent loop を自分で作成できます。

OpenBot は CopilotKit が MIT license で公開しており、リポジトリは github.com/CopilotKit/openbot です。最初のタグ付きリリース v0.0.1 は 17 August 2026 に公開され、v0.2.0 は 12 October 2026 に続きました。10 November 2026 時点の最新リリースは v1.0.0 です。これは 9 November 2026 に公開され、v0.3.0 の 3 日後にあたります。また、main の README には beta の注意書きがなくなっています。堅実な設計ですが、初期段階の制約が残っているものとして扱ってください。以下のデプロイでは v0.2.0 を固定しており、手順の各項目はこのリリースを前提にしています。v0.3.0 では approvals、ブラウザー共有、Helm chart のデフォルトが変更されています。そのため、より新しい tag から始める前に v0.3.0 と v1.0.0 の release notes を確認してください。現在の main では、各ユーザーに 1 つのコンテナを割り当て、Isolated が設定された bot に専用コンテナを割り当てます。

このアーキテクチャーで興味深い部分は、同時にコストが大きい部分でもあります。各 agent 用のブラウザーが必要になるため、メモリ消費量の見積もりを忘れがちです。そのため、ここではインストールより先にサイジングを行います。

ゲートウェイが各アクションを判断する仕組み

ポート 3001 の API サーバーが、ボットのコンピューターへの管理対象の経路です。コンピューターは、トークンで保護された低レベルのサービスエンドポイントも公開します。プロジェクトでは、これらを非公開にし、ゲートウェイの迂回に使用しないよう定めています。そのため、これらのエンドポイントに到達できない場合に限り、ゲートウェイが唯一の経路になります。ブラウザー操作を実行する前に、ゲートウェイはページスナップショットから対象を解決し、コンテキストに対して CEL(common expression language)のポリシールールを評価し、その判断を記録した監査行を書き込みます。その後にのみ、コンテナを呼び出します。実行後に失敗した場合は、2 行目を書き込みます。ドキュメントでは境界を明確に示しています。コンピューターはポリシーを判断せず、サーバーゲートウェイがアクションの境界になります。この分離には OpenBot 以外で名前があります。ループ、ツール定義、権限チェック、セッション状態をまとめたものが モデルを包むハーネスであり、このゲートウェイはその権限部分に当たります。

ポリシー評価はフェイルクローズで動作し、deny ルールは allow ルールより先に評価されます。ルールの構文よりも、失敗時の動作が重要です。ポリシーがない場合や空の場合、何も許可されません。ルールが壊れている場合も、deny ルールか allow ルールかにかかわらず、ブロックする方向に失敗します。そのため、ポリシーを誤るとアカウント上で無制限に動作するボットではなく、停止したボットになります。OpenBot に付属するポリシーは別の問題です。起動時のデフォルトは deny: [] で、allow: ["true"] が設定されています。AGENT_COMPUTER_POLICY または保存済みの管理者ポリシーに置き換えられるまで、すべてのアクションが許可されます。そのため、ボットが実環境に触れる前に独自のポリシーを作成してください。この層が制御するのはボットの操作であり、読み取る内容ではありません。そのため、エージェントに向けた指示を含むページは別の問題として残ります。これは、独自の SearXNG インスタンスの結果をエージェントに渡す場合にも発生する、同じプロンプトインジェクションの攻撃面です。

監査証跡は PostgreSQL に保存されるため、再起動後も残ります。制御の引き渡しは computer.help_requested、computer.control_taken、computer.control_released として記録されます。これにより、ボットが人間に確認を求めたことと、人間が制御を返したことを確認できます。Secret は値ではなく文字数として記録されます。ファイルの読み取り、書き込み、一覧表示は Activity タブに表示されます。保存済みファイルはパスとサイズで表示され、内容が表示されることはありません。この表示はブラウザー上で保持されるもので、監査記録そのものではありません。ブラウザーを使わずに同じ制御境界を設けたい場合は、AI エージェントのアクションを承認でゲートするで、この限定的なケースを扱っています。

1 Bot に必要な RAM とディスク容量

このプロジェクトは、arm64 上で 1 Bot を動かした場合の実測値を公開しています。これらはデプロイドキュメントに記載されているサイジング値であり、1 つのアーキテクチャ上で 1 Bot を動かす場合の値です。そのため、キャパシティプランではなく、開始点として扱ってください。

グラフOpenBot published resource figures, one Bot on arm64 (October 2026)
このグラフのデータ
[
  {
    "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
  }
]

1 Bot のピークメモリ使用量は 0.55 GB でした。ドキュメントに記載された最小値は 2 GB、推奨値は 4 GB です。実測値と最小値の差は、負荷時に Chromium が使用するメモリの増加分です。ブラウザーのメモリ使用量は、プロセスが待機中かどうかではなく、開いているページ数に左右されるためです。ドキュメントでは、同時に開くページ 1 枚につき、およそ 100~200 MB が必要とされています。アイドル時の CPU 使用量はほぼゼロで、実測範囲の上限でも 0.06 コアです。そのため、主に必要なのは CPU ではありません。イメージの容量は 1.4 GB で、推奨ボリューム容量は 8 GB です。この差は、Bot がファイルを保存する /workspace のための余裕です。イメージには Chromium 系のブラウザーだけが含まれます。Playwright の Firefox と WebKit は含まれていません。

これらの値だけでは、複数の Bot を同時に動かした場合の必要量は分かりません。そのような数値はプロジェクトから公開されていません。ドキュメントに記載された最小値は、プロジェクトが提示できると判断した値であり、負荷時に誰かが監視して確認した値ではありません。そのため、PhotoPrism と Immich のどちらを選ぶかも、公開値ではなく実測した RAM の下限で判断することになります。実際の環境で測定してください。まず 1 Bot を起動し、ページを開く実際のタスクを実行させ、動作中のコンテナを監視します。

docker stats --no-stream
free -m

Bot のコンテナについては MEM USAGE 列の値を 1 Bot あたりの値として使います。そこに gateway と PostgreSQL の使用量を加え、同時に稼働させる予定の Bot 数を 1 Bot あたりの値に掛けます。アイドル状態の Bot は、アイドルタイムアウトでブラウザーが閉じるまでブラウザーを保持します。デフォルトは 30 分です。そのため、アイドル中のブラウザーも計算に含めてください。この計算方法は、コーディングエージェント用 VPS の RAM と CPU をサイジングする方法と同じです。ブラウザー部分については、VPS 上でエージェント用のヘッドレスブラウザーを実行する方法で説明しています。

小規模なプランでは、Chromium の設定が 1 つ影響します。OpenBot は --disable-dev-shm-usage を指定して Chromium を起動するため、ブラウザーは /dev/shm ではなく /tmp に書き込みます。これにより、/dev/shm が小さいホストで発生するクラッシュを回避できます。一方で、負荷は root ファイルシステムに移ります。そのため、推奨ディスク容量がイメージ容量より大きく設定されています。

VPS で OpenBot をセルフホストするにはどうすればよいですか?

Docker、Bun 1.3 以降、CopilotKit Intelligence のプロジェクトとライセンス、さらにモデルへのアクセスが必要です。モデルへのアクセスには API key を使うか、対応プロバイダーへのサインインをその代わりに使えます。v0.2.0 README はアプリと API server に Bun 1.3+ を要求していますが、現在の main では 1.4+ に引き上げられています。そのため、clone する tag の README を確認してください。プロバイダー独自のサインインで API key を代用できるようになったのは v0.0.15 以降です。開発ドキュメントでは、マシン上に lsof、openssl、curl も必要とされます。また、Intelligence のプロビジョニングには Node 由来の npx も必要です。main ではなく tag 付きのリリースを clone してください。この段階のプロジェクトでは main が予告なく変わるためです。すでに v0.1.x のインストールを使用している場合は、移行前に v0.2.0 のリリースノートを確認してください。アップグレード時には保存済みの Composio 接続が新しいテーブルへコピーされます。その後 v0.1.2 にロールバックすると、アップグレード後に接続したアカウントが表示されなくなります。

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

Intelligence プロジェクトをプロビジョニングします。最初の 2 つのコマンドでサインインし、プロジェクトを選択します。続いてヘルパースクリプトが、そのプロジェクトのランタイムキーをプロビジョニングし、openbot Learning コンテナを作成または再利用して、両方の設定を環境ファイルに書き込みます。

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

保存済みの認証情報を暗号化するキーを生成し、出力を .env に KEY_ENCRYPTION_KEY として設定します。同じファイルに OPENAI_API_KEY も追加します。概念実証用の Bot は OpenAI を使用します。LangGraph Bot では、BOT_PROVIDER に anthropic または google を設定し、対応するキーを追加できます。キーの代わりにモデルのサインインを使う場合、v0.2.0 .env.example は CLAUDE_CODE_OAUTH_TOKEN、claude setup-token のトークン、そしてサインイン済みの ChatGPT プランが書き込むファイルである CHATGPT_AUTH_FILE を受け取ります。API server はこれらを組み込みエージェント用に読み込み、compose は選択した Bot harness に渡します。

openssl rand -base64 32

.env を開いたまま、コンピューターの設定を確認します。.env.example は COMPUTER_SUPERVISOR_URL と SUPERVISOR_TOKEN を空のままにし、AGENT_COMPUTER_URL を port 4100 の共有コンピューター 1 台に指定します。compose file には supervisor が含まれており、scripts/start.sh は COMPUTER_SUPERVISOR_URL と SUPERVISOR_TOKEN を server に渡すことで、Bot ごとのコンピューターをデフォルトで有効にします。server を自分で起動する場合は、両方の値を設定してください。supervisor URL がないと、すべての Bot が同じブラウザーとそのログイン情報を共有します。

続いて起動します。

bash scripts/start.sh

scripts/start.sh は Docker services を起動し、database migrations を実行して、server、定期 worker、app を起動し、それらのヘルスチェックを行います。完了すると、app は port 3010、API は port 3001 で応答します。スクリプトは port の競合を報告し、同じサービスがすでに起動していればそのまま使用するため、2 回実行しても安全です。

外部公開する前に、まず server 自身から確認します。

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 は、app が応答していることを示します。2 つ目のコマンドでは、それらの port がどのアドレスに bind されているかを確認します。VPS では、この結果が重要です。127.0.0.1:3001 と表示される行は、そのマシン内からのみアクセスできます。0.0.0.0:3001 と表示される行は、その server へルーティングできるすべての相手からアクセス可能です。

単一コンテナイメージ

デプロイメントドキュメントには、アプリ、API、Chromium を含み、port 3001 で提供する単一イメージも用意されています。これはバージョンタグ付きの ghcr.io/copilotkit/openbot として公開されているほか、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 はコンテナ内で PostgreSQL を実行し、起動時にマイグレーションを適用します。名前付き volume を使うと redeploy 後も監査履歴が保持されます。これがない場合、再ビルドのたびに履歴が破棄されます。/var/lib/postgresql の親ディレクトリに mount し、data directory 自体には mount しないでください。data directory を mount すると cluster が未初期化のままになり、アプリが 502 を返す場合があるとドキュメントで警告されています。代わりに DATABASE_URL を managed database に向ける場合は、vector 拡張機能をそのデータベースで有効にする必要があります。RDS、Cloud SQL、Azure Database などの managed service はこの拡張機能をサポートしていますが、いずれも自動では有効にしません。マイグレーションでは、実行する role が拡張機能を所有していることも必要です。別の role で拡張機能を作成していると、must be owner of extension vector で停止します。

データベースが外部にある場合は、release step としてマイグレーションを実行します。

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

drizzle-kit migrate ではなく scripts/migrate.ts を使用してください。drizzle-kit CLI は development dependency であり、production image には含まれていないためです。--entrypoint sh は残してください。これがないと、マイグレーションの実行前に API が起動します。

このイメージでは、意図的に browser port を公開していません。また、supervisor も含まれていません。supervisor には Docker socket が必要ですが、serverless platform では利用できないためです。supervisor がない場合、すべての bot が 1 つの browser と 1 組の login 情報を共有します。そのため、bot ごとのコンテナを実行する価値となる分離が失われます。この single-container 構成では、bot ごとに専用のコンテナが割り当てられることはありません。bot ごとに別の login 情報が必要でこのページを参照している場合は、COMPUTER_SUPERVISOR_URL と SUPERVISOR_TOKEN を設定して compose stack を実行してください。ただし、そのトレードオフを受け入れられる host で行う必要があります。Docker socket と通信できるプロセスは特権コンテナを起動できるため、実質的に host 上の root になります。これは、coding agent に使い捨ての VM を割り当てる場合と同じ考え方で、OpenBot 専用のマシンに置くべき理由になります。

OPENBOT_SINGLE_USER が laptop の設定である理由

.env.example には OPENBOT_SINGLE_USER=true が付属しています。この設定では、すべてのリクエストを 1 人の固定管理者からのものとして受け入れ、サインインを完全に省略します。ラップトップでは、ポート 3010 に接続できるクライアントが自分だけなので便利です。VPS では、ポート 3010 に到達できる人が誰でもその管理者になります。そのシステムには暗号化された認証情報が保存され、ユーザーのアカウントにすでにサインイン済みのブラウザーもあります。

サーバーは現在、この一部を検査します。OPENBOT_SINGLE_USER=true が設定されており、OPENBOT_PUBLIC_URL、OPENBOT_APP_URL、または TRUSTED_ORIGINS のエントリが公開ルートに設定されている場合、サーバーは起動を拒否し、該当するアドレスを示します。プライベートアドレスの場合は、警告を出して起動します。この検査が読み取るのは設定内の URL であり、Docker が公開するインターフェースではありません。そのため、ポートがインターネットに公開されていても、localhost のデフォルト値なら検査を通過します。バインドの設定は引き続き利用者が行う必要があります。

実行する方法は、正攻法では 2 つあります。OPENBOT_SINGLE_USER=true を維持し、すべてのポートを 127.0.0.1 にバインドして、SSH トンネルまたはプライベートネットワークインターフェース経由だけでアプリに接続します。

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

その後、アプリには自分のブラウザーで http://localhost:3010 からアクセスできます。Chrome と Firefox はこのアドレスをセキュアコンテキストとして扱い、そこで設定された Secure のサインイン Cookie を保持します。Safari は例外です。Safari も localhost をセキュアコンテキストとして報告しますが、2026 年 11 月 10 日時点でも、通常の http://localhost 経由で設定された Secure Cookie の保存を拒否します。これは未解決の WebKit バグです。そのため、トンネルは Chrome または Firefox で開くか、前段に TLS を配置してください。

ライブ画面自体にセキュアコンテキストは必要ありません。デプロイメントドキュメントによると、このアプリは、通常の http:// で利用できなくなるブラウザー API に依存していません。

もう 1 つの方法は、シングルユーザーモードを無効にして、実際のアイデンティティプロバイダーを設定することです。Google、Microsoft Entra、Okta、SAML、OIDC がサポートされています。Google、Entra、Okta は環境変数で設定します。SAML と OIDC のプロバイダーは、デプロイメントの起動後に Admin、Identity providers で登録します。

どのプロバイダーでも、32 文字以上の BETTER_AUTH_SECRET、OAuth コールバックの送信先となる公開 API ベース URL に設定した BETTER_AUTH_URL、および INITIAL_ADMIN_EMAILS が必要です。TRUSTED_ORIGINS は必須項目ではありません。ただし、API が受け入れるアプリのオリジンに加え、登録済み OIDC プロバイダーの discovery document に含まれるすべてのホストを保持します。また、OPENBOT_APP_URL はデフォルトで最初のエントリになります。そのため、公開アプリのオリジンを設定してください。

プロバイダーの認証情報はすべて設定する必要があります。設定が不完全なプロバイダーがあると、オープンアクセスへフォールバックせず、起動が停止するためです。

アカウントを追加する理由が、チームの各メンバーに自分専用のブラウザーではなく自分専用のエージェントを持たせることなら、OneCLI は最初からその構成を前提に設計されています。各メンバーに 1 つのサンドボックス化されたエージェントを割り当て、モデルのキーを単一のゲートウェイで管理します。

アプリに公開名でアクセスできる場合は、その前段に TLS(Transport Layer Security)を配置します。localhost 以外で平文の http:// により配信されるページはセキュアコンテキストではないため、Secure とマークされた Cookie が保存されず、OpenBot のバグに見える形でサインインに失敗します。

低レベルポートをファイアウォールで保護する

OpenBot のセキュリティに関する注意事項では、低レベルのサービスエンドポイントは token で保護されているものの、非公開に保ち、gateway の迂回には使用しないよう求めています。token は第 2 の防御です。第 1 の防御は、ポート自体に到達できないことです。

agent-computer は 4100 で待ち受け、COMPUTER_TOKEN を要求します。bot のエンドポイントは 4200 と 4201 で待ち受け、agent harness は 4202 で待ち受けます。supervisor は host 上の 4500 と、その container 内の 4300 で待ち受け、compose file では 127.0.0.1:4500 に bind されています。PostgreSQL は 5432 で待ち受けます。これらを public interface に公開してはいけません。single-user deployment では、app と API も同様です。

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

ここには、firewall だけで十分だと思い込む人が陥る落とし穴があります。-p 3001:3001 で container port を公開すると、Docker は DNAT rule を設定します。そのため、traffic は FORWARD path で処理され、ufw の default deny が制御する INPUT chain を通りません。ufw status がなお Status: active を出力していても、ポートは開いたままです。公開ポートの mapping 自体を -p 127.0.0.1:3001:3001 のように loopback に bind するか、compose file で host address を設定してください。ss -ltnp で確認し、ufw status では確認しないでください。この落とし穴は OpenBot 固有のものではありません。そのため、この host で公開しているほかのすべての container に対しても同じ確認を実行してください。90 年代のビデオストアとして再構築した Jellyfin library を提供しているものも含まれます。

OpenBot はセルフホスト型 Intelligence によりオフラインで実行できます

デプロイを計画する前に、この点を確認してください。OpenBot は CopilotKit Intelligence プロジェクトに依存しています。このプロジェクトは、ホストサービスまたは自分のインフラストラクチャ上に永続的なスレッドと会話メモリを保持します。固定された v0.2.0 サーバーは、起動時に INTELLIGENCE_API_URL、INTELLIGENCE_GATEWAY_WS_URL、INTELLIGENCE_API_KEY を検証します。これら3つをセットとして確認し、いずれかが欠けていると起動を拒否します。COPILOTKIT_LICENSE_TOKEN は任意であり、独自のライセンスを持つセルフホスト型 Intelligence のみが使用します。2026年11月10日時点で、無料のホスト型 Intelligence には組織あたり月1,000件のインタラクションが含まれます。ただし、v0.1.0 のため、有料の Intelligence プランを契約しているか OPENBOT_SELF_HOST_BANNER=false を設定していないデプロイでは、OpenBot にセルフホストを促すバナーが表示されます。Intelligence 自体もセルフホストできるため、クイックスタートより多くの作業が必要ですが、完全にローカルなデプロイも可能です。本番環境でのオフラインデプロイには Annual が必要です。セルフホスト型の pay as you go は、請求のために使用量を報告する接続が必要です。無料の Developer Edition は、更新可能な30日間ライセンスによるローカルの非本番評価をサポートします。インストールと更新にはインターネット接続が必要です。ローカルの Intelligence CLI はキーを CPK_INTELLIGENCE_API_KEY として書き込みますが、固定された v0.2.0 リリースは INTELLIGENCE_API_KEY だけを読み取ります。そのため、このリリースでは値をコピーしてください。現在の main は CLI のキーを直接受け付け、それを優先します。

モデルが2つ目の依存関係です。最初からモデルが含まれているわけではありません。BOT_PROVIDER は LangGraph Bot 用に openai、anthropic、google を受け付けます。また、OPENAI_BASE_URL により OpenAI 用の処理先を互換性のある任意のエンドポイントに指定できます。自分のハードウェアにトークンを保持したい場合は、VPS 上で Ollama を実行して LLM をセルフホストする方法が該当します。ブラウザー操作ではモデルに大きな負荷がかかるため、導入を決める前に、実際のタスクでローカルモデルをテストしてください。

レプリカを1つ以上にスケールする

ゲートウェイは、ページのスナップショットに基づいて要素参照を解決します。このスナップショットは現在 PostgreSQL に保存されるため、2つ目のレプリカが1つ目のレプリカで取得したスナップショットに対して処理できます。公式の Helm chart はデフォルトで API レプリカを2つ起動し、レプリカが保持する必要のあるすべてのデータを PostgreSQL に保存します。また、組み込みの computer を無効にし、レプリカが複数ある構成では computer の併設を拒否します。API pod 内の browser は1つの bot のログイン情報を保持するため、API をスケールするとログイン情報も複製されます。注意すべきなのは単一イメージの構成です。各レプリカが独自の browser を持つため、bot のログイン情報は、その bot の処理を担当したインスタンスに残ります。1台の VPS では、各 bot の browser は引き続き同じホスト上で実行されるため、マシンのリソースを増強してスケールします。bot 間の分離は引き続き bot ごとのコンテナによって実現します。これは、self-hosted エージェントのサンドボックスによって、あるエージェントのミスが他のエージェントに影響しないようにするのと同じです。

障害の状況と確認できる内容

.env の入力直後に起動が終了する。 サーバーはサービスを開始する前に設定を検証します。次のいずれかに該当すると、静かに機能を縮退せず起動を停止します。Intelligence ブロックが不完全である、KEY_ENCRYPTION_KEY がない、client ID はあるが secret がない OAuth プロバイダーを設定している、または公開 URL と single-user mode を併用している場合です。最初のエラーを確認し、そのフィールドだけを修正してから、もう一度起動します。

マネージドデータベースでマイグレーションが失敗する。 主な原因は 2 つあります。vector 拡張機能が有効になっておらず、マイグレーションを実行する role に拡張機能を作成する権限がないため、PostgreSQL が認識できない列型でマイグレーションが停止する場合です。もう 1 つは、別の role で拡張機能が作成されており、マイグレーションが must be owner of extension vector で停止する場合です。マイグレーションを実行する role で拡張機能を作成してから、マイグレーション手順を再実行します。

アプリは読み込まれるが、サインイン状態が維持されない。 公開アドレスで平文の http:// を提供しているため、secure context にならず、Secure cookie が破棄されています。前段に TLS を配置するか、ブラウザーから localhost と認識されるように SSH tunnel を使用します。tunnel 経由では Chrome または Firefox を使用してください。Safari は平文の http://localhost 経由で設定された Secure cookie を引き続き破棄するためです。

分離するはずのログインを複数の bot が共有する。 supervisor が使用されていないため、bot ごとのコンピューターがなく、すべての bot が AGENT_COMPUTER_URL の共有ブラウザーを使用しています。COMPUTER_SUPERVISOR_URL が設定されていることと、supervisor が Docker socket に接続できることを確認します。

bot が停止して助けを求める。 これは設計どおりの動作です。監査証跡に computer.help_requested が記録され、ライブ画面で操作を引き継み、引き継ぎが双方に記録されます。

FAQ

OPENBOT_SINGLE_USER を VPS のデプロイで有効にしたままにしても安全ですか?

ゲートウェイにインターネットから到達できない場合に限り安全です。OPENBOT_SINGLE_USER=true はサインインなしで、すべてのリクエストを 1 人の固定管理者として受け入れます。そのため、ポートを開ける人は誰でも、デプロイメント、保存済み認証情報、サインイン済みブラウザーを完全に操作できます。このモードでは、設定された公開 URL または信頼済みオリジンがパブリックにルーティングされている場合、サーバーは起動を拒否します。ただし、このチェックではポートがどのように公開されているかまでは確認できません。すべてのポートを 127.0.0.1 にバインドし、SSH トンネルまたはプライベートネットワークインターフェース経由でアプリにアクセスする場合は使用できます。パブリックインターフェースでは無効にし、Google、Microsoft Entra、Okta または OIDC と BETTER_AUTH_SECRET、BETTER_AUTH_URL、INITIAL_ADMIN_EMAILS を設定してください。また、TRUSTED_ORIGINS には公開アプリのオリジンを設定します。

OpenBot の bot 1 台にはどの程度の RAM が必要ですか?

プロジェクトが公開している 1 台の Bot に関する arm64 の数値では、ピーク時のメモリ使用量は 0.55 GB です。文書化された最小値は 2 GB、推奨値は 4 GB です。複数の bot を同時に実行した場合の公開値はありません。各 bot が専用の Chromium を保持するためです。実際のタスクで bot 1 台を実行し、そのコンテナのメモリ使用量を docker stats で確認します。ゲートウェイとデータベースの使用量を加え、同時に実行する予定の bot 数を掛けてください。

OpenBot をセルフホストするには CopilotKit のアカウントが必要ですか?

はい。OpenBot は、永続的なスレッドとメモリに CopilotKit Intelligence プロジェクトを使用します。また、固定された v0.2.0 サーバーは、Intelligence API URL、ゲートウェイの WebSocket URL、API key がすべて設定されていないと起動を拒否します。2026 年 11 月 10 日時点では、無料のホスト型プランを利用できます。Annual とローカルモデルによるセルフホスト Intelligence を使用したオフラインの本番デプロイにも対応しています。OpenBot にはモデルが同梱されていないため、代わりに独自のモデルアクセス、model API key、または対応プロバイダーのサインインも用意する必要があります。

bot ごとにブラウザーが割り当てられ、共有されないのはなぜですか?

ブラウザープロファイルは ID だからです。ブラウザーを共有すると Cookie とセッションも共有されます。そのため、1 台の bot がアカウントにサインインすると、すべての bot がそのアカウントにサインインした状態になります。bot ごとのコンテナを使用すると、各 coworker に専用のプロファイルとログイン情報を割り当てられます。ただし、COMPUTER_SUPERVISOR_URL がサーバーを supervisor に接続している場合に限ります。これがなければ、すべての bot が 1 つのブラウザーを共有します。代償はメモリです。bot ごとに Chromium を実行することが、サイジング上で最も大きな項目だからです。

OpenBot のどのポートをファイアウォールで開けるべきですか?

低レベルのポートは、どれも開ける必要がありません。4100 の agent-computer、4200 と 4201 の bot endpoint、4202 の agent harness、4500 の supervisor、5432 の PostgreSQL はすべてプライベートに保ちます。プロジェクトはこれらを token で保護していますが、いずれにしても到達不能にしておくよう求めています。人が開く必要のあるものだけを公開してください。-p 3001:3001 を使用してコンテナポートを公開すると、ufw の default-deny ルールに関係なく到達可能になる点にも注意してください。Docker の DNAT ルールにより、そのトラフィックは INPUT ではなく FORWARD の経路に入るためです。

この記事は役に立ちましたか?