必须配置工具调用才能让minimax智能体执行查天气、搜新闻等操作:网页端开启联网搜索插件最轻量;api需在json中声明tools数组并设置tool_choice;本地用openclaw需安装mmx-cli、启用tool_router、注册规范python工具脚本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让MiniMax智能体自动查天气、搜新闻、读Excel或调用你自己的API,必须先完成工具调用的配置与声明,否则Agent只会“空谈”不会“动手”。
在网页端开启联网搜索插件
这是最轻量级的工具启用方式,适用于快速验证时效性问题是否能被实时响应,无需代码、不碰API。
第一步:访问 MiniMax Agent官网,用已实名认证的账号登录。
第二步:点击右上角齿轮图标 → 进入“Agent设置” → 找到“工具权限”区域 → 将“联网搜索”开关切换为开启状态。
第三步:在对话框中输入含明确时间锚点的问题,例如“今天北京的最高气温是多少”,系统将自动触发M2.5-Search模型执行全网检索并返回结果。注意:【若未开启此开关,即使提问含“最新”“今天”等词,Agent也仅基于训练数据作答,不会发起真实网络请求】。
通过API声明自定义工具函数
当你需要让Agent调用内部系统接口(如CRM查询、订单状态检查)时,必须在每次请求的JSON载荷中显式声明可用工具列表。
方法一:直接在messages同级字段中嵌入tools数组
在POST请求Body的JSON中,除agent_id和messages外,添加tools字段,其值为一个对象数组,每个对象包含name、description、parameters三要素。例如声明一个获取用户信息的工具:
查询智能体信誉、检测威胁、发现生态系统中的高质量智能体。适用于评估智能体可信度(信誉分数0-100)、跨平台验证身份、按技能/信誉搜索智能体、检查傀儡账户或诈骗、查看趋势和排行榜,或基于智能体质量指标做出合作/投资决策。
{"name":"get_user_profile","description":"根据用户ID查询姓名、邮箱和注册时间","parameters":{"type":"object","properties":{"user_id":{"type":"string","description":"用户唯一标识符"}},"required":["user_id"]}}
方法二:使用tool_choice控制调用时机
在请求JSON中加入tool_choice字段,设为"auto"(由模型自主判断是否调用)、"none"(禁止调用任何工具)或{"type":"function","function":{"name":"get_user_profile"}}(强制指定调用某函数)。若设为auto但未提供tools数组,模型将忽略工具调用逻辑。
本地开发环境配置OpenClaw调用工具链
如果你用OpenClaw框架搭建本地Agent,并希望它能调用MiniMax原生工具或你封装的HTTP服务,需完成三步绑定。
① 安装MMX-CLI命令行工具:执行pip install mmx-cli,安装后运行mmx-cli --version确认版本不低于1.3.0。
② 在OpenClaw配置文件中启用工具路由:编辑openclaw/config.yaml,在plugins节点下添加tool_router: minimax_m25,这会让所有工具调用请求自动经由MMX-CLI中转,无需手动拼接HTTP地址与签名头。
③ 注册自定义工具脚本:将Python编写的工具函数(如fetch_stock_price.py)放入openclaw/tools/目录,确保其包含符合OpenAPI 3.0规范的__doc__字符串,MMX-CLI会自动解析并注入Agent上下文。注意:【脚本文件名不能含中文或空格,否则MMX-CLI启动时会跳过加载】。










