Manus AI部署卡在初始化阶段，主因是Python环境未隔离、pip源未切清华、模型不支持Function Calling或base_url路径错误；须用conda创建Python 3.10环境、清华源分步装依赖、选DeepSeek-V3等兼容模型并设base_url为/v1根路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Manus AI部署时卡在初始化阶段，常见表现为控制台反复输出“Initializing...”后停滞、Web界面白屏、或日志中停留在Certificate Management Service / vmdir / STS Lookup Service等组件启动环节——这并非模型加载慢，而是底层服务在主机名解析、证书校验或依赖链上遭遇阻断。
检查Python环境隔离是否真正生效
conda create -n open_manus python=3.10 → conda activate open_manus
这一步不能跳过，【系统自带Python或已存在的venv环境会污染依赖树，导致langchain与pydantic版本冲突无法回退】。尤其当机器上装过多个AI项目时，conda的环境隔离是唯一可靠方案。
验证是否激活成功：运行 python -c "import sys; print(sys.prefix)"，输出路径必须包含 /envs/open_manus/，否则后续所有安装均无效。
绕过pip源陷阱与分步攻坚依赖
方法一：直接用清华源pip安装（适合网络稳定者）
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
方法二：分步安装（推荐给屡次失败者）
先跳过依赖检查：pip install --no-deps -r requirements.txt
再单独装三个关键包：pip install pydantic==2.5.3 langchain==0.1.6 playwright==1.40.0
最后补全浏览器：playwright install chromium
注意：uv虽快但国内兼容性差，多次出现requirements.txt中某行被跳过的情况，不建议新手使用。
验证Function Calling模型配置是否合规
第一步：确认模型能力
DeepSeek-V3、Qwen-7B-Instruct、Ollama本地部署的phi-3:mini均通过实测，能正常触发browser_use、file_operation等工具；gpt-35-turbo在Azure上需开启函数调用开关，否则日志显示“Manus selected 0 tools to use”。
第二步：修改config.toml
填入API密钥后，必须显式设置：
model = "deepseek-v3"
base_url = "https://api.deepseek.com/v1"
temperature = 0.2
第三步：验证调用链
运行python main.py后，观察控制台是否输出“Using tool: browser_use”字样。若无，立即检查base_url末尾是否误加了/v1/chat/completions——【OpenManus只接受/v1根路径，多加路径会导致404且静默失败】。
排查ChromeDriver与Playwright匹配问题
① 运行 playwright show-trace 查看当前Chromium版本号
② 执行 playwright install-deps chromium 确保系统级依赖完整
③ 若仍报错“browser_type.launch: Executable doesn't exist”，手动下载对应版本chromium-linux.zip（注意不是win或mac版），解压后将路径写入config.toml：
browser_path = "/path/to/chromium/chrome"
这一步操作起来很简单，直接把文件拖进去就行。但若跳过①②直接硬编码路径，Playwright会因缺少沙箱权限或缺失libgbm.so而卡死在launch()调用处，且无明确错误提示。
