在Mac上搭建本地ManusAI环境，其实并不复杂。核心思路是：跳过官方客户端，直接部署开源平替OpenManus，并让它与本地Ollama服务对接。这样一来，所有数据留在本地、模型可自由更换、行为逻辑也能深度修改，不再受限于云端服务或邀请码激活。下面一步步拆解，确保每一步都不踩坑。

确认系统与基础工具就绪

打开终端，依次执行三行命令，验证必备组件是否已正确安装——这一步看似基础，但很多问题出在这里。

• python3 --version → 必须返回 【Python 3.12.x】。如果显示3.11或3.13，后续pip install会报错，版本卡得比较死。
• git --version → 输出类似 git version 2.39.0 就算正常。macOS Monterey及以上系统默认不带git，需要手动安装（推荐从Xcode Command Line Tools或Homebrew装）。
• ollama list → 如果提示 command not found，说明Ollama未安装或PATH里找不到，得重装；如果返回空列表，说明服务正常，只是还没有拉模型。

⚠️特别注意：Python安装时必须勾选“Add Python to PATH”，否则python3命令不可用。这一条容易被忽略，但错过就得重新装一遍。

拉取并配置OpenManus项目

接下来执行以下操作链：

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

进入项目后，用VS Code或TextEdit打开 config/config.example.toml，复制全部内容，新建文件命名为 config/config.toml 并粘贴保存。注意文件名必须准确，大小写和路径都不能错。

编辑 config/config.toml，找到 [llm] 区块，把 base_url 改为 "http://localhost:11434"（这是Ollama的默认端口），model 填写你已拉取的本地模型名，例如 "qwen2:7b" 或 "deepseek-coder:6.7b"。

【缩进必须严格为两个空格，不能用Tab，否则toml解析失败】——这个细节值不少时间，配置时请格外留神。

创建隔离环境并安装依赖

提供两种方法，根据自己习惯选一个就好。

方法一：用conda（推荐，兼容性好）

• 第一步：conda create -n open_manus python=3.12
• 第二步：conda activate open_manus
• 第三步：pip install -r requirements.txt

方法二：用uv（轻量快速，国内镜像更稳）

• 先装uv：brew install uv（如果还没装Homebrew，先去装一下）
• 创建虚拟环境：uv venv
• 激活：source .venv/bin/activate
• 安装依赖：uv pip install -r requirements.txt

如果卡在某个包的下载上，可以在执行pip前先切换清华源：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

这招对国内用户特别管用，能省下不少等待时间。

启动服务并验证连通性

确保Ollama服务正在后台运行——终端执行 ollama serve 或者直接让它常驻后台。

然后在OpenManus项目根目录下，执行：

python app.py

等待终端输出类似 INFO: Uvicorn running on http://127.0.0.1:5172，说明服务启动成功。

打开Safari或Chrome，访问 http://localhost:5172。页面加载完成后，输入一句简单指令，比如「列出当前目录下的所有.py文件」，观察是否返回真实文件列表。如果能看到结果，说明本地模型调用通路已经打通，后续就可以愉快地玩耍了。

整个流程走下来，你会发现其实没有想象中复杂。关键是把基础工具装对、配置文件缩进搞准、依赖源设置好，然后就是耐心等待下载完成。祝顺利！