← ブログ一覧
AI8分

Agent Canvasとは?OpenHandsが提供する、Claude CodeやCodexも切り替えて使える自己ホスト型AIエージェント管理画面を実際に動かしてみた

  • #Agent Canvas
  • #OpenHands
  • #Claude Code

ターミナルコーディングエージェントが増えるほど、「このエージェントはどのプロジェクトで動かしていたか」「どのモデルでどんな指示を出したか」を一元的に把握する画面が欲しくなります。OpenHandsが公開している「Agent Canvas」は、まさにその役割を担うセルフホスト型のWebアプリで、公式READMEでは「The self-hosted developer control center for coding agents and automations.」と説明されています。OpenHands自身のオープンソースエージェントだけでなく、Claude CodeやCodex、Gemini CLIなど複数のエージェントを1つの画面から切り替えて使える設計です。

この記事は、Agent Canvasのソースコードを含む公式リポジトリ(OpenHands/OpenHands)のREADME、npmに公開されているパッケージ@openhands/agent-canvas自体のpackage.json、そして実際にこのクラウド環境へインストールして得たCLIの出力を一次情報としています。Agent Canvasは以前「OpenHands CLI」という別プロジェクト(OpenHands/OpenHands-CLI)として存在していましたが、そのREADME冒頭には「このプロジェクトは現在積極的にはメンテナンスされていない」こと、代わりにAgent Canvasを使うことが明記されています。本文中「実際の出力」と明記した部分のみが、このクラウド環境で得た結果です。なお、サーバー本体をフォアグラウンドで起動し続ける操作は、このクラウド環境の実行ポリシー上今回は行えなかったため、UI画面やエージェントとの実際のやり取りそのものは確認できていません(詳細は後述)。

Agent Canvasとは:複数のコーディングエージェントを切り替えて使う管理画面

公式READMEによると、Agent Canvasはローカルマシン上で動かすのが基本ですが、Dockerコンテナや社内のVM、OpenHands CloudやOpenHands Enterpriseのインフラといった複数の「エージェントバックエンド」に接続して、画面上で切り替えながら使うことを想定しています。標準で動くのはオープンソースのOpenHandsエージェントですが、README上にはClaude Code・Codex・Gemini CLI・Pi・OpenCode、そしてACP(Agent Client Protocol)に対応したエージェントも利用できると記載されています。会話の開始だけでなく、スケジュール実行やWebhookイベントをきっかけに動く「自動化(automation)」の作成、SlackやGitHub・Linear・Notionといった外部サービスとの連携もREADME上の機能として挙げられています。

構成:Agent Server・Automation Server・3つのリポジトリ

READMEによると、Agent Canvas自体はOpenHands/OpenHandsリポジトリにあるフロントエンドとバックエンド選択の管理部分で、実際にエージェントを動かす基盤は別リポジトリのOpenHands/software-agent-sdkにある「Agent Server」というREST APIが担っています。1つのAgent Serverは1台のマシン・1つのホスト/ポートで動作し、Agent Canvasは複数のAgent Serverに接続先を切り替えられる、という役割分担です。スケジュールやWebhookをトリガーに動かす「Automation Server」はOpenHands/automationリポジトリが担当し、ブラウザ向けのAPIクライアントはOpenHands/typescript-clientに分かれています。「いつ実行するか」をAutomation Serverが決め、「何を実行するか」をAgent Server/SDKが決める、という切り分けがREADMEに説明されています。

インストールして動かしてみた:npm installからCLIの出力まで

README記載のインストール方法のうち、最も手軽な「サンドボックスなし」の方法を実際に試しました。前提としてNode.js 24以上とuvが必要と書かれていますが、このクラウド環境に入っていたNode.jsはv22.23.5で、Node 24系ではありませんでした。

npm install @openhands/agent-canvas

を実行すると、このバージョンのNode.jsでもインストール自体は問題なく完了し、620個の依存パッケージが約48秒で入りました(実際の出力)。パッケージ自身のpackage.jsonを確認すると、engines.nodeには">=22.12.0"と書かれており、READMEの「Node 24以上」という記載よりも緩い条件になっていました。ライセンスも同じpackage.jsonからMITであることを確認できました。続けてagent-canvas --versionとagent-canvas --infoを実行すると、次のように表示されました(実際の出力)。

1.16.0

@openhands/agent-canvas 1.16.0

Default stack versions:
  agent-server:    1.44.0
  automation:      1.9.0

Compatibility:
  agent-server:    >= 1.28.0

