CopilotKit OpenBot は、AIエージェントに専用のブラウザとファイル領域を与え、その全操作を判定して記録するMITライセンスの基盤だ。エージェントに実務を任せるときに引っかかるのは性能より「何をさせたのか後から説明できるか」である。ブラウザを触らせれば社内SaaSにログインし、フォームを送信し、ファイルを書く。証拠はスクリーンショットしか残らず、権限は担当者のアカウントに紐づいたままになる。OpenBotはこの問題を設計の中心に置き、エージェントの操作をすべて単一のゲートウェイに通す。2026-08-17の公開時に424★だったリポジトリは、2026-10-30時点で約8.1k★・1.0k forkに増えた。
エージェント基盤そのものの選び方は AIエージェントフレームワーク比較2026|LangGraph・CrewAI・Dify等9種をStar数・実コードで検証 を参照してほしい。
本記事は公式README・docs/・ソースコードを一次資料に、現行main(commit ab9855c)の設定読み込み関数とポリシー評価関数を実際に動かして書いた。2026年8月の測定から前提が変わった点は、後半の図で一覧にしている。起動・Docker・画面操作までは通していない(未検証)。
30秒でわかるOpenBot
・何ができる:AG-UI準拠のエージェントが、専用のブラウザ・フォルダ・ログインを持つ「コワーカー」として動く。人は画面を見て、必要なら操作を代われる
・何を解決する:エージェントの行動の証跡が残らない問題と、権限が個人アカウントに癒着する問題。操作は対象解決 → 判定 → 監査行 → 実行の順で通る
・何を代替する:エージェントとヘッドレスブラウザと場当たりのログを組み合わせた自作構成
・注意:MITだがIntelligence接続が必須。既定ポリシーは全許可。READMEの自称はbetaで「テンプレートであり製品ではない」
CopilotKit OpenBotとは|openbotで検索して出る同名プロジェクトとの見分け方
WHAT IT REPLACES何を代替するか
場当たりの自作構成を判定と記録つきの基盤に置き換える
自前の構成
エージェント + ヘッドレスブラウザ + ログ
- 権限は担当者のアカウントに癒着
- 動いた証拠はスクリーンショット頼み
- 止めたい操作はコードに直書き
OpenBot
AG-UI準拠のコワーカー基盤
- 専用ブラウザとフォルダを分離
- 全操作を判定し、実行前に記録
- ルールは管理画面とCELで書く
OpenBotはCopilotKitが公開したエージェントプラットフォームで、READMEは「自分のインフラの中で動く」ものと説明する。Docker Composeが構成要素を立ち上げ、データは自分のPostgreSQLに入り、モデルは自分で選ぶ。モデルは同梱されず、管理者が供給した資格情報は保存時に暗号化される。
「openbot」単体の検索は別物に当たりやすい。GitHubの同名リポジトリは次のとおりで(★は2026-08-20取得)、本記事の対象は組織名つきの CopilotKit/openbot だけだ。
| リポジトリ | 中身 | ★(2026-08-20) |
|---|---|---|
| ob-f/OpenBot | スマートフォンを頭脳にする低価格ロボット。無関係 | 3,382 |
| CopilotKit/openbot | 本記事。AG-UIエージェント基盤 | 424(現在は約8.1k) |
| meetopenbot/openbot | 別のAIエージェント製品(OS for Agentsを掲げる) | 317 |
| openbotx/openbotx | AIエージェント統合プラットフォーム | 88 |
中心の単位は「コワーカー」だ。examples/fintech/agents.yaml では、General AssistantとKnowledgeがシステムプロンプトだけを持つ type: built-in、Risk Analystが外部エンドポイントを指す type: remote-ag-ui として定義されている。同梱のBotも自作のBotも同じ登録経路を通る。
Botの正体は AG-UIプロトコル(エージェントとUIのやり取りを定めたオープンプロトコル)を話すエンドポイントでしかない。READMEの言葉では「統治はフレームワークではなくプロトコルに乗る」ので、LangGraphでもMastraでも手書きでも、同じ入口から入って同じ判定と監査を受ける。既存のReactアプリにコパイロットを組み込む用途は CopilotKit完全ガイド|React/Angularで作るAIエージェント & AG-UI Protocol解説 が対象で、OpenBotは作業環境ごと与える独立した製品だ。
専用ブラウザの分離単位は「1人に1コンテナ」に変わった
2026年8月時点ではBot1体につきコンテナ1つだったが、現行mainのREADMEは「A computer per person」と書く。supervisorが人ごとにコンテナを作り、その人が使うBotごとにフォルダとブラウザプロファイルを分ける。Botに Isolated を付けるとそのBotだけ専用コンテナになる。ホストが対応していれば COMPUTER_RUNTIME=runsc でgVisor下に置ける。コンピュータは既定で 127.0.0.1 にバインドされ、コンテナごとのトークンを要求する。COMPUTER_SUPERVISOR_URL が無ければ、全Botが AGENT_COMPUTER_URL の共有コンピュータを使う。
主なサービスは次のとおり(README・docker-compose.yml)。
| サービス | ポート | 役割 |
|---|---|---|
app |
3010 | React/Vite製のUI |
server |
3001 | Hono製API。認証・ポリシー・監査・プラグインを担う |
agent-computer |
4100 | Chromiumと /workspace、ブラウザプロファイル |
supervisor |
4500(ホスト)/ 4300(コンテナ) | 人ごと・Isolated Botごとのコンピュータを作成・管理 |
画面は /channel/:id(会話しながらBotの画面を見る)、/admin/boundaries(操作ポリシー)、/admin/audit(許可・拒否・失敗の履歴)、/admin/computers(停止・リセット)に分かれる。
CopilotKit OpenBotの使い方と起動条件|CopilotKit Intelligence接続が要る理由
READMEのクイックスタートは、設定ファイルの作成、Intelligenceプロジェクトの接続、モデルキーの設定、起動の順だ。現行mainではライセンストークンの取得コマンドが消え、プロジェクト選択のあとに学習用コンテナを用意するヘルパー bun scripts/setup-learning.ts を実行する。
cp .env.example .env
bun install
npx --yes copilotkit@latest login
npx --yes copilotkit@latest project select
bun scripts/setup-learning.ts
openssl rand -base64 32 # KEY_ENCRYPTION_KEY を作り直す(手元だけなら既定値でも起動する)
bash scripts/start.sh
最後に OPENAI_API_KEY を .env に入れて http://localhost:3010 を開く。必要なのはDocker、Bun 1.4以降(READMEは1.3では一部のテストが落ちると明記)、Intelligenceプロジェクトとモデルキーだ。上のコマンド列は掲載どおりの通し実行はしていない。
APIサーバーがどこで止まるかは loadConfig()(server/src/config.ts)が決める。現行mainで環境変数を空から1つずつ足して呼んだ結果は次のとおりだった(Bun 1.4.4)。
・KEY_ENCRYPTION_KEY が無い → KEY_ENCRYPTION_KEY must be configured
・認証設定が無い → 起動拒否。OPENBOT_SINGLE_USER=true(旧名 OPENBOT_DEV_NO_AUTH も有効)を明示した場合だけ、管理者1人・サインインなしで動く
・Intelligenceの INTELLIGENCE_API_URL・INTELLIGENCE_GATEWAY_WS_URL・CPK_INTELLIGENCE_API_KEY が欠ける → 欠けた名前を列挙して起動拒否
・3つを埋める → mode: "intelligence"・durableHistory: true で通る
8月は4点(ライセンストークン込み)が必須だったが、ソースのコメントは「プラットフォームが配らなくなったトークンを探させていた」として必須から外した理由を説明している。トークンは任意の値として読まれ、自前ホストのIntelligenceで要るときだけ転送される。
mode の型は "intelligence" の1つだけで、縮退モードは無い。スレッドの置き場所は server/src/channels/thread-identity.ts の冒頭コメントが「Threads live in an Intelligence project」と明言する。READMEは同時に、Intelligenceは自前ホストでき、無料のDeveloperプランでMac上のDockerにローカル構成を立てられるとも書く。よって「MIT・自ホスト」と「Intelligence必須」は両立している。会話データの置き場所が要件なら、マネージド版を使うか自前ホストのIntelligenceを用意するかを最初に決める必要がある。
OpenBotの監査ゲートウェイ|決めて、記録して、それから動くAIエージェント
server/src/computer/gateway.ts の冒頭コメントは、記録を「行動と並行して書かれるレポート」ではなく行動が通る経路として説明する。先に行を書かずに動く経路が無いので、記録されなかった行動は起きていない。
GATEWAY ORDERゲートウェイの順序
操作は決めて、記録して、それから動く
-
対象を解決
サーバー保持のスナップショットから
-
ポリシー判定
denyが先・壊れたルールは拒否
-
監査行を書く
実行より前に PostgreSQL へ
-
実行 or 拒否
拒否はルール名つきで返す
順序の要点は3つある。
対象の解決が先。ゲートウェイは呼び出し側が主張したラベルでなく、サーバーが取得したスナップショットから要素を解決する。コメントは、ラベルで判定すると {ref: "e13", name: "Continue"} と送るだけで「Submitを押させない」ルールを回避できるため、refを不透明にしてサーバーが対応表を持つと説明する。
監査行は成功の後でなく実行の前。許可されたが後で失敗した操作も、判定の行とは別に失敗の行が追記される。
反復は判定前に数える。同じ呼び出しの連続回数は repeat.count としてルールから参照できる。時間窓ベースで、カウントは処理したプロセスが持つため、APIを複数台にすると分裂する。入力内容が違っても同じ対象への操作は同じ呼び出しとして数える点も、ソースが自ら制約として挙げている。
読み取りは素通りする
- ・ゲートウェイが統治するのは行動で、観測ではない。スナップショット取得はソースコメントのとおり「読み取り専用なので素通り」し、ポリシー判定も監査行も付かない。見せてよい情報かどうかは、知識コネクタの権限やコンピュータのネットワーク到達性で制御する。
人が操作を代わる「Take the wheel」も記録される(computer.help_requested・computer.control_taken・computer.control_released)。人が運転している間、Botの操作は拒否される。
既定ポリシーは全許可|CELで書けるルール・書けないルール
READMEの「CEL policy, fail closed」は正しいが、エンジンの性質と出荷時の既定値は別の決定だ。エンジン(policy.ts)はdenyをallowより先に評価し、ポリシーが無ければ許可せず、壊れたルールは拒否に倒す。一方、既定値(policy-store.ts の DEFAULT_ACTION_POLICY)は現行mainでも次のとおりで、実測でも deny: [] に対して許可が返った。
{ "mode": "enforce", "deny": [], "allow": ["true"] }
箱から出した状態は「すべてを記録するが、何も止めない」。統治を効かせるには管理者が最初の1本を書く。mode: "dry-run" なら判定と記録だけして全部通すので、実トラフィックでルールの影響を確かめてから enforce に切り替えられる。
ルールで文字列を扱えるかは、判定関数 evaluateActionPolicy() に偽になるはずの式を渡して測った。式が例外になるとfail-closedで拒否に倒れるため、偽の式に拒否が返れば未対応と読める。
| 式 | 2026-08-20(旧commit) | 2026-10-30(現行main) |
|---|---|---|
has() |
動く | 動く(再測定は has() のみ) |
contains(element.name, "zzz")(関数形式) |
例外 | 動く(偽で許可、"SUBMIT" の部分一致は拒否) |
matches(element.name, "zzz")(関数形式) |
例外 | 動く(正規表現。偽で許可、一致で拒否) |
element.name.contains(...) / .matches(...)(メソッド形式) |
例外 | 例外(cel-js 0.8.2にメソッドが無い) |
startsWith / endsWith |
例外 | 例外(登録されていない) |
つまり現行mainでは、READMEがCELを選んだ理由である「外部サイトでSubmitと書かれたものは押させない」を部分一致で書ける。関数は大文字小文字を区別しないので「SUBMIT」ボタンも拾う。ただし .contains() の書き方に慣れた人はメソッド形式で書いて全操作拒否を踏む。
WHAT CHANGED8月から変わった点
8月の前提は現行mainで5点ずれた
2026-08-20の実測
2026-10-30のmain
2026-08-20の実測: 公式の自称は alpha
2026-10-30のmain: README のバッジは beta
2026-08-20の実測: 認証なしは OPENBOT_DEV_NO_AUTH
2026-10-30のmain: OPENBOT_SINGLE_USER(旧名も有効)
2026-08-20の実測: Intelligence の必須設定は4点
2026-10-30のmain: 3点(ライセンストークンは任意)
2026-08-20の実測: contains / matches は例外
2026-10-30のmain: 関数形式なら動く(大文字小文字を区別しない)
2026-08-20の実測: Bot 1体に1コンテナ
2026-10-30のmain: 1人に1コンテナ(Isolated で1Bot1台)
もう1つの罠は element が省略可能なことだ。ページ遷移のように要素を伴わない操作では element.name を参照すると例外になり、denyの例外は拒否に倒れる。実測(現行main)では、element.name == "Submit" && page.host != "example.co.jp" だけだと browser_navigate が拒否され、has(element.name) && を前置すると許可された。.env.example の例は、さらに Enter キーでの送信も塞ぐ形になっている(computer_key・computer_type と key == "Enter")。クリックだけ禁じても、Enterで送信される経路が残るためだ。
export AGENT_COMPUTER_POLICY='{
"mode": "dry-run",
"deny": ["has(element.name) && contains(element.name, \"submit\") && page.host != \"example.co.jp\""],
"allow": ["true"]
}'
このコマンドの式は、evaluateActionPolicy() に同形の式を渡して許可・拒否を確かめた。環境変数を設定したサーバーへの反映は未検証だ。
MCPの扱いも同じ思想で、ツールが読み取りと分類されるのは「サーバー自身が広告しており、書き込みリストに載っていない」場合だけ。分類できないものは書き込み扱いになる。カスタムMCPサーバーのURLはHTTPSのみで、IPリテラルとlocalhostは拒否される。資格情報の預け方は OpenSandbox解説|AIエージェント用サンドボックスに資格情報の金庫を持たせる設計 と論点が重なる。
エージェント サンドボックス系ツールとの比較と導入前の確認点
| CopilotKit/openbot | AgentENV | OpenSandbox | |
|---|---|---|---|
| 主目的 | 業務コワーカーの運用と統治 | 大量環境の高速な複製 | 資格情報を預けた実行環境 |
| 分離単位 | 人ごと・Isolated Botごとのコンテナ(gVisor可) | Firecracker microVM | サンドボックス |
| 監査 | 実行前に必須で記録 | 本記事では未確認 | 資格情報の取り扱い中心 |
| ポリシー言語 | CEL(deny優先・fail-closed) | — | — |
| エージェントの持ち込み | AG-UIエンドポイントなら何でも | E2B互換API | — |
| ライセンス | MIT | MIT | Apache-2.0 |
大量の環境を安く並列に維持したいなら AgentENV解説|Firecracker microVMをforkして並列実行するE2B互換のエージェント基盤 の方向だ。OpenBotが解くのは別の問題で、少数のエージェントに継続的な役割を与え、行動を後から説明できるようにすることである。
導入前に確認する点は次のとおり。
・成熟度:READMEは「A template, not a product」かつbeta。ホスト版は無く、examples/ のテナントを自分のコワーカーに差し替えて使う前提
・認証:OPENBOT_SINGLE_USER=true は管理者1人として全リクエストを通す手元用。他の人が到達する環境ではGoogle・Microsoft・Oktaのいずれかのサインイン設定が要る
・監査の範囲:AIエージェント監査の対象は書き込み系の行動が対象で、読み取りは含まれない
・暗号鍵:.env.example の KEY_ENCRYPTION_KEY は公開値。ソースのコメントは、変えないデプロイは公開鍵で資格情報を暗号化しており、検査では見分けがつかないと警告する
・既定の全許可:最初の禁止ルールを書くまで、統治は記録だけを意味する
・読み取りは監査されない:スナップショット取得は判定も記録も通らない
・アップグレード:CHANGELOGは未タグ版で既存デプロイに影響する変更16件を列挙し、Botごとのコンテナを人ごとに切り替える移行を含む。READMEは追従前の確認を求めている
評価するなら、ローカルで /bot を開いて簡単なブラウズを頼み、/admin/audit に何が残るかを見る。次に /admin/boundaries で拒否ルールを1本足し、同じ操作で拒否の記録とルール名が出るかを確かめる。この2往復で製品の売りは掴める。「監査行を書いてから動く」「モデルが名乗ったラベルで判定しない」「分類できないMCPツールは書き込み扱い」といった判断は、自前でエージェント基盤を組む場合にも持ち帰れる。
参照ソース
・CopilotKit/openbot — GitHubリポジトリ(README・CHANGELOG・server/src/config.ts・computer/gateway.ts・computer/policy.ts・computer/policy-store.ts・channels/thread-identity.ts・auth/dev-actor.ts・.env.example。commit ab9855c を2026-10-30に取得。旧版の測定は commit 93ff1b19・2026-08-20)
・OpenBot 製品ページ — copilotkit.ai/openbot
・AG-UI Protocol — ag-ui-protocol/ag-ui





