百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

OpenManus 新手保姆教程(open manholes)

nanshan 2025-03-19 00:36 6 浏览 0 评论

OpenManus 新手保姆教程(Mac OS M1) - 初级入门

前言

作者:llxinlan , 邮箱 326011909@qq.com, 如发现错误,请随时和我联系!

当前版本: 2025-03-10

这是一个新手向的 OpenManus 教程,主要是面向新人,会非常基础,争取大家跟着教程走,可以运行起来。

目前 OpenManus 还是一个 POC demo(概念验证),所以会遇到很多问题,可以选择忽略,因为近期的迭代版本可能就会解决了。

OpenManus 更新迭代会很快,最新教程请访问:OpenManus 新手保姆教程

初级入门定位让你跑起 OpenManus ,更多 OpenManus 请关注我,等后续内容

阅读对象

  • 新手用户
  • 使用国内的模型
  • 可能解决不了魔法网络问题
  • 操作系统面向MAC OS M1

教程目标

  • 搭建可以正常运行的 OpenManus 环境
  • 知道如何做对应的模型配置
  • 了解一些 OpenManus 的基本原理

知识准备

对于新手,可能会遇到不少专用词汇或者黑话,这里做个简单说明

  • 魔法网络/ FQ 网络: 需要配置 VPN 才能访问的网络环境
  • Conda / MiniConda : Python 的环境配置工具, OpenManus 使用它来快速的建立 python 环境
  • code / vscode / Trea/PyCharm: 代码编辑器,强烈建议下载,可以用来看代码,修改模型配置文件, 下载地址: https://code.visualstudio.com/
  • Function calling / tools : 大模型的工具调用能力,目前配置的模型需要支持这个功能才能使用

环境搭建

下载代码

官方仓库

网址: GitHub - mannaandpoem/OpenManus: No fortress, purely open ground. OpenManus is Coming.

下载方案1

如果可以访问,并且可以使用 git 的,可以在终端中使用 git clone 下载

Plain Text
git clone https://github.com/mannaandpoem/OpenManus

如果下载一直失败,可以使用下面这个工具

下载方案2

访问官方仓库,点击页面上的 "Code" -> "Download Zip " 下载代码压缩包

下载方案3

国内镜像下载 ZIP 代码

Plain Text
https://gh.llkk.cc/https://github.com/mannaandpoem/OpenManus/archive/refs/heads/main.zip

Git Clone

Plain Text
git clone https://gh.llkk.cc/https://github.com/mannaandpoem/OpenManus

如果你更新了最新的代码,要先安装依赖,确保最新的代码可以运行

python
# 设置 pip 国内镜像
pip config set global.index-url
https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple

# 安装依赖
pip install -r requirements.txt
# 过程可能有点久,耐心等待

更新代码

如果是使用 git clone 的

python
# 除了 修改 config.toml 之外没有修改本地文件 直接使用
git pull origin main
# 更新代码
# 更新完成后 安装一次依赖,确保新代码可以运行
pip install -r requirements.txt

如果是下载 zip 包的,直接下载解压后,相同的文件覆盖即可

运行环境

MacOS 和 Linux 用户访问 Installing Miniconda - Anaconda 页面找到自己系统的安装包下载

进入项目目录,比如我测试环境下载的目录是 /Users/自己电脑名称/Downloads/OpenManus

python
cd
/Users/sml/Downloads/OpenManus

# 回车 如图所示

官方文档中使用

Bash
conda create -n open-manus python=3.12
# 创建新的环境
# 默认有个名称叫 base 的环境,我们也可以直接使用,跳过这一步

安装依赖

Bash
# 设置 pip 国内镜像
pip config set global.index-url
https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple

# 安装依赖
pip install -r requirements.txt
# 过程可能有点久,耐心等待

依赖安装完成,便可以运行测试

Bash
python main.py
# 效果如下

测试 OK 就可以退出了 Ctrl + Z或者输入 exit/quit 回车

安装浏览器所需组件, 完成后,我们先进行模型选择和配置

