OpenManus本地ollama部署教程及常见问题解决

很多用户在尝试通过本地 Ollama 部署 OpenManus 时，常常在相同环节遇到阻碍。实际上流程并不复杂，但有几个关键细节容易被忽视。本文将完整梳理操作步骤与常见陷阱，配合视频学习效果更佳。

首先进行环境搭建。conda 部分建议直接参照官方中文 Readme（https://github.com/mannaandpoem/OpenManus/blob/main/README_zh.md）操作，切勿跳过文档直接上手，否则后续报错将难以定位来源。

完成 conda 环境配置后，接下来需要拉取 Ollama 模型。由于我的机器之前调整过参数，需单独配置并行处理及多模型启动，具体命令如下：

set OLLAMA_NUM_PARALLEL=
set OLLAMA_MAX_LOADED_MODELS=

这两行可根据实际需求配置，不设置也能正常运行。然后拉取模型——语言模型我选用 qwen2.5:7b，视觉模型选用 lla va。注意：语言模型必须支持 tools 调用（即能运行 function call），Ollama 官方文档中提供了支持列表：https://ollama.com/search?c=tools

ollama run qwen2.5:7b
ollama run lla va

首次拉取模型因需从网络下载到本地，耗时较长。当命令行出现 "Send a message" 提示，即表明模型已成功启动。若之前未修改过配置，默认端口为本地 11434。

模型运行起来后，开始修改 OpenManus 的配置文件。填入模型名称和 base_url——若未改动默认设置，url 即为 http://127.0.0.1:11434/v1，api_key 任意填写一个非空字符串即可。保存配置后启动 OpenManus。我习惯在项目文件夹根目录下执行：

python main.py

若需在其他路径启动，请使用完整路径，例如：

python xxx/xxx/main.py

至此基本可以顺利运行。

下面集中解答几个高频踩坑点：

1. 为什么在其他地方配置好的模型，到了 OpenManus 就不行？
答：请先确认其他地方是否使用了 OpenAI 兼容接口——如果不是，那么无法正常运行才是正常的。OpenManus 默认调用 OpenAI 兼容接口，当然新版也已加入 Azure 接口的支持。

2. 启动后输入对话报错，提示模型不支持 tools？
答：无论你调用的模型来自硅基、DeepSeek、OpenAI、Ollama 还是其他服务商，它们的官方文档中都明确标注了哪些模型支持 tools。各服务商列表不同，请自行查阅。

3. 保存文件失败？
答：当前项目尚不稳定，建议等待官方优化后再试。

4. 任务完成后停不下来，一直循环？
答：使用 Ctrl + C 强制终止。原因是模型未调用终止 tool，这属于项目不稳定的表现，等待官方修复即可。

5. Ollama 没有 API 吧？
答：如果没有 API，那我是如何跑起来的？这个问题仍有人在反复质疑。

6. 调用的 Google Search 没有网络或连不上？
答：要么切换为 Bing 搜索，要么等待官方后续修改。

7. 技术基础不够或不会看文档？
答：建议直接放弃，或者等待懒人包发布后再尝试，不必跟自己过不去。

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：OpenManus本地ollama部署教程及常见问题解决要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题