OpenManus 新手保姆教程（Windows环境）

摘要：python# 设置 pip 国内镜像pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple# 备注，如果上面的清华源一直安装不了依赖，可以尝

前言

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

当前版本: 2025-03-13

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

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

OpenManus 更新迭代会很快，最新教程请访问: OpenManus 新手保姆教程 - 初级入门

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

阅读对象

新手用户

使用国内的模型

可能解决不了魔法网络问题

操作系统面向 Windows 10 / 11

教程目标

搭建可以正常运行的 OpenManus 环境

知道如何做对应的模型配置

了解一些 OpenManus 的基本原理

知识准备

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

魔法网络/ FQ 网络: 需要配置 VPN 才能访问的网络环境（非必须）

Conda / MiniConda : Python 的环境配置工具， OpenManus 使用它来快速的建立 python 环境

code / vscode : 代码编辑器，强烈建议下载，可以用来看代码，修改模型配置文件, 下载地址: https://code.visualstudio.com/

Function calling / tools : 大模型的工具调用能力，目前配置的模型需要支持这个功能才能使用

环境搭建

下载代码

官方仓库

网址: https://github.com/mannaandpoem/OpenManus

个人仓库：https://gitee.com/smyou/OpenManus

目前更新了三个分支main: 仅保留核心代码，是一个极简框架，可以比较容易兼容到其它场景front-end：加入了前端代码，可以有运行界面展示，大家玩的时候可以拉这个mcp: 基于mcp协议的openmanus在这个分支。大家上手体验建议使用front-end分支

下载方案1

如果可以访问，并且可以使用 git 的，可以在终端(CMD) 中使用 git clone 下载

Plain Text
git clone https://github.com/mannaandpoem/OpenManushttps://gitee.com/smyou/OpenManus.git #个人仓库，不需要魔法

下载方案2

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

下载方案3

国内镜像下载 zip 代码

Plain Text

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 config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple
# 安装依赖
pip install -r requirements.txt
# 过程可能有点久，耐心等待
# 这个过程如果有红色错误，请重新执行命令重试

运行环境

下载 miniconda, windows 安装包

下载链接: https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe

MacOS 和 Linux 用户访问 https://www.anaconda.com/docs/getting-started/miniconda/install 页面找到自己系统的安装包下载

可以一路默认安装下去

运行 conda , 点击开始菜单，找到 MiniConda Prompt 运行, 效果如下:

选择 Anaconda Prompt 或者 Anaconda PowerShell Prompt 均可

进入项目目录，比如我测试环境下载的目录是 C:\Users\vm\Documents\Downloads\OpenManus-main

python
cd C:\Users\vm\Documents\Downloads\OpenManus-main
# 回车如图所示

官方文档中使用

Bash
conda create -n open-manus python=3.12
# 创建新的环境
# 默认有个名称叫 base 的环境，我们也可以直接使用，跳过这一步 #
# 如果创建了 open-manus 这个环境需要激活，如下命令 , 如果就用 base 就不需要这一步了
conda activate open-manus

安装依赖

Bash
# 设置 pip 国内镜像
pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
# 备注，如果上面的清华源一直安装不了依赖，可以尝试下面的腾讯源命令执行，再安装依赖
# pip config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple
# 安装依赖
pip install -r requirements.txt
# 过程可能有点久，耐心等待
# 这个过程如果有红色错误，请重新执行命令重试

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

Bash
python main.py
# 效果如下

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

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

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

更新代码

如果是使用 git clone 的

python
# 除了修改 config.toml 之外没有修改本地文件直接使用
git pull origin main
# 更新代码
# 更新完成后安装一次依赖，确保新代码可以运行
pip install -r requirements.txt如果是下载 zip 包的，直接下载解压后，相同的文件覆盖即可

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

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

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

大多数 Key 只有在创建的时候让你复制一下，如果你忘记了重新创建一个即可!注意替换 API key 时候是 api_key = "sk-***" 中 sk-*** 整体替换，而不是替换 "sk-***" 后面 *** 部分

DeepSeek 官方

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

申请API

访问 https://platform.deepseek.com/api_keys 创建一个 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-..."

火山引擎

官方网站：

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

参与入口：火山方舟大模型体验中心-火山引擎邀请码：J5SDP9LS

访问火山方舟:https://console.volcengine.com/ark

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

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

# Global LLM configuration[llm]model = "doubao-1-5-pro-32k-250115"base_url = "https://ark.cn-beijing.volces.com/api/v3"api_key = "eff589d9"max_tokens = 8192temperature = 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-..."

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

硅基流动统一登录

或者下面的二维码

在 Api Key 页面申请密钥

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

配置# 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-..."

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

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

派欧算力云

在 “密钥管理” 页面申请 Key : https://ppinfra.com/settings/key-management

配置# 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-..."

在 OpenManus 中配置模型

在目录 config 下面复制 config.example.toml 一份改名为 config.toml ,用编辑器打开, 然后将上面某一个平台（同时只能一个平台）的模型配置替换即可!

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

最新版本需要 front-end 分支才是带 Web UI，可以下载对应分支的源码，或者使用 git 切换分支

python
git fetch
git checkout front-end
# 安装依赖
pip install -r requirements.txt
# 运行 web ui
python app.py
# 运行完成后正常会自动打开浏览器，如果没有打开，请访问 http://localhost:5172/

测试运行(命令行)

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

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

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

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

Bash
我是OpenManus，一个全能型AI助手，旨在解决用户提出的任何任务。我能够调用多种工具来高效完成复杂请求，包括执行Python代码、进行谷歌搜索、操作浏览器以及保存文件等。无论是编程、信息检索、文件处理还是网络浏览，我都能胜任。通过组合不同的工具，我可以处理各种任务，例如编写代码、保存文档、搜索信息或操作网页P

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

运行成功了，下一步就是去完成更加高级的任务使用 ollama 部署本地模型，然后在 OpenManus 中使用等欢迎一起交流，我会在后续推出相关内容出现问题不要怕，可以根据常见问题排查，也可以在群里问，群里问的时候把错误信息截图完整一些发出，同时把模型配置文件也发出，记得要把“key”修改掉或者打马赛克

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

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

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 搜索模块频率过高，目前没有很好的解决方法

Rate Limit exceeded.

硅基流动的 API 调用频率(TPM)限制达到了，需要停止 1分钟左右再继续

OpenManus 新手保姆教程- Docker部署（待更新。。。。）