环境变量填错会导致后端启动失败、模型调用报错或智能体无法加载工具；必须严格按语义格式设置，path需包含manus安装目录，manus --version可验证全局生效，变量须操作系统级注入且全大写。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
ManusAI部署过程中环境变量填错会导致后端服务启动失败、模型调用报错或智能体无法加载工具，必须严格按语义和格式填写。
确认环境变量生效路径
打开终端，执行 echo $PATH，确认 Manus 安装目录（如 /opt/manus 或 C:\Users\YourName\.local\bin）已出现在输出中；若未出现，需重新配置系统 PATH 并重启终端——【不重启终端，后续所有操作均无效】。
在项目根目录下运行 manus --version，能正确返回版本号（如 v2.4.1），说明环境变量已全局生效。
设置核心运行时环境变量
ManusAI 不读取 .env 文件，所有变量必须通过操作系统级环境变量注入。
方法一：Linux/macOS 临时设置（仅当前终端有效）
执行：export MANUS_MODEL_PROVIDER=ollama && export MANUS_MODEL_NAME=qwen2.5:7b && export MANUS_BACKEND_URL=http://localhost:11434
方法二：Windows PowerShell 永久设置（推荐）
执行：$env:MANUS_MODEL_PROVIDER="ollama"; $env:MANUS_MODEL_NAME="qwen2.5:7b"; $env:MANUS_BACKEND_URL="http://localhost:11434"
⚠️ 注意：PowerShell 中的环境变量不会自动继承到新打开的 CMD 窗口，必须统一使用 PowerShell 启动服务。
方法三：写入系统级配置（Linux/macOS）
编辑 ~/.bashrc 或 ~/.zshrc，末尾追加：export MANUS_MODEL_PROVIDER=ollama; export MANUS_MODEL_NAME=qwen2.5:7b; export MANUS_BACKEND_URL=http://localhost:11434，然后执行 source ~/.zshrc 生效。
验证环境变量是否被Manus读取
第一步：进入 ManusAI 项目根目录
第二步：执行 manus run --debug
第三步：观察控制台输出中是否出现类似 [INFO] Loaded model provider: ollama (qwen2.5:7b) 的日志行
第四步：若出现 [WARN] Missing required env: MANUS_MODEL_PROVIDER，说明变量未被识别——此时不要继续启动，先检查变量名拼写、大小写、空格及引号是否全为英文字符。【MANUS_ 开头的变量名必须全大写，一个字母都不能小写】