Bash
pip install playwright
playwright install
# 过程可能有点久,耐心等待

模型配置(要选择支持 tools 调用功能的模型!!!)

相同的模型,在不同的平台可能对 tools 的支持都不一样,有的支持有的不支持,所以还是要看选择的平台的那个具体的模型支持不支持

由于需要调用外部工具,所以需要大模型支持 tools (function calling ) 功能,这里会挑选几个供应商的模型配置给大家参考。

大多数 Key 只有在创建的时候让你复制一下,如果你忘记了重新创建一个即可!

注意替换 API key 时候是 api_key = "sk-***" 中 sk-*** 整体替换,而不是替换 "sk-***" 后面 *** 部分

DeepSeek 官方

目前只支持 deepseek-chat 模型 , 也就是 DeepSeek-V3 , DeekSeek-R1 由于不支持 tools 功能,目前不支持(但但是有其他厂商微调了带 tools 功能 R1, 后续跟进一下)

申请API

访问 DeepSeek创建一个 Api Key后复制保存下来,如果忘记了,重新创建一个即可.

配置(将 DeepSeek 后台保存的 key 替换 "sk-xxxx" 整体)

Bash
# Global LLM configuration
[llm]
model = "deepseek-chat"
base_url = "
https://api.deepseek.com/v1"

api_key = "
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx"

max_tokens = 8192
temperature = 0.0
# 备注: 目前多模态还没有整合,现在暂时可以不动
# Optional configuration for specific LLM models
[llm.vision]
model = "claude-3-5-sonnet"
base_url = "https://api.openai.com/v1"
api_key = "sk-..."

硅基流动

申请 API

官方网站:硅基流动统一登录

如果你通过我的邀请链接注册,我们都将免费获得 2000万token, 点击下面链接注册即可

https://cloud.siliconflow.cn/i/LENanA4z

或者下面的二维码

在 Api Key 页面申请密钥

https://cloud.siliconflow.cn/account/ak

然后在模型广场中筛选 tools 的模型,里面有免费模型

配置

python
# Global LLM configuration
[llm]
# 注意模型名称是这个规则的,网站页面模型主标题
model = "Qwen/QwQ-32B"
base_url = "
https://api.siliconflow.cn/v1"

api_key = "
sk-abcdeesdasdasdasdasdasdasd"

max_tokens = 8192
temperature = 0.0
# Optional configuration for specific LLM models
[llm.vision]
model = "claude-3-5-sonnet"
base_url = "https://api.openai.com/v1"
api_key = "sk-..."

派欧算力

申请 API

官方网站: 派欧算力云 - AI 云端一体化解决方案: 模型 API、Serverless、GPU 租赁

如果你通过我的邀请链接注册,我们都将免费获得 50元的额度, 点击下面链接注册即可

https://ppinfra.com/user/register?invited_by=WLK646

在 “密钥管理” 页面申请 Key : 设置 - 大模型 API 服务 | 派欧算力云

配置

python
# Global LLM configuration
[llm]
base_url = "https://api.ppinfra.com/v3/openai"
model = "qwen/qwq-32b"
api_key = "sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
max_tokens = 8192
temperature = 0.0
# Optional configuration for specific LLM models
[llm.vision]
model = "claude-3-5-sonnet"
base_url = "https://api.openai.com/v1"
api_key = "sk-..."

火山引擎

申请 API

官方网站:火山引擎-云上增长新动力

如果用我的邀请链接注册,我们最高双方可获得145元代金券,免费抵扣3625万tokens,畅享R1与V3模型!

参与入口:
https://volcengine.com/L/kj68YnaZAzs/ 邀请码:J5SDP9LS

访问火山方舟:账号登录-火山引擎

在模型广场选择支持 "Function Call" 的模型

点击模型详情后,点击右上角"模型推理",可以创建 Key

配置(要去火山方舟筛选 Function Calling 的模型)

python
# Global LLM configuration
[llm]
model = "doubao-1-5-pro-32k-250115"
base_url = "
https://ark.cn-beijing.volces.com/api/v3"

