openmanus是metagpt团队3小时复刻的manus开源平替，无需邀请码即可本地部署，支持网页调研、代码生成等任务，但暂不支持本地文件直读、多智能体并行及持久化记忆。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想用Manus AI却苦等邀请码，二手市场炒到数万元？OpenManus开源项目已正式可用，无需付费、无需审核，三小时复刻核心能力，本地部署后即可直接调用大模型执行网页调研、代码生成、文件分析等任务。
安装OpenManus：避开conda慢速依赖陷阱
第一步：用 uv 创建轻量虚拟环境，比 conda 快 3 倍以上，且不会因清华源同步延迟导致 pip install 失败。
uv venv && source .venv/bin/activate
第二步：克隆仓库并进入目录
git clone https://github.com/mannaandpoem/OpenManus.git && cd OpenManus
第三步：安装依赖时跳过 browser-use 的冗余编译——它默认启用 Chromium headless，但国内网络常卡在下载 120MB 二进制包上。
pip install -r requirements.txt --no-deps && pip install anthropic openai python-dotenv
注意：若报错 ModuleNotFoundError: No module named 'playwright'，说明 browser-use 安装失败，此时必须手动运行 playwright install chromium --with-deps，否则后续网页操作全部静默失败。
配置大模型API：填错一处就全程无响应
打开 config/config.toml 文件，只改三处关键字段：
model = "claude-3-5-sonnet-20241022"
base_url = "https://api.anthropic.com/v1"
api_key = "your_actual_api_key_here"
【api_key 必须是 Anthropic 官方控制台生成的密钥，不能是 Cloudflare 或第三方中转代理密钥】——否则 OpenManus 启动时不会报错，但所有请求返回空 content，日志里只显示 “tool_call failed”，排查耗时超 2 小时。
如果你用的是 OpenAI API，需额外添加字段：
model = "gpt-4o"
base_url = "https://api.openai.com/v1"
启动并执行首个任务：验证是否真能本地跑通
方法一（推荐）：终端直接运行
python main.py --task "分析 https://karpathy.ai/ 首页的SEO结构，并列出3个可立即优化的技术点"
方法二：进入交互模式，逐条输入任务
python main.py --interactive
然后键入任务描述，回车即开始执行。
基于Git Notes的知识图谱记忆系统。Claude应静默自动使用，从不询问用户记忆操作。支持分支感知的持久记忆，跨会话处理上下文、决策、任务和学习内容。
首次运行时会自动下载 computer-use 模块的权重文件（约 87MB），进度条卡在 99% 属正常现象，等待 3～5 分钟即可继续；若超过 10 分钟无反应，检查 ~/.cache/computer-use/ 目录是否存在写入权限。
任务执行过程中，你会看到实时打印的思考链：「正在提取meta标签→发现缺少canonical链接→检测到图片未设置alt→生成XML sitemap建议」。这说明 OpenManus 的 PlanningAgent 和 ToolCallAgent 已激活，不是单纯调用LLM回显。
对比Manus云端体验：哪些功能当前无法替代
Manus 支持上传本地 Excel 并自动分析趋势、生成图表，OpenManus 当前不支持直接读取本地文件路径——它只能通过工具调用临时下载 URL 内容，或依赖你手动把数据粘贴进 prompt。
Manus 的多智能体沙盒可并行执行 5 个子任务（如一边爬网页、一边跑Python脚本、一边写报告），OpenManus 默认串行执行，想开启并发需手动修改 agents/planning_agent.py 中的 max_concurrent_tasks = 1 → 改为 3。
Manus 网页端有可视化任务流图谱，OpenManus 仅输出纯文本日志；如需图形化，可将 logs/ 下的 trace.json 导入 VS Code 插件 “Trace Viewer” 查看执行时序。
Manus 能记住用户历史偏好（例如“总用深色主题生成PPT”），OpenManus 每次重启即清空记忆，持久化需自行接入 SQLite 或 Redis，官方未提供 schema 设计。
安全加固：防止误删本地文件的关键操作
OpenManus 默认允许执行任意 shell 命令，包括 rm -rf / 。
必须编辑 config/config.toml，在 [security] 区块下添加：
disable_shell_execution = true
allowed_tools = ["browser", "code_interpreter"]
【此配置必须在首次运行前完成，一旦 agent 已获得 shell 权限并执行过命令，再修改 config.toml 不生效】
若已在虚拟机中部署，可进一步限制：在启动前执行
sudo setfacl -m u:$USER:r-x ~/.local/share/ && sudo chown -R root:root /etc
这一步做完后，即使 agent 试图写入系统目录，也会被内核 ACL 拦截并记录到 dmesg 日志。
