MiniMax Agent工具配置方法

MiniMax Agent在创建阶段就得把工具权限绑定好，等发布出去之后，这部分就不能再改了；网页端这边，需要勾选“联网搜索”，同时确认Coding Plan已经开通；OpenClaw则要提前配置好web_search插件和m2.5-search模型；至于CLI工具，还得先完成安装、配置API密钥，再集成到IDEA里。

想让MiniMax Agent真正调用搜索、计算、文件解析等外部能力，却只返回“我无法执行该操作”或直接忽略指令，说明工具配置环节存在断点。必须在Agent实例创建时就完成工具声明与权限绑定，而非后期补加。

网页端创建Agent时启用联网搜索插件

这一步必须在发布前完成，发布后无法再添加工具，只能重建Agent。

访问 https://www.php.cn/link/38c754fbd23954a232a7f84019ba8092 → 登录已实名认证账号 → 点击左上角「创建Agent」→ 选择「通用对话型」模板。

在「工具权限」区域勾选「联网搜索」，系统将自动关联M2.5-Search模型；若未显示该选项，请确认当前Group已开通Coding Plan并启用M2.5系列模型。

填写系统提示词，例如：“你可实时联网检索最新信息，所有回答必须基于2026年8月后的数据源。” → 点击「保存并发布」。

发布后工具列表不可编辑，删改需重新创建Agent并迁移ID与Token。

通过OpenClaw框架注入Minimax搜索插件

适用于需串联搜索→摘要→生成报告的多步任务，或需对搜索结果做条件过滤的场景。

确保OpenClaw服务已运行（pnpm run dev），且Redis处于监听状态（redis-cli ping 返回 PONG）。

编辑项目根目录下的 openclaw.config.json，在 plugins 数组中追加 "web_search" 字符串；若该字段不存在，请新建。

在 providers 节点下，将 model_provider 设为 "minimax"，model_name 显式指定为 "m2.5-search"；注意不是 abab6.5s-chat 或其他通用模型。

执行 openclaw start 重启服务，控制台输出含 Loaded plugin: web_search 即表示加载成功。

本地CLI工具配置Mini-Agent ACP服务

适合IDEA、VS Code等开发工具深度集成，让代码编辑器直接调用Minimax工具链。

第一步：安装Mini-Agent命令行工具
执行 uv tool install git+https://github.com/MiniMax-AI/Mini-Agent.git；安装完成后运行 mini-agent --version 验证。

第二步：运行配置脚本
Windows用户执行PowerShell命令：
$r=Invoke-WebRequest -Uri "https://raw.githubusercontent.com/MiniMax-AI/Mini-Agent/main/scripts/setup-config.ps1" -UseBasicParsing; [IO.File]::WriteAllText("$env:TEMPsetup-config.ps1", $r.Content, (New-Object Text.UTF8Encoding $true)); powershell -ExecutionPolicy Bypass -File "$env:TEMPsetup-config.ps1"

第三步：填入API密钥
打开 ~/.mini-agent/config/config.yaml，将 api_key 替换为真实Key，api_base 保持 https://api.minimaxi.com（国内版），model 设为 MiniMax-M2.7。

第四步：在IDEA里接入自定义 ACP 服务
打开 Settings → Tools → MCP → Add Custom Server，在 Command 一栏填写 你的用户目录.localinmini-agent-acp.exe（如果是 Windows 路径，记得使用双反斜杠或正斜杠），保存配置后，再重启 IDEA 即可。