AI ManusのDockerサンドボックス型エージェントを読む

エージェント、サンドボックス、Claw統合

リポジトリのREADMEは、AI Manusをサンドボックス環境内でツールと操作を実行する汎用AIエージェントシステムとして説明しています。現在のバージョンには、OpenClawアシスタントの統合であるClawが追加されており、READMEによると、ワンクリックデプロイ、ユーザーごとの分離コンテナ、チャット履歴をManusエコシステムにもたらします。READMEにはデモサイト、WebUIとサンドボックスでManusを再構築するブログ記事、QQグループへのリンクがありますが、これらの実装の詳細は提供されていません。リポジトリメタデータは主要言語をPythonとしています。

ネイティブツール呼び出しを備えた計画実行ループ

エージェントループは、構成可能なシステムプロンプトとネイティブの構造化出力ツールを備えた計画実行フローとして説明されています。READMEは、JSONプロンプトプロトコルがないことを明示しています。計画とステップ結果は、create_planやcomplete_stepなどの構造化出力ツールを通じて送信されます。サポートされているツールには、ターミナル、ブラウザ、ファイル、ウェブ検索、メッセージングツールが含まれ、リアルタイム表示と引き継ぎ機能、外部MCPツール統合を備えています。READMEは、信頼性の高いツール呼び出しを持つDeepseekとGPTモデルを推奨し、LangChainチャットモデルプロバイダーがサポートされ、デフォルトはopenaiであると述べています。

タスクごとのDockerサンドボックスとセッション永続化

各タスクには、ローカルDocker環境で実行される個別のサンドボックスが割り当てられます。設計セクションでは、フローを説明しています。Webフロントエンドがサーバーにエージェントの作成を要求し、サーバーは/var/run/docker.sockを介してサンドボックスを作成し、セッションIDを返します。サンドボックスはUbuntu Docker環境で、Chromeとファイルやシェルなどのツール用のAPIサービスを起動します。サーバーはユーザーメッセージをPlanActエージェントに転送し、エージェントはステップを計画して実行し、必要に応じてサンドボックスツールを呼び出します。すべてのイベントはWebSocketを介してWebクライアントに送り返されます。ブラウザ表示の場合、サンドボックスはVNCサービスを備えたヘッドレスブラウザを実行し、WebクライアントはNoVNCを介して接続します。セッション履歴はMongoDBとRedisで管理され、バックグラウンドタスクをサポートします。

Docker Composeによる最小限のデプロイ

READMEは、最小限のデプロイにはLLMサービスだけでよく、他の外部サービスへの依存はないと述べています。推奨されるデプロイ方法はDocker Composeです。提供されているdocker-compose.ymlは、frontend、backend、sandbox、claw、mongodb、redisのサービスを定義し、simpleyyt/manus-frontendやsimpleyyt/manus-backendなどのイメージを使用します。設定は.envファイルから読み込まれます。最低限、API_KEY、API_BASE、MODEL_NAMEを設定します。READMEでは、docker compose up -dを実行し、サンドボックスコンテナがコード0で終了するのは正常であると説明しています。Webインターフェースはその後、http://localhost:5173で利用できます。その他の設定オプションはプロジェクトのドキュメントサイトに記載されています。

5つのサブプロジェクトによる開発セットアップ

リポジトリは、frontend、backend、sandbox、claw、mockserverのサブプロジェクトに分かれています。開発ガイドでは、リポジトリをクローンし、.env.exampleを.envにコピーし、少なくともAPI_KEYを設定することを推奨しています。dev.shスクリプトは、リロードを有効にしてデバッグモードでスタックを実行します。READMEには公開ポートがリストされており、Webフロントエンド用の5173、サーバーAPI用の8000、debugpy用の5678、サンドボックスAPI用の8080、VNC用の5902、Claw用の18788、MongoDB用の27017が含まれます。デバッグモードでは、グローバルに1つのサンドボックスのみが起動されます。依存関係が変更された場合、READMEはdev.sh down -v、dev.sh build、dev.sh upでクリーンアップと再ビルドを推奨しています。イメージ公開は、IMAGE_REGISTRYとIMAGE_TAG環境変数を使用して、run.sh buildとrun.sh pushで行われます。

ロードマップとライセンス

開発ロードマップには、Deploy & Exposeツール、モバイルおよびWindowsコンピュータ向けのサンドボックスアクセス、K8sおよびDocker Swarmのマルチクラスタデプロイサポートの計画がリストされています。READMEは、完全なチェックリストについてはdocs/roadmap.mdを参照するよう指示しており、Docker Compose、Settings、Celeryバックエンド、コンテキストエンジニアリングなどの完了済み項目が含まれています。このプロジェクトはMITライセンスの下でライセンスされており、ソフトウェアのコピーを使用、コピー、変更、マージ、公開、配布、サブライセンス、販売する権利を許可します。このライセンスはいかなる保証も提供せず、READMEはセキュリティ、サポート、パフォーマンスの保証について議論していません。

編集部の結論

READMEは、単一のAPIキーから実行中のエージェントへの具体的なパスを示し、ロードマップはプロジェクトが次に進む予定の方向を示しています。MITライセンスは保証なしでコードを対象としています。 採用前は、READMEに記載されたコマンドと設定名を対象環境で一つずつ照合し、実行ログ、生成物、対応するリリースを記録してください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes