想要在本地成功运行 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 加载。至此，整个搭建流程圆满完成。