Simpleyyt/ai-manus：README に基づく導入ガイド

Simpleyyt/ai-manus の README はプロジェクトを「AI Manus is a general-purpose AI Agent system that supports running various tools and operations in a sandbox environment.」と説明しています。ここではリポジトリで確認できる事実だけを整理します。star 数やバッジは注目度の手掛かりであり、品質の証明ではありません。「AI Manus」には次の説明があります。AI Manus is a general-purpose AI Agent system that supports running various tools and operations in a sandbox environment. Now with Claw , a deeply integrated OpenClaw AI assistant that brings one-click deployment, per-user isolated。これは範囲の説明であり、本番検証の結果ではありません。

README の「Key Features」にある内容から、用途が合うかを先に判断できます。Deployment: Minimal deployment requires only an LLM service, with no dependency on other external services.。目的が違うなら、人気だけで採用する理由にはなりません。プロジェクト名やコマンドは原文のまま残し、一次資料へ戻って用語を確認できるようにしています。 README には次の確認可能な項目もあります。Task: Code Use, Browser Use, and multi-session switching。初回テストの材料にはなりますが、実際の環境での確認を省略する理由にはなりません。

動作の説明は「AI Manus」など複数の箇所に分かれています。確認できる情報は次の通りです。📝 Blog: Rebuild Manus with WebUI and Sandbox。書かれていない構成、性能、セキュリティを推測で補いません。導入時はディレクトリ、設定ファイル、release 履歴を確認してください。

初回導入は README の入口から始めます。確認できるコマンドは次の通りです。 services: frontend: image: simpleyyt/manus-frontend ports: - "5173:80" depends_on: - backend restart: unless-stopped networks: - manus-network environment: - BACKEND_URL=http://backend:8000 backend: image: simpleyyt/manus-backend depends_on: - sandbox - claw restart: unless-stopped volumes: - /var/run/docker.sock:/var/run/docker.sock:ro #- ./mcp.json:/etc/mcp.json # Mount MCP servers directory networ 実行可能なコマンドがない場合は手順を作らず、「Demos」で依存関係、待受ポート、初回設定を確認します。

日常運用は公式文書の範囲に限ります。「Overall Design」には1. Web sends a request to create an Agent to the Server, which creates a Sandbox through /var/run/docker.sock and returns a session ID. 2.とあります。設定、環境変数、権限、データ保存先は明記されたものだけを扱います。未記載の既定値は隔離環境で確認し、戻せる設定を保存してください。 同じ資料にはAgent loop: Plan-and-execute flow with composable system prompts and native structured output tools (no fragile JSON-in-prompt protocol).ともあります。