OpenManus-通过源码方式本地运行OpenManus，含踩坑及处理方案，chrome.exe位置修改

前言：最近 Manus 火得一塌糊涂啊，OpenManus 也一夜之间爆火，那么作为程序员应该来尝尝鲜

1、前期准备

• FastGithub：如果有科学上网且能正常访问 github 则不需要下载此软件，此软件是提供国内直接访问 github
• Git：通过 git 远程拉去 github 代码，当然也可以不用安装
• Anaconda 或者 Miniconda：python 依赖管理工具
• 科学上网：如果想去谷歌搜索，则需要支持访问 google.com，如果不需要，则配置访问路径为 百度，请往下看

2、进入 github 下载源码

点我进入OpenManus 仓库

阅读官方提供的文档：OpenManus 中文文档

2.1、下载源码

下载源码分两种方式：

• 第一种是安装了 Git 的，直接通过命令

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

• 第二种是直接下载 zip 包
  下载 ZIP 包直接点击

2.2、准备工作

• 创建 python 虚拟环境

# 创建虚拟环境
conda create -p D:\dev\py_repo\open_manus python=3.12
# 激活这个环境
conda activate open_manus

• 支持 function calling 的大模型 API key

这里推荐使用 阿里云百炼平台，百炼开通后180天内送一定额度的 token，基本上是属于免费级别的

获得 API-KEY

• 获取模型

每个模型都有相应的说明，注意看每个模型的注意事项描述，如果说明了不支持 Function calling 的模型，是无法使用到 OpenManus 中的

比如这个图片中，deepseek-r1 模型就不支持 Function calling

亲测有效的是 qwen-plus 模型，qwq-32b 也是支持的，不过我没亲测

3、使用 PyCharm 打开源码，并配置虚拟环境

这一步主要是为了阅读源码和启动源码，如果不需要阅读源码的可以直接跳过本步骤

• 配置解释器
  启动 PyCharm 打开源码，并配置刚刚设置的 open_manus conda 环境，我这里已经配置过了，没有配置过第一步显示的是 Add interpreter
  

• 选择虚拟环境
  
  选择好以后，点击 OK ，等待环境的初始化和加载，大概也就 10 来分钟左右

4、配置 OpenManus 环境

• 如果是 PyCharm 启动，则直接手动复制 /config/config.example.toml 将复制出来的文件名改为 config.toml 即可

# Global LLM configuration
[llm]
model = "qwen-plus"
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
api_key = "sk-.................................."
max_tokens = 4096
temperature = 0.0

model ：一定要是支持 function calling 的模型
base_url：百炼云平台的接口地址，只要是百炼的模型，接口地址几乎是相同的，不用修改
api_key：这个就是之前注册的 api-key，直接复制接口
其他的都不用修改

• 如果是通过 CMD 启动的，则使用命令复制文件，然后将正确的内容填写进去即可

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

5、依赖拉取

5.1、激活环境

PyCharm 打开 terminal 窗口，激活 conda 环境，注意这里一定要是在项目的根目录下才可以

conda activate open_manus

5.2、安装依赖

pip install -r .\requirements.txt

完整命令截图如下：

6、各种踩坑

6.1、不支持 function calling

不支持 tool call，选择支持 function calling 的模型

<400> InternalError.Algo.InvalidParameter: The tool call is not supported.

6.2、模型名字错误

检查模型的名字，是否拼写错误

'The model `xxxxxx` does not exist or you do not have access to it.'

6.3、google_search 无法调用

⚠️ Tool 'google_search' encountered a problem: HTTPSConnectionPool(host='www.google.com', port=443): Max retries exceeded with url: /search?q=Google+homepage&num=12&hl=en&start=0&safe=active (Caused by ConnectTimeoutError(<urllib3.connection.HTTPSConnection object at 0x0000020960CF1520>, 'Connection to www.google.com timed out. (connect timeout=5)'))

• 方式1：科学上网全局代理，或者切换稳定的谷歌代理站点
• 方式2：添加配置，有大佬提交了 pr，支持百度搜索

[llm]
model = "qwen-plus"
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
api_key = "sk-.................................."
max_tokens = 4096
temperature = 0.0# 添加此项代码，走百度搜索
search_agent_config = "baidu"

6.4、循环打印日志 playwright install