Default ports:
  ingress:         8000
  agent-server:    18000
  automation:      18001

興味深いのは、npmのレジストリ情報(npm view @openhands/agent-canvas)ではdist-tagのlatestが1.43.0と表示されていたのに対し、このクラウド環境で実際にインストールされたのは1.16.0だった点です(実際の出力)。原因はこの記事の範囲では特定できていないため、実際に導入する際はインストール直後に--versionで確認したほうが安全です。

起動方法の選択肢:npm・単一Dockerコンテナ・会話ごとのDocker・ソースから

README上では、起動方法として大きく4つが案内されています。

  • 「サンドボックスなし(npm)」:npm install -g @openhands/agent-canvasのあとagent-canvasを実行する方法。READMEはこの方式について、エージェントがマシンのファイルシステム全体にアクセスできる点に注意が必要だと明記しています
  • 「単一のDockerサンドボックス」:ghcr.io/openhands/agent-canvasイメージをdocker runで起動し、ホスト側のPROJECTS_PATHを/projectsとしてマウントする方法。アクセス先はhttp://localhost:8000/canvasになるとREADMEに記載されています
  • 「会話ごとに別のDockerサンドボックス」:OH_CONVERSATION_RUNTIME=dockerを指定してagent-canvasを起動すると、新しい会話がそれぞれ専用のコンテナで実行される方式。既存のローカル会話は自動では変換されないとの注意書きがあります
  • 「ソースから」:OpenHands/OpenHandsリポジトリをgit cloneし、npm ci・npm run devで起動する方法。READMEにはリポジトリ指定のnpmバージョン(11.12.1)を使う必要があるとの記載もあります

このほか、CLIの--helpを実際に実行したところ、-p/--port(既定8000)、--public(公開モード。LOCAL_BACKEND_API_KEY環境変数が必須)、--frontend-only、--backend-onlyといったオプションが確認できました(実際の出力)。デフォルトではAPIキーが自動生成されてフロントエンドに注入されるため、ログイン操作なしでアクセスできる一方、--host 0.0.0.0のように全インターフェースで待ち受ける設定にすると自動注入が働かず、APIキーを手入力する必要がある、という挙動もREADMEに記載されています。

この記事で確認できなかったこと

今回はインストールとCLIのヘルプ・バージョン表示までを確認しましたが、agent-canvasコマンドでサーバー本体をフォアグラウンドで起動し続ける操作は、このクラウド環境の実行ポリシー上、今回は行えませんでした。そのため、ブラウザ上の実際の画面、OpenHandsエージェントやClaude Code・Codexへの接続、Docker経由でのサンドボックス起動、SlackやGitHubとの自動化連携は、この記事では一切検証していません。また、npmのdist-tagとこの環境での実際のインストール結果がずれていた理由(1.43.0と1.16.0)についても、この記事の範囲では特定できていません。本格的に導入する場合は、公式リポジトリの最新READMEと、インストール直後の--version出力をあわせて確認することをおすすめします。

向いている場面・まだ注意が必要な場面

  • 向いている:Claude CodeやCodexなど複数のエージェントCLIを併用していて、会話やバックエンドの切り替えを1つの画面にまとめたい場合。READMEには、チーム共有のエージェントサーバーと個人のノートPC上のエージェントを使い分ける構成も想定されています
  • まだ注意が必要:「サンドボックスなし」のnpm起動はエージェントにマシンのファイルシステム全体へのアクセスを許すとREADME自身が注意しており、個人の作業用マシン以外で安易に動かす設計ではありません。前身のOpenHands CLIが既にメンテナンス終了を迎えている経緯もあるため、Agent Canvas側も将来構成が変わる可能性を踏まえて公式リポジトリの更新を追ったほうが安全です

まとめ

Agent Canvasは、OpenHandsが提供する、OpenHands・Claude Code・Codex・Gemini CLI・Pi・OpenCodeなど複数のコーディングエージェントを1つの画面から切り替えて使えるセルフホスト型の管理ツールです。このクラウド環境ではnpm installによるインストールと、--version・--info・--helpによるCLIの基本動作までを実際に確認できました。一方でサーバー本体の起動そのものは今回検証できていないため、実際の画面やエージェントとの連携を確かめるには、公式リポジトリ(OpenHands/OpenHands)のREADMEに沿って、Dockerまたはnpmでの起動を自分の環境で試す必要があります。

参考にした一次情報

まずは、やりたいことを聞かせてください

「何から手をつければいいか分からない」段階でも大丈夫です。 ご相談・お見積りは無料。碧南近郊なら直接伺います。