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

本地部署OpenManus需要从零搭建一套完整的运行环境：安装Python 3.10虚拟环境、拉取项目源码、配置依赖与浏览器内核、注入模型接口凭证，最后才能启动服务。每个环节紧密关联，稍有疏漏就会导致main.py启动后卡死在"waiting for browser"，或抛出"no model found"错误。

无需申请邀请码、无需依赖云端传输，且能随意切换Ollama、OpenAI等模型——本地部署OpenManus是当前最可控的方案。但整套流程包含环境隔离、浏览器内核适配、API密钥注入和配置文件调优等多个环节，任何一个遗漏都会让启动过程卡壳。下面拆解完整的部署链路。

创建并激活Python 3.10虚拟环境

在终端（Windows推荐Anaconda Prompt或PowerShell，macOS/Linux使用Terminal）中依次执行：

conda create -n openmanus python=3.10 -y

conda activate openmanus

Python版本必须锁定3.10。3.12中部分Playwright底层组件会引发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，表明服务已启动成功。在浏览器中打开该地址，输入"你好，能查一下今天北京天气吗？"测试。

如果页面返回结构化响应，且底部显示Browser ready，说明Chromium已成功接管并完成首次DOM加载。至此，本地部署流程全部完成。

来源：互联网