api_key = "eff5********************89d9"
max_tokens = 8192
temperature = 0.0
# 备注: 目前多模态还没有整合,现在暂时可以不动
# Optional configuration for specific LLM models
[llm.vision]
model = "claude-3-5-sonnet"
base_url = "https://api.openai.com/v1"
api_key = "sk-..."

在 OpenManus 中配置模型

在目录 config 下面复制 config.example.toml 一份改名为 config.toml , 然后将上面某一个平台(同时只能一个平台)的模型配置替换即可!

Plain Text
cp config/config.example.toml config/config.toml

测试运行(WebUI,要下载最新代码)

python
python app.py
# 运行后浏览器访问 http://0.0.0.0:8080 结果如下

我们用一个简单的指令来测试(绕过浏览器使用,避免无法访问 Google 的问题)

Bash
介绍一下你自己,并且将结果保存到 intro.txt

如果正常完成,你就会在项目根目录下看到一个 intro.txt 文件,我这里的结果是:

Bash
我是OpenManus,是一个全功能的AI助手,能够解决用户提出的任何任务。我拥有多种工具,如Python代码执行、信息检索、文件处理和网页浏览等,可以高效地完成复杂的请求。无论是编程、获取信息、处理文件还是浏览网页,我都能轻松应对。

如果不正常,请看下面 "常见问题" 排查

运行成功了,下一步就是去完成更加高级的任务

使用 ollama 部署本地模型,然后在 OpenManus 中使用等

欢迎一起交流, 我会在后续推出相关内容

出现问题不要怕,可以根据常见问题排查,也可以在群里问,群里问的时候把错误信息截图完整一些发出,同时把模型配置文件也发出,记得要把“key”修改掉或者打马赛克

测试运行(命令行)

Bash
#运行
python main.py
# 正常看到如下界面

常见问题(持续更新中...)

API Error: Request timeout

基本上是 API 网站无法正常访问,需要魔法

API error:404 page not found

模型 base_url 配置错误,请核对配置

卡在 30/30 轮

目前程序设置了 最大 30 轮的配置,以后会迭代优化成自动配置

The tool call is not supported

没有选对支持 tools 的模型, 需要更换模型

Reasoner Does not support Function Calling

没有选对支持 tools 的模型, 需要更换模型

This model's maximum context length is 65536 tokens. However, you requested 69127 tokens (65031 in the messages, 4096 in the completion). Please reduce the length of the messages or completion.

超出模型最大 token ,需要更换支持更大上下文的模型

Authentication failed. Check API key.

模型 Key 错误或者已经失效

Model Not Exists

模型不存在,就是模型名称配置错误了,重新检查核对

insufficient balance

Key 欠费,余额不足

Tool 'google_search' encountered a problem: 429 Client Error: Too Many Requests for url:

Google 搜索模块 频率过高,目前没有很好的解决方法

(大部分内容转抄自windows环境,作者: 404老吴(Liangdi), 邮箱 wu@liangdi.me OpenManus 新手保姆教程 - 初级入门)

下一步

「链接」OpenManus 新手保姆教程 - Ollama 私有模型

相关推荐

小白初学linux之无法修改系统分辨率

/*此文是做为自己的一个总结还有就是最好也可以给大家提供一些帮助。*/时间:2020年7月14日11:28:41我安装的是Ubuntu20.04LTS,昨天处理的是,grub的引导问题,因为是...

Ubuntu 如何启动、停止或重启服务

在本文中,我们向您介绍在Ubuntu中启动、停止和重启服务的方法。列出Ubuntu中的所有服务在开始之前,先获取计算机上所有服务的列表,因为我们需要知道服务名称来管理服务。service--...

Win11学院:如何在Windows 11上使用WSL安装Ubuntu

IT之家2月18日消息,科技媒体pureinfotech昨日(2月17日)发布博文,介绍了3中简便的方法,让你轻松在Windows11系统中,使用WindowsSubs...