2025-03-10 22:07:44.834 | INFO     | app.agent.base:run:137 - Executing step 1/30
2025-03-10 22:07:48.030 | INFO     | app.agent.toolcall:think:53 - ✨ Manus's thoughts: 
2025-03-10 22:07:48.030 | INFO     | app.agent.toolcall:think:54 - 🛠️ Manus selected 1 tools to use
2025-03-10 22:07:48.031 | INFO     | app.agent.toolcall:think:58 - 🧰 Tools being prepared: ['browser_use']
2025-03-10 22:07:48.031 | INFO     | app.agent.toolcall:execute_tool:140 - 🔧 Activating tool: 'browser_use'...
ERROR    [browser] Failed to initialize Playwright browser: BrowserType.launch: Executable doesn't exist at C:\Users\admin\AppData\Local\ms-playwright\chromium-1148\chrome-win\chrome.exe
╔════════════════════════════════════════════════════════════╗
║ Looks like Playwright was just installed or updated.       ║
║ Please run the following command to download new browsers: ║
║                                                            ║
║     playwright install                                     ║
║                                                            ║
║ <3 Playwright Team                                         ║
╚════════════════════════════════════════════════════════════╝
2025-03-10 22:07:48.464 | INFO     | app.agent.toolcall:act:113 - 🎯 Tool 'browser_use' completed its mission! Result: Observed output of cmd `browser_use` executed:
Error: Browser action 'navigate' failed: BrowserType.launch: Executable doesn't exist at C:\Users\admin\AppData\Local\ms-playwright\chromium-1148\chrome-win\chrome.exe
╔════════════════════════════════════════════════════════════╗
║ Looks like Playwright was just installed or updated.       ║
║ Please run the following command to download new browsers: ║
║                                                            ║
║     playwright install                                     ║
║                                                            ║
║ <3 Playwright Team                                         ║
╚════════════════════════════════════════════════════════════╝
2025-03-10 22:07:48.476 | INFO     | app.agent.base:run:137 - Executing step 2/30

首先这个问题是缺少了浏览器，那么需要先下载浏览器组件

python -m playwright install chromiumpip install playwright

安装不上，那么就暴力安装

• 下载 chromium

下载地址：https://playwright-verizon.azureedge.net/builds/chromium/1148/chromium-win64.zip

• 解压后放入指定目录

根据错误日志可以看到，程序去这个路径下面寻找 Browser action 'navigate' failed: BrowserType.launch: Executable doesn't exist at C:\Users\admin\AppData\Local\ms-playwright\chromium-1148\chrome-win\chrome.exe，那么就直接把浏览器复制到这个路径下即可

6.5、其他踩坑

如果你遇到了其他坑，就去这里面搜索问题：

https://github.com/mannaandpoem/OpenManus/issues

总能找到问题的解决办法

7、补充

2025-03-11补充

deepseek-r1 模型均不可用

deepseek-r1 不管是阿里云百炼平台，还是 deepseek 官网，都是不支持 Function calling 的，亲测结果

deepseek官网唯一支持 Function calling 的模型 deepseek-chat 在官方的描述如下：

deepseek-chat 模型亲测有效：

提示词：搜索整理昨天的所有AI相关的最新咨询，整理成markdown文件，文件名为：news_ai

经过漫长的等待，最终得到了如下的结果：超时了

修改 chrome.exe 位置

修改位置需要修改源代码，有三处地方需要修改

• /app/config.py 文件

第四行代码和第 26 行代码修改

from typing import Dict, Optional  # ,Optional 为添加项class LLMSettings(BaseModel):model: str = Field(..., description="Model name")base_url: str = Field(..., description="API base URL")api_key: str = Field(..., description="API key")max_tokens: int = Field(4096, description="Maximum number of tokens per request")temperature: float = Field(1.0, description="Sampling temperature")api_type: str = Field(..., description="AzureOpenai or Openai")api_version: str = Field(..., description="Azure Openai version if AzureOpenai")chrome_instance_path: Optional[str] = Field(None, description="Local Chrome installation path") # 为添加项

• browser_use_tool.py 修改

将 _ensure_browser_initialized 函数替换为如下代码

    async def _ensure_browser_initialized(self) -> BrowserContext:"""Ensure browser and context are initialized."""if self.browser is None:# 舍弃本句代码# self.browser = BrowserUseBrowser(BrowserConfig(headless=False))# 新增如下代码llm_config = config.llm['default']chrome_instance_path = llm_config.chrome_instance_pathprint(chrome_instance_path)self.browser = BrowserUseBrowser(BrowserConfig(headless=False, chrome_instance_path=chrome_instance_path))if self.context is None:self.context = await self.browser.new_context()self.dom_service = DomService(await self.context.get_current_page())return self.context

• config.toml 新增配置项

[llm]
model = "qwen-plus"
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
api_key = "sk-xxxxxx"
chrome_instance_path = "D:\\software\\chrome-win\\chrome.exe"   # 此项为新增配置项
max_tokens = 4096
temperature = 0.0

亲测有效