新手保姆教程 手把手带体验OpenManus

一. 背景知识

3 月 7 日，国内 DeepWisdom MetaGPT 团队 3 小时内上线初版本openManus。

openManus是Manus的开源复刻版。

在Manus还没能大规模开放之前，我们可以先本地部署openManus并一睹为快。

项目地址：

阅读对象

1新手用户

1使用国内的模型

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

1操作系统面向 Windows 10 / 11

教程目标

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

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

1了解一些 OpenManus 的基本原理

系统架构

二、模块设计

2.1 TODO1:安装部署

部署环境准备

方式一：使用 conda

1创建新的 conda 环境：

代码语言：txt复制

bash                  
# 第一步：创建专属AI空间                  
conda create -n open_manus python=3.12                  
conda activate open_manus                  
                    
                    
# To activate this environment, use                  
#                  
#     $ conda activate open_manus                  
#                  
# To deactivate an active environment, use                  
#                  
#     $ conda deactivate                  
                    
//conda activate mofa                  
# 第二步：克隆开源库                  
# 分支说明：                  
# main: 仅保留核心代码，是一个极简框架，可以比较容易兼容到其它场景                  
# front-end：加入了前端代码，可以有运行界面展示，大家玩的时候可以拉这个                  
# mcp: 基于mcp协议的openmanus在这个分支。                  
git clone git@github:watchpoints/OpenManus.git                  
cd OpenManus                  
                    
# 切换分支                  
# 1. 查看远程分支                  
# git branch -r                  
# 2. 切换 front-end 分支                  
# git checkout -b front-end origin/front-end                  
pip config set global.index-url                   
                    
# 备注， 如果上面的清华源 一直安装不了依赖，可以尝试下面的腾讯源命令执行，再安装依赖                  
# pip config set global.index-url                   
                    
# 安装依赖                              
pip install -r requirements.txt                  
# 过程可能有点久，耐心等待                  
# 这个过程如果有红色错误，请重新执行命令重试                  
# 安装 playwright                  
pip install playwright                  
playwright install  

配置大模型

OpenManus 需要配置使用的 LLM API，请按以下步骤设置：

1在 config 目录创建 config.toml 文件

cp config/config.example.toml config/config.toml

1编辑 config/config.toml 添加 API 密钥和自定义设置：

DeepSeek 官方1

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

申请API

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

[llm] model = "deepseek-chat" base_url = "; api_key = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx" max_tokens = 8192 temperature = 0.0

硅基流动

例子：白嫖党可选申请一个，

每天100万token测试的话是够了

全局 LLM 配置

代码语言：txt复制

python                  
# 全局 LLM 配置                  
[llm]                  
model = "Qwen/QwQ-32B"                  
base_url = ";                  
api_key = "sk-yerbwxyadeiwumvzbfdwawdzsvaouusksbkcrjlibdwrfjmt"  # 替换为真实 API 密钥                  
max_tokens = 4096                  
temperature = 0.0                  
                    
# 可选特定 LLM 模型配置                  
[llm.vision]                  
model = "gpt-4o"                  
base_url = ";                  
api_key = "sk-..."  # 替换为真实 API 密钥

快速启动

一行命令运行 OpenManus：

python main.py

然后通过终端输入你的创意！

如需体验不稳定的开发版本，可运行：

python run_flow.py

浏览器版本运行：（我们体验的话是用了一个简易的前端版本）

1

python app.py

2.2 Todo2 OpenManusWeb

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

代码语言：txt复制

python                  
git拉取fork远程分支代码                  
                    
git remote add upstream .git                  
                    
git checkout -b front-end upstream/front-end                  
# 安装依赖                  
pip install -r  requirements.txt                  
                    
# 运行 web ui                  
python app.py                  
                    
# 运行完成后正常会自动打开浏览器，如果没有打开，请访问 http://localhost:5172/

或者执行下载【下面这个方式执行不过放弃了，不过他们文档设计思路可以借鉴，就是他们基础架构】

.md

.md

代码语言：txt复制

PowerShell                  
                  
git clone git@github:wangcy6/OpenManusWeb.git                  
pip install -r requirements.txt                  
                     
                     
   //Web Interface                  
python web_run.py                  
                    
                    
http://127.0.0.1:8000/

三、FQA

3.1 我是用window11+wsl2方式启动 在通过web浏览器访问出现

gio: http://localhost:8000: Operation not supported

本人Windows 11 家庭中文版系统从Microsoft Store中安装Ubuntu系统

WSL2的镜像网络模式：带来更流畅的Linux开发体验

不停的重试

3.2 在centos服务器能执行吗？

1我在window +wsl2尝试一下 查询很慢 没有返回结果

1

3.3 如何通过trae远程编码远程访问 【】

如何Ttace 通过SSH 访问 window11 WSL2

问题描述：

本人Windows 11 家庭中文版系统从Microsoft Store中安装Ubuntu系统

WSL2的镜像网络模式：

安装 程序下面错误

初步定位：

ping 192.168.3.26 ip没有问题

telnet 192.168.3.26 22

正在连接192.168.3.26...无法打开到主机的连接。 在端口 22: 连接失败

解决步骤：

1Win11将WSL做SSH服务器，实现通过局域网SSH远程连接到WSL

代码语言：txt复制

PowerShell                  
sudo apt install openssh-server                  
                    
sudo vim/etc/ssh/sshd_config                  
取消注释 #Port 22 行以指定SSH端口（默认为22）。                  
取消注释 #PasswordAuthentication yes 行以允许密码认证。                  
                    
# 启动ssh密钥登录                  
RSAAuthentication yes                  
PubkeyAuthentication yes                  
                    
sudo service ssh start        

1Mirror模式下WSL2的SSH远程连接

WSL2 环境信息：

首先，在C://User//.wslconfig文件中，通过以下方式进行设置就会得到镜像模式的WSL。

代码语言：txt复制

Plain Text                  
[wsl2]                  
networkingMode=mirrored                  
[experimental]                  
hostAddressLoopback=false

点击图片可查看完整电子表格

如果不开启hostAddressLoopback 则无法在镜像模式下从外部访问到wsl。包括在windows WSL主机中，也同样无法依靠访问到wsl。但是如果将修改为`localhost`则可行。

优势

1IPv6 支持

1使用 localhost 地址 127.0.0.1 从 Linux 内部连接到 Windows 服务器。

1不支持 IPv6 localhost 地址 ::1

1改进了 VPN 的网络兼容性

1多播支持

1直接从局域网 (LAN) 连接到 WSL

通过localhost可以直接访问

设置 SSH 通过密钥登录

cd .ssh

touch authorized_keys

chmod 600 authorized_keys

window测试连接wsl2通过

ssh money@127.0.0.1 //连接到window11 安装的 wsl主机 Ubuntu 20.04+

结果： trae配置

代码语言：txt复制

PowerShell                  
Host 127.0.0.1                  
  HostName 127.0.0.1                  
  User money                  
  ForwardAgent yes   

[experimental] hostAddressLoopback=true

参考资料

1OpenManus 新手保姆教程 - 初级入门

本文参与 腾讯云自媒体同步曝光计划，分享自微信公众号。原始发表：2025-03-23，如有侵权请联系 cloudcommunity@tencent 删除模型配置教程镜像连接