Manus本地部署完整教程：从源码编译到配置全攻略

想要在本地成功运行 OpenManus，首先需要准备好一个干净的 Python 3.10 环境，然后拉取项目源码，依次安装依赖和浏览器内核，配置好 LLM 接口信息，最后才能启动服务。整个流程环环相扣，任何一个环节出现问题，都可能导致 main.py 启动后停留在“waiting for browser”状态，或者直接报错“no model found”。

如果你既不想去申请邀请码，也不愿意将数据上传到云端，同时还希望能自由切换 Ollama、OpenAI 等任意模型——那么在本地部署 OpenManus 无疑是最可靠的选择。不过，从零开始搭建并非易事：环境隔离、浏览器内核适配、API 密钥注入、配置文件修改……每一步都紧密相连。稍微疏忽一点，启动时就可能陷入死胡同。下面就是完整的搭建流程。

创建专用 Python 环境并激活

打开终端（Windows 使用 Anaconda Prompt 或 PowerShell，macOS/Linux 使用 Terminal），输入以下两行命令：

conda create -n openmanus python=3.10 -y

conda activate openmanus

这里必须提醒：Python 版本请务必使用 3.10，不要为了尝鲜而使用 3.12——部分 Playwright 底层组件在 3.12 下容易触发 segmentation fault，实际测试表明 3.10 非常稳定。环境激活后，命令行前面应该会显示 (openmanus)，如果看不到这个提示，说明环境没有进入，后续所有操作都会污染系统 Python，得不偿失。

获取源码并进入项目根目录

拉取源码有两种方式，选择适合自己的即可。

方式一：使用 Git 克隆（推荐，后续更新更方便）

git clone https://github.com/mannaandpoem/OpenManus.git → cd OpenManus

方式二：手动下载 ZIP（网络受限时的备用方案）

访问 Gitee 镜像站搜索“OpenManus”，下载 ZIP → 解压到 D:\Projects\OpenManus → 在该文件夹内右键打开终端

注意：不要解压到桌面或用户文档根目录，路径中如果包含中文或空格，Playwright 初始化时会报错。

分步安装核心依赖

先升级 pip，并跳过 Playwright 的自动安装（因为后续需要单独处理）：

pip install --upgrade pip → pip install -r requirements.txt --no-deps

然后单独安装 Playwright，指定国内镜像源以加快速度：

set PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright → pip install playwright

最后下载 Chromium 内核：

playwright install chromium

这一步比较耗时，但绝对不能跳过——OpenManus 的网页自动化完全依赖 Chromium 实例，没有它连百度都无法访问。如果下载超时，请检查系统能否访问 GitHub，或者配置科学上网，也可以在 hosts 文件中添加 140.82.113.4 github.com。

配置 LLM 模型与 API 密钥

首先复制配置模板：

Linux/macOS：cp config/config.example.toml config/config.toml

Windows：copy config\config.example.toml config\config.toml

然后用 VS Code 或 Notepad++ 打开 config/config.toml，找到 [llm] 区块，修改三个关键字段：

model：如果使用 Ollama，填 "llama3.2"（或其他本地模型）；如果使用 OpenAI，填 "gpt-4o" 之类的。

base_url：Ollama 是 "http://localhost:11434/v1"，OpenAI 是 "https://api.openai.com/v1"。

api_key：Ollama 固定填 "ollama"，OpenAI 填真实的密钥 "sk-..."。

如果需要启用视觉能力，同步修改 [llm.vision] 区块，确保 vision 模型支持多模态输入。

特别注意：不要将注释行（以 # 开头的）留在配置文件里，OpenManus 解析器会将其视为无效字段，导致配置解析失败。

启动服务并验证运行状态

最后，在终端中执行：

python main.py

如果看到输出 Starting OpenManus server on http://127.0.0.1:8000，那么恭喜，服务已经成功运行。打开浏览器访问 http://127.0.0.1:8000，输入“你好，能查一下今天北京天气吗？”。

如果页面返回结构化结果，并且底部显示 Browser ready，说明 Chromium 已经成功接管并完成了首次 DOM 加载。至此，整个搭建流程圆满完成。

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：Manus本地部署完整教程：从源码编译到配置全攻略要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题