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

冬涛姑娘_8061

冬涛姑娘_8061

2026-06-06

559人浏览

原创

需用python 3.10创建conda环境,克隆openmanus源码,按步骤安装依赖、playwright及chromium,配置config.toml中llm参数,最后运行main.py启动服务。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

manus本地部署全攻略:从源码编译到配置【教程】

你想在本地电脑上运行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内核

Zoom Workplace
Zoom Workplace

Zoom Workplace是一款AI办公效率工具,Zoom推出的AI办公协作和交流沟通平台。

下载

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加载

相关文章

热门游戏推荐
热门游戏推荐

海量精品小游戏合集,无需安装即点即玩,休闲益智、动作闯关应有尽有,秒开即玩,轻松解压,快乐停不下来

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Manus AI使用指南大全
Manus AI使用指南大全

汇总 Manus AI 使用教程与实战案例,包含 Agent 自动化、AI 工作流、网页开发、Research 使用技巧以及新手快速入门指南。

2026.05.29

574

22

Manus AI案例汇总
Manus AI案例汇总

分享 Manus AI 企业落地案例,包括 AI 自动办公、Research、数据分析、AI 客服与企业级智能体应用解决方案。

2026.05.29

214

15

AI Agent 实战指南:从评测到落地
AI Agent 实战指南:从评测到落地

全面评测 Manus AI 与 ChatGPT、Claude、OpenAI Operator 等 AI Agent 产品,分析自动化能力、工作流与实际生产力差异。

2026.05.29

333

15

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

180

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

80

15

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

2026.09.23

80

15

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

2026.09.22

60

12

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

2026.09.22

60

13

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

2026.09.22

60

19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
前端开发(基础+实战项目合集)
前端开发(基础+实战项目合集)

共60课时 | 6.3万人学习

Django 教程
Django 教程

共8课时 | 11.2万人学习

MVC教程
MVC教程

共12课时 | 4.9万人学习