需用python 3.10创建conda环境,克隆openmanus源码,按步骤安装依赖、playwright及chromium,配置config.toml中llm参数,最后运行main.py启动服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想在本地电脑上运行Manus的开源平替OpenManus,不依赖邀请码、不上传隐私数据、还能自由对接Ollama或OpenAI等任意LLM服务——这需要从源码开始搭建完整执行链,包括环境隔离、浏览器内核适配、API密钥注入和配置文件结构化修改,任何一步出错都会导致main.py启动后卡在“waiting for browser”或报错“no model found”。
创建专用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实例,没有它连百度都打不开】。若提示“timeout”,请确认系统已配置科学上网或hosts中添加了140.82.113.4 github.com。
配置LLM模型与API密钥
① 复制配置模板:cp config/config.example.toml config/config.toml(Linux/macOS)或 copy config\config.example.toml config\config.toml(Windows)
② 用VS Code或Notepad++打开config/config.toml
③ 找到[llm]区块,按需修改三项关键字段:
model = "llama3.2"(若用Ollama)或 "gpt-4o"(若用OpenAI)
base_url = "http://localhost:11434/v1"(Ollama)或 "https://api.openai.com/v1"(OpenAI)
api_key = "ollama"(Ollama固定值)或 "sk-..."(OpenAI真实密钥)
④ 若启用视觉能力,同步修改[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加载











