OpenManus安装及使用教程

最新推荐文章于 2025-06-23 20:49:30 发布

村羊吵月芽

最新推荐文章于 2025-06-23 20:49:30 发布

阅读量1k

点赞数 31

CC 4.0 BY-SA版权

分类专栏：大模型文章标签：人工智能语言模型 python

本文链接：https://blog.youkuaiyun.com/weixin_65973062/article/details/147169341

大模型专栏收录该内容

5 篇文章

订阅专栏

OpenManus安装及使用教程

一、OpenManus介绍
二、基本知识
- 1、基础必备知识
- 2、Anaconda常用操作
三、OpenManus安装与运行
四、示例
五、遇到的问题与解决

一、OpenManus介绍

OpenManus，由 MetaGPT 团队精心打造的开源项目，于2025年3月发布。它致力于模仿并改进 Manus 这一封闭式商业 AI Agent 的核心功能，为用户提供无需邀请码、可本地化部署的智能体解决方案。换句话说，OpenManus 就像一位全能的数字助手，能够在你的本地设备上运行，随时听候差遣，完成各种复杂任务。

它的出现，打破了技术领域的高墙，让每一位开发者都有机会站在同一起跑线上，快速实现诸如代码生成、数据分析、网络信息检索等复杂任务的自动化处理。无论你是独立开发者，还是大型团队的一员，OpenManus 都能为你提供强大的支持，让你专注于创造性的核心工作，而非将时间浪费在重复性任务上。

二、基本知识

1、基础必备知识

使用OpenManus前需要了解关于git、github、anaconda、虚拟环境等相关知识。

git安装与使用教程：git安装与使用教程
github使用教程：github使用教程
Anaconda下载与环境配置：Anaconda下载与环境配置

2、Anaconda常用操作

创建虚拟环境：

conda create -n 虚拟环境名 python=版本号

查看有哪些虚拟环境：

conda env list

激活/使用虚拟环境：

conda activate 虚拟环境名

退出虚拟环境：

conda activate 或 conda deactivate

下载包：

conda install 包名

删除包（只删除这个虚拟环境里面的）：

conda uninstall 包名

将该指定虚拟环境及其中所安装的包都删除：

conda remove --name env_name --all

只删除虚拟环境中的某个或者某些包则是：

conda remove --name env_name  package_name

虚拟环境在envs_dirs中，包在pkgs_dirs中(每个包只会下载一次，用时会复制过来)

三、OpenManus安装与运行

1、安装指南

创建新的 conda 环境：

conda create -n open_manus python=3.12
conda activate open_manus

克隆仓库：

git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus

安装依赖：

pip install -r requirements.txt

实测发现，需要安装playwright才能让Agent调用浏览器工具搜索资料：

playwright install

2、配置大模型

OpenManus 需要配置使用的 LLM API，这里使用火山引擎中的deepseek-v3。
先在火山引擎中创建一个deepseek-v3的api_key，再进行以下操作

在 config 目录创建 config.toml 文件（可从示例复制）：
编辑 config/config.toml 添加 API 密钥和自定义设置：

#全局 LLM 配置
[llm]
model = "ep-20250412202953-gz8wf" # 接入点ID
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
api_key = "sk-..."  # 替换为真实 API 密钥
max_tokens = 4096
temperature = 0.0

# 可选特定 LLM 模型配置
[llm.vision]
model = "ep-20250412202953-gz8wf"
base_url = "https://ark.cn-beijing.volces.com/api/v3"
api_key = "sk-..."  # 替换为真实 API 密钥

3、运行OpenManus

一行命令运行 OpenManus：

python main.py

出现Enter your prompt说明运行成功：
在这里插入图片描述
在Enter your prompt后面输入任务与要求，OpenManus即可开始操作。

4、常见错误

在这里插入图片描述
这是最常见的报错，表示请求的大模型已关闭或不可用，说明模型服务配置失败。检查配置文件中的model、base_url、api_key是否配置正确。

四、示例

1、查询资料

我们让OpenManus查询人工智能相关资料，并将网址保存在指定目录下。
输入任务：搜索人工智能相关资料，在浏览器不同标签打开至少5个搜索结果，将网址保存到C:\openmanus目录下，请使用中文。
OpenManus自动打开浏览器进行搜索：
在这里插入图片描述
运行结束后，在指定位置出现了ai_urls.txt文件：

打开文件，可以看到成功保存了五个网址：

2、旅游攻略

让OpenManus制作一份旅游攻略，并保存在指定目录中。
输入任务：帮我规划一份重庆3天旅游攻略，预算3000元以内，以md格式保存到C:\openmanus中，请使用中文
同样，在指定目录下成功生成了旅游攻略：
在这里插入图片描述

3、使用电脑软件进行操作

1.第一步，我们让OpenManus使用WPS新建一个word放在指定目录，并在里面写入关于agent的介绍：

在这里插入图片描述

创建成功：

在这里插入图片描述

2.第二步，我们让OpenManus将这份word文件使用WPS转换为pdf格式

可以看到OpenManus列举了操作步骤，非常清晰，后面遇到问题也会对步骤进行动态调整。

创建成功：

在这里插入图片描述

3、贪吃蛇游戏

最后，我们让OpenManus使用python写一个贪吃蛇游戏。
尝试让OpenManus自行下载所需包比如pygame，最后下载包失败，于是我先将pygame包下载好再次尝试：
在这里插入图片描述
很快就完成了：

在别的项目中运行该文件：

可以正常游玩，还有计分，虽然整体看起来比较简单，但基本功能都很完善。

五、遇到的问题与解决

经过多次测试发现，OpenManus存在一些问题：

文件创建失败
在明确指出需要创建文件时，OpenManus很多次都没有创建文件，比如查询天气，查询完就结束了，多次尝试修改语句但还是没有解决。
无法自行下载相关包
当要求OpenManus创建pdf相关文件并进行操作时，会显示没有相关包，并跳过这条要求，在给出的要求中加上“请自行下载所需python相关包”，确实会下载包，但最后会下载失败。
无法自主决定
让OpenManus进行数据分析并生成分析报告时，OpenManus会搜索到一篇分析报告，但不知道是下载该篇分析报告还是自己分析，最后就是什么结果都没有。

可能是OpenManus确实有这些问题，也有可能是我给的命令不够规范，后面会进行更多试验尝试解决这些问题。