Manus开源复刻里最接近原版设计的一个：PlanAct+沙箱隔离

Manus 带火的那个开源复刻，现在长成了真正的开发框架

去年 3 月Manus一夜爆红，整个AI圈都在疯抢邀请码。MetaGPT团队3小时火速上线OpenManus，算是给想尝鲜的人解了渴。但如果你认真用下来，会发现OpenManus本质是个快速原型，真要落地还得自己搭不少东西。

今天要聊的这个项目，是Manus原始作者（至少是同期国内最早一批复刻方之一）做的完整实现——ai-manus，来自独立开发者 simpleyyt，GitHub已经有1.5k+ stars，224次commit，MIT协议，最近一次代码更新就在5天前。

它跟OpenManus有什么区别？

最核心的区别是架构思路。OpenManus追求的是”快速复刻Manus效果”，所以把工具塞进ReAct循环里，能跑就行。ai-manus则更接近Manus原始设计——PlanAct双层架构：

• Planner层：接收用户需求，用PlanningTool做任务分解，写出一个结构化的plan.md
• Act层：把plan里的每个任务动态分配给最适合的Agent执行，Agent内部走ToolCall循环

这个设计比纯ReAct稳定多了。复杂任务（比如”帮我分析这批CSV数据，生成可视化报告并存到Notion”）不会跑着跑着就忘了自己要干什么，因为Planner已经在plan里把路标立好了。

沙箱才是灵魂

ai-manus另一个做得彻底的地方是Docker沙箱隔离。每个任务进来，系统会通过/var/run/docker.sock动态创建一个独立的Ubuntu沙箱容器，里面跑着Chrome无头浏览器、Shell、File等服务。

Agent写的代码在沙箱里跑，Agent开的浏览器也在沙箱里，宿主机完全隔离。这意味着你可以放心让Agent执行”npm install”或者”打开网页点按钮”这种操作——搞砸了也就是容器层面崩掉，不影响真实系统。

沙箱通过NoVNC推送到前端，开发者可以实时看到Agent在浏览器里做什么，随时介入接管。

支持MCP扩展，这才是正经框架该有的样子

ai-manus预留了MCP（Model Context Protocol）扩展口，可以把外部MCP工具接入进来作为Agent的能力。README里提到cloud agents starter skill，这个方向很明显——团队正在把ai-manus往”可扩展的Agent开发框架”而非”一次性演示工具”的方向做。

最近一个commit（5天前）还加了自定义搜索provider（Serper.dev、通用HTTP search），说明工具层在持续丰富。

怎么跑起来

官方推荐Docker Compose一键部署，最少只需要配一个LLM的API Key（OpenAI兼容格式，支持Deepseek和GPT）。本地起服务：

• 前端：http://localhost:5173
• 后端API：http://localhost:8000
• NoVNC实时预览：5902端口

开发调试模式支持热重载，改了代码服务自动reload，还有远程debugpy端口5678可以接IDE断点调试。

适合什么人用？

如果你想自己搭一套类似Manus的私有Agent系统，或者需要让AI真正替你操作用户界面（浏览器自动化、文件操作、终端命令），ai-manus是目前开源界最完整的参考实现之一。它不是LangChain那种”给你一堆零件自己组装”，而是已经搭好了核心调度逻辑，你只需要配工具和模型。

当然它也有局限：需要自己准备LLM API、没有内置的持久化记忆层（Session靠MongoDB但Memory要自己接）、部署有一定门槛（Docker基础环境）。但这些对于想深度定制的开发者来说，反而是好事。

项目地址在下面，感兴趣的同学可以clone下来跑一个demo感受一下。

https://github.com/simpleyyt/ai-manus

GitHub: https://github.com/simpleyyt/ai-manus