在Windows系统上成功部署并运行Manus AI智能体,关键是先做好Python环境隔离与版本管理。否则一旦出现pip混装依赖问题,open_manus启动失败或工具链中途崩溃的情况会频繁发生。掌握正确的操作顺序,按步骤执行就能稳妥完成环境搭建。
首先安装Miniconda,安装过程中务必勾选“Add to PATH”选项。这个配置至关重要,否则后续所有conda命令都会提示“不是内部命令”,处理起来相当麻烦。安装完成后在CMD中输入conda --version验证;如果没有响应,说明PATH配置未生效,需要手动将C:Users用户名miniconda3Scripts和C:Users用户名miniconda3添加到系统环境变量中。
国内用户建议立即执行以下命令,配置清华镜像源,否则后续conda create在包下载环节可能卡住:conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
安装Conda并配置清华镜像源
从Miniconda官网下载Windows 64位安装包,体积小巧且不含冗余库。安装时务必选中勾选框,否则路径配置会成为后续操作的障碍。
安装后若验证步骤失败,除了检查PATH,也可以尝试重启终端。很多情况下问题就这样简单解决了。
创建并激活open_manus专属环境
在CMD或PowerShell中确认PATH配置正确后,运行:
conda create -n open_manus python=3.12
Python 3.12是强制要求——OpenManus主仓库明确声明不兼容3.13及以上版本,且部分依赖如pydantic v1在3.11下会报错。环境创建完成后,执行:
conda activate open_manus
如果遇到CondaError: Run 'conda init' before 'conda activate',需先运行conda init powershell(或conda init cmd.exe),然后关闭当前终端,打开新终端再执行activate——在Windows上这个初始化步骤很容易被忽略。
安装Ollama并拉取Mistral模型
访问https://ollama.com/download下载Windows版Ollama安装程序,双击安装即可。安装成功后系统托盘会显示蓝色鲸鱼图标,表明服务已在后台运行。
在任何终端中输入ollama --version进行验证。接着拉取Mistral模型,大小约7GB:
ollama run mistral
首次运行会自动下载。网络状况不佳时不要急于关闭命令行窗口;中途断开可能导致模型文件损坏,需手动清理%USERPROFILE%ollamamodelsblobs下的残留文件后再重试。
克隆与安装OpenManus核心代码
前提条件:先安装Git(未安装可前往git-scm.com下载)。在conda activate open_manus状态下执行:
git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus
安装依赖前有一项关键操作:先解决numpy版本冲突。OpenManus的requirements.txt默认拉取最新版numpy,但其底层依赖的llama-cpp-python在Windows上仅兼容numpy==1.23.5。
因此务必提前执行:
pip install numpy==1.23.5
然后再运行:
pip install -r requirements.txt
如果仍然报错,请确认当前是否在open_manus环境而非base环境中执行pip命令——终端提示符左侧必须显示(open_manus),否则所有安装操作将无效。

总体来说,环境搭建本身并不复杂,但细节处理容易出错。遵循以上步骤操作,应该能够顺利让Manus AI运行起来。如果中途遇到问题,优先检查终端提示符中的环境名称,确保每一步都在正确的conda环境中执行。
