如果你希望 MiniMax Agent 中的智能体真正完成实际操作,而不只是返回解释性文字,就必须先做好工作流工具的显式配置。一旦没有开启对应工具权限,Agent 会将“搜索”“读文件”“发邮件”等指令仅视为普通文本内容理解,最终通常只会输出类似“我可以帮你搜索”这样的没有实际执行结果的回复。

要在MiniMax Agent中让智能体真正执行操作,而不是停留在文字回复层面,前提就是完成工作流工具的显式配置。若未启用相应工具权限,Agent会把“搜索”“读文件”“发邮件”等操作指令当成普通文本处理,最终只返回“我可以帮你搜索”这类看似能做、实则无法执行的无效响应。
网页端Agent中启用内置工具
第一步:登录MiniMax Agent控制台(https://agent.minimaxi.com),进入已经创建好的Agent编辑页面。
第二步:在左侧菜单栏点击「工具集」→ 找到「联网搜索」开关,并将其切换为开启状态;完成后系统会自动绑定M2.5-Search插件,无需你额外配置API密钥。
第三步:向下滚动到「自定义工具」区域,点击「添加工具」→ 选择「文件读取」→ 在弹窗中确认启用「本地上传文件解析」权限;【注意:该功能仅对桌面端Agent生效,网页端无法直接访问本地磁盘文件】。
第四步:勾选「飞书消息发送」工具 → 点击右侧「配置」按钮 → 按照页面提示完成飞书机器人授权流程;配置成功后,当Agent接收到“把结果发到飞书群”之类的指令时,就可以自动调用接口执行发送操作。
OpenClaw中注入第三方工具节点
OpenClaw支持把MiniMax的工具能力以插件形式接入工作流,适合需要条件判断、流程编排或串联多个步骤的复杂任务场景。
方法一:通过配置文件注入
1、打开项目根目录下的openclaw.config.json,在plugins字段中追加"file_io"和"web_search"两项;
2、在providers节下,确认model_provider设置为"minimax",并且model_name明确指定为"m2.5-search";
3、保存后执行openclaw start重启服务,新的工具节点会在图形化界面中显示为可拖拽模块,便于后续编排工作流。
方法二:运行时动态注册
在Python脚本中导入minimax.tools之后,调用register_tool("email_sender", EmailTool()),即可将自定义邮件工具动态注入当前工作流。这种方式更适合在调试或测试阶段快速验证逻辑是否正常,但通常不建议直接用于生产环境。
本地部署Agent调用MCP协议工具
如果使用Minimax-MCP本地项目(例如对接Claude Desktop或Cursor),那么工具调用通常依赖MCP(Model Communication Protocol)标准来实现。
第一步:确保MCP服务已经正常启动,终端执行mcp-server --port 3000后,应能看到"Listening on http://localhost:3000"日志输出。
第二步:在Agent配置中将tool_url设置为http://localhost:3000,而不是默认的云端地址;【关键:这里必须使用localhost,填写127.0.0.1会触发CORS拦截】。
第三步:在tools列表中声明所需工具名称,例如["image_gen", "code_exec"],这样Agent在初始化时会自动向MCP服务查询当前可用的能力清单。
第四步:触发工具调用时,Agent会生成符合MCP v0.3规范的tool_call JSON,其中包含tool_name、arguments以及call_id字段;MCP服务接收到请求后,再分发给对应插件进程执行。
