夜雨聆风手把手教你部署开源版Manus无需邀请码，本地就能跑
— — — — — — — — — —
一、OpenManus是什么？
OpenManus由MetaGPT团队开发，2025年3月6日发布，是火爆全网的AI Agent产品Manus的开源复刻版。它的口号"No fortress, purely open ground"（没有堡垒，纯粹开放），意味着任何人都可以自由使用、修改和部署——无需邀请码、无需付费。
OpenManus能做什么？
• 自动执行Python代码并查看结果
• 搜索网络信息并整合分析
• 读写和编辑文件
• 自主规划任务并逐步执行
• 生成报告、分析数据、处理文档
二、安装前准备
2.1 系统要求
项目 | 要求 |
操作系统 | Windows 10/11、macOS 10.15+、Linux Ubuntu 20.04+ |
Python | 3.12（必须） |
Git | 最新版 |
网络 | 能访问大模型API |
⚠️ OpenManus严格要求Python 3.12，3.10或3.11都不行！如果你的系统已有其他Python版本，请看下面的多版本管理方法。
2.2 安装Python 3.12（多版本共存）
推荐使用Pyenv管理Python版本，不影响系统已有版本：
第一步：安装Pyenv
# Linux/macOScurl https://pyenv.run | bash# 配置环境变量（添加到 ~/.bashrc 或 ~/.zshrc）export PYENV_ROOT="$HOME/.pyenv"[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"eval "$(pyenv init -)"# 刷新环境source ~/.bashrc
第二步：安装Python 3.12
pyenv install 3.12.6
第三步：在项目目录下切换版本（不影响其他项目）
pyenv local 3.12.6python --version # 应显示 3.12.6
��Windows用户推荐使用 pyenv-win，安装命令：pip install pyenv-win --target %USERPROFILE%\.pyenv
三、安装OpenManus
3.1 下载源码
git clone https://github.com/FoundationAgents/OpenManus.gitcd OpenManus
3.2 创建虚拟环境并安装依赖
# 在项目目录下执行pyenv local 3.12.6python -m venv venv# 激活虚拟环境# Linux/macOS:source venv/bin/activate# Windows:venv\Scripts\activate# 安装依赖pip install -r requirements.txt
3.3 配置API Key
# 复制配置文件模板cp config/config.example.toml config/config.toml
编辑 config.toml 文件，填入你的模型配置：
[llm]model = "gpt-4o"base_url = "https://api.openai.com/v1"api_key = "sk-你的OpenAI密钥"max_tokens = 8192temperature = 0.7
��国内用户推荐使用DeepSeek或智谱AI的API，无需翻墙，价格更便宜：model = "deepseek-chat"base_url = "https://api.deepseek.com/v1"api_key = "sk-你的DeepSeek密钥"
四、启动与使用
# 确保虚拟环境已激活python main.py
看到 "Enter your prompt:" 提示，说明部署成功！
现在可以开始和OpenManus对话了，例如：
Enter your prompt: 请帮我写一个Python爬虫，爬取豆瓣电影Top250的电影名称和评分
OpenManus会自主完成以下步骤：
• 1. 规划任务：分析需求，拆分为多个子步骤
• 2. 编写代码：生成Python爬虫代码
• 3. 执行验证：运行代码并检查结果
• 4. 修正错误：如果遇到问题，自动修正并重新执行
• 5. 输出结果：将最终结果整理后返回给你
五、常见问题
问题 | 解决方法 |
Python版本不对 | 使用pyenv local 3.12.6切换到正确版本 |
pip安装超时 | 使用国内镜像：pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple |
网络代理问题 | 在main.py中清除代理设置（见下文） |
API Key报错 | 检查config.toml中的api_key、base_url和model是否正确 |
虚拟环境激活失败(Windows) | 执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser |
5.1 清除代理设置
如果你在公司内网，可能需要在 main.py 的 if __name__ == "__main__": 块内添加：
import osos.environ["http_proxy"] = ""os.environ["https_proxy"] = ""os.environ["HTTP_PROXY"] = ""os.environ["HTTPS_PROXY"] = ""os.environ["no_proxy"] = "*"os.environ["NO_PROXY"] = "*"
六、进阶玩法
• 自定义工具：在 tools/ 目录下添加自己的工具函数，扩展Agent能力
• 配置多个模型：在 config.toml 中配置不同任务使用不同模型
• 集成浏览器：配合 Playwright 实现网页自动化操作
• OpenManus-RL：尝试强化学习优化版本，让Agent越用越聪明
— — — — — — — — — —
本文发布于2026年6月4日。OpenManus更新频繁，建议关注 github.com/FoundationAgents/OpenManus 获取最新信息。
