新手保姆教程手把手带体验OpenManus一. 背景知识 3 月 7 日，国内 DeepWisdom MetaGPT

一. 背景知识

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

openManus是Manus的开源复刻版。

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

项目地址：github.com/mannaandpoe…

github.com/mannaandpoe…

阅读对象

新手用户
使用国内的模型
可能解决不了魔法网络问题
操作系统面向 Windows 10 / 11

教程目标

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

系统架构

二、模块设计

2.1 TODO1:安装部署

部署环境准备

方式一：使用 conda

创建新的 conda 环境：

# 第一步：创建专属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.com: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 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
# 过程可能有点久，耐心等待
# 这个过程如果有红色错误，请重新执行命令重试
# 安装 playwright
pip install playwright
playwright install

配置大模型

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

在 config 目录创建 config.toml 文件

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

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

DeepSeek 官方1

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

申请API

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

[llm] model = "deepseek-chat" base_url = "api.deepseek.com/v1" api_key = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx" max_tokens = 8192 temperature = 0.0

硅基流动

例子：白嫖党可选（去cloud.siliconflow.cn/account/ak ）申请一个，

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

全局 LLM 配置

# 全局 LLM 配置
[llm]
model = "Qwen/QwQ-32B"
base_url = "https://api.siliconflow.cn/v1"
api_key = "sk-yerbwxyadeiwumvzbfdwawdzsvaouusksbkcrjlibdwrfjmt"  # 替换为真实 API 密钥
max_tokens = 4096
temperature = 0.0

# 可选特定 LLM 模型配置
[llm.vision]
model = "gpt-4o"
base_url = "https://api.openai.com/v1"
api_key = "sk-..."  # 替换为真实 API 密钥

快速启动

一行命令运行 OpenManus：

python main.py

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

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

python run_flow.py

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

python app.py

2.2 Todo2 OpenManusWeb

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

git拉取fork远程分支代码

git remote add upstream https://github.com/mannaandpoem/OpenManus.git

git checkout -b front-end upstream/front-end
# 安装依赖
pip install -r  requirements.txt

# 运行 web ui
python app.py

# 运行完成后正常会自动打开浏览器，如果没有打开，请访问 http://localhost:5172/

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

github.com/YunQiAI/Ope…


git clone git@github.com: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服务器能执行吗？

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

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

docs.trae.ai/docs/ssh-re…

如何Ttace 通过SSH 访问 window11 WSL2

问题描述：

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

WSL2的镜像网络模式：

安装docs.trae.ai/docs/ssh-re… 程序下面错误

初步定位：

ping 192.168.3.26 ip没有问题

telnet 192.168.3.26 22

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

解决步骤：

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

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

Mirror模式下WSL2的SSH远程连接

WSL2 环境信息：

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

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

hostAddressLoopback**	布尔	FALSE	仅当 wsl2.networkingMode 设置为 mirrored 时才适用。如果设置为 True，将会允许容器通过分配给主机的 IP 地址连接到主机，或允许主机通过此方式连接到容器。始终可以使用 127.0.0.1 环回地址，此选项也允许使用所有额外分配的本地 IP 地址。仅支持分配给主机的 IPv4 地址。

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

优势

IPv6 支持
使用 localhost 地址 127.0.0.1 从 Linux 内部连接到 Windows 服务器。
不支持 IPv6 localhost 地址 ::1
改进了 VPN 的网络兼容性
多播支持
直接从局域网 (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配置

Host 127.0.0.1
  HostName 127.0.0.1
  User money
  ForwardAgent yes

[experimental] hostAddressLoopback=true

参考资料

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

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