Linux安装中文输入法-Google拼音输入法,搜狗输入法

主要步骤,选择适合自己的尝试:1)卸载之前没装好的搜狗输入法。@:~/Downloads$sudoapt-getremovefcitx*删除依赖库@:~/Downloads$sudoap...

Ubuntu 22.04 请谨慎使用搜狗输入法,可能是你当机原因

在Ubunutu下没有什么有名的输入法,也就听说搜狗输入法有Linux版本,所以特意到官网去找了下载。在Ubuntu新版本里,他仍然用的是fcitx框架的输入引擎,而不是默认的ibus,所以要先把i...

前钢后胶!徐工XMR403VT小型压路机有点意思

【第一工程机械网原创】在越来越注重施工品质,对项目管理越来越精细化的今天,施工方在施工设备选择上,也越来越讲究设备的配套分工,因此小型压路机的应用场景也越来越多。徐工XMR403VT小型压路机高度集...

图大明白 | 404错误为什么是Not Found?为什么是404?

“404错误”大家都不陌生吧?常规来讲它长这样或者长这样艺术一点的长这样404NotFound意思就是所请求的页面不存在或者已被删除被称为“互联网最后一个界面”有很多同学发出疑问:为什么是404?...

Nginx负载均衡安全配置说明2(nginx负载均衡部署)

上一节,我们对Nginx安全配置的几个知识点做了一个说明,例如限制IP访问、文件目录禁止访问限制、需要防止DOS攻击、请求方法的限制和限制文件上传的大小这个进行了一个分析说明,详细的文章请关注我的头条...

惊艳写真系列第403期,本期主人公—叶青

惊艳写真系列第403期,本期主人公—叶青制作不易,欢迎各位看官提供宝贵意见。如果您喜欢记得关注,么么哒。您的每一份点赞和关注都是对作者的最大认可(图片素材均来源于网络,如有侵权联系删除。)本篇是写惊艳...

先秦布币之尖足布、圆足布、方足布,今年圆足最高拍卖价16万一枚

在战国魏、韩地区诞生桥足平首布、锐角平首布之后,赵也诞生了尖足平首布,并且在尖足布的基础上,后来相继派生出了圆足布、三孔布,以及类圆足布和类方足布。一尖足布尖足布是从耸肩尖足空首布演变而来的,是黄河...

403 禁止访问错误的全面排查与解决方案

当遇到403Forbidden错误时,意味着服务器已接收并理解请求,但拒绝执行访问操作。以下从用户端、服务器端等多个维度,提供分步排查与解决方法。一、用户端基础排查1.检查URL准确性确认...

这才是2019年夏最高颜值的泳装(2019夏季泳装秀)

最近的天气是越来越热了,又到了暑期泳衣勇闯海滩的时刻了,打开ins,微博满满地都是各大博主晒的泳装照,明星们也纷纷跑到海边去度假了。虽然我们没有超模般地身材,但是到了海边我们也要成为人群中最亮眼的那颗...

朋友圈爆火!这组《衡中班主任的一天》漫画,感动了无数人!

很多人觉得做老师很轻松他们说有些老师一天一节课就下班了有双休,还有寒暑假,真让人羡慕呀······但事实真是这样吗?最近衡水中学的赵心扬同学画了一组漫画形象地还原了衡中班主任一天的生活那么衡中班主任一...

国家安全教育 | 一组漫画,带你走进国家安全!

当前,我国面临哪些安全威胁?下面带你来看一组漫画!①你要配合,注意保密。我绝不对别人讲。②这件事,千万别对别人讲。③咱单位的…喂!老k!你要当心,有风声了!④你的泄密行为已触犯了国家法律!①请你协助了...

400、403、404、405,访问网页时出现这些代码是什么意思?

今天小泽访问一个页面时,出现了403,很抱歉,您的访问请求被禁止的提示。相信经常用电脑访问网页的朋友都遇到过这种情况,有的网页提示错误代码403,有的提示404,那这些代码都代表了什么呢?有什么含义呢...

取消回复欢迎 发表评论: