需先确认系统版本达标（macos≥12.0或windows≥22h2），再安装桌面客户端并配置minimax cn api key与sorftime mcp服务，最后设置专属工作文件夹以保障任务全流程稳定执行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让MiniMax Agent自动完成从查资料、写报告到生成图表的整套工作，但每次任务都卡在环境配置环节，不是API密钥失效就是MCP服务连不上。
确认本地运行环境是否达标
打开终端，依次执行以下命令检查基础条件：
macOS用户运行：sw_vers | grep "ProductVersion" → 确保输出版本号 ≥ 12.0（即Monterey）；Windows用户按Win+R输入winver → 弹窗中显示版本 ≥ 22H2。
若不满足，桌面端将无法调用系统级能力（如文件读写、截图、剪贴板），Agent会静默跳过关键步骤而不报错。
安装并启动MiniMax Agent桌面客户端
访问 https://www.php.cn/link/8e658a7376fbef31c3bb99e4dc2c7d6d → 滚动到底部「产品」栏 → 点击「桌面端」→ 下载对应系统的安装包（.exe 或 .dmg）。
macOS安装时若提示“无法验证开发者”，需前往「系统设置 → 隐私与安全性 → 仍要打开」手动放行；Windows安装后检查程序属性里的数字签名是否为「上海稀宇科技有限公司」。
安装完成后双击启动，首次运行会自动弹出初始化向导。
配置MiniMax CN API Key（国内用户必选）
方法一：交互式配置（推荐新手）
在终端中执行：hermes AI写代码bash → 按向导提示选择「minimax-cn」提供商 → 粘贴从 https://www.php.cn/link/e3c216d521607da146fa23d65cfcc6b6「API Key」页面复制的密钥（以sk-开头）。
方法二：命令行直写（适合脚本化部署）
hermes config set MINIMAX_CN_API_KEY sk-xxxxxxxxxxxxxxxxxxxxxxxx
hermes config set provider minimax-cn
【必须执行第二条，否则默认走海外端点，国内网络下请求必然超时】
绑定Sorftime MCP服务（图文视频任务必需）
第一步：打开MiniMax Agent桌面端 → 点击右上角齿轮图标 → 进入「MCP管理」
第二步：点击「+ 自定义」→ 名称填「Sorftime MCP」→ 在「注册链接」栏粘贴你从Sorftime后台获取的完整Webhook URL（含?token=参数）
第三步：点击「确认」→ 等待右下角弹出绿色提示「连接成功」
注意：URL中若含空格或中文字符，需先用浏览器地址栏自动编码再粘贴，否则连接会显示成功但实际调用失败。
设置专属工作文件夹（防交付物丢失）
在Agent主界面左下角找到「工作文件夹」设置项 → 点击右侧文件夹图标 → 选择一个**空的新建文件夹**（例如~/Documents/MiniMax-Projects）。
Agent所有任务产生的中间文件、最终报告、图片、视频都会存入此目录，不会污染你的桌面或下载文件夹。
这一步不做，后续生成的PDF报告可能直接写进/tmp被系统定时清理。
