minimax agent调用外部工具需同时启用工具权限、绑定插件并匹配调用格式。网页端需在agent.minimaxi.com开启“联网搜索”开关；openclaw需docker配置或手动注册web_search.py并声明tools；mmx-cli需安装授权后带--quiet参数调用；api直连须在请求体中完整配置tools字段及tool_choice:"auto"。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让MiniMax Agent自动调用搜索、代码执行、文件解析等外部工具，却始终返回“未找到可用工具”或直接忽略指令？问题往往出在工具权限未启用、插件未绑定或调用格式不匹配——三者缺一不可。
网页端Agent开启联网搜索插件
该方式适用于无需开发介入、仅需快速验证实时信息获取能力的场景，依赖MiniMax原生M2.5-Search模型，响应快且信源可信。
1、访问 https://agent.minimaxi.com，使用已完成实名认证的账号登录。
2、点击右上角齿轮图标 → 进入“Agent设置” → 切换至“工具权限”页签。
3、找到“联网搜索”开关，将其【切换为开启状态】。注意：此开关默认关闭，且无二次确认弹窗，误关后工具将完全失效。
4、返回对话界面，输入含时效性关键词的问题，例如：“截至2026年8月10日，华为Mate70系列预热发布会官宣了哪些核心参数？”系统将自动触发M2.5-Search执行全网检索并返回结构化结果。
OpenClaw中集成M2.5-Search工具链
适用于开发者自建Agent环境，需通过配置文件注入模型能力与API凭证，支持多跳检索与结果聚合。
方法一：Docker容器化部署接入
1、在阿里云ECS或本地Linux/macOS主机运行：docker run -d --name openclaw -p 8080:8080 -e MINIMAX_API_KEY=sk-xxx minimax/openclaw:latest。
2、编辑容器内/app/config.yaml，将model_provider设为minimax，model_name指定为m2.5-search。
3、确保env变量MINIMAX_API_KEY已注入容器，且该密钥在Minimax控制台中具备search接口调用权限。
方法二：手动注册工具函数（适配非标准插件）
在OpenClaw的tools/目录下新建web_search.py，定义函数签名必须包含query: str参数，并返回dict类型结果；函数体内部调用requests.post("https://api.minimaxi.com/v1/search", json={"query": query}, headers={"Authorization": f"Bearer {os.getenv('MINIMAX_API_KEY')}"})。
【关键校验点】：函数注册后需在agent_config.json中显式声明"tools": ["web_search"]，否则OpenClaw启动时不会加载该工具。
通过MMX-CLI命令行调用多模态工具
MMX-CLI专为Agent自动化设计，屏蔽HTTP细节，输出纯净JSON，适合ClaudeCode、OpenClaw等框架直接解析。
第一步：安装与授权
执行curl -fsSL https://get.mmx.minimaxi.com | sh完成安装；随后运行mmx auth login --api-key sk-xxx绑定凭证。
第二步：发起搜索任务
输入命令：mmx search --query "2026年8月中国新能源汽车销量TOP5品牌" --output json --quiet。
第三步：解析结果
命令执行后stdout仅输出标准JSON，例如{"results":[{"title":"乘联会8月报告","url":"https://...","snippet":"比亚迪、特斯拉、理想位列前三..."}]}，Agent可直接json.loads()消费。
注意：若省略--quiet，进度条和彩色字符会混入stdout，导致Agent解析失败。
API直连方式配置工具调用
适用于自有系统深度集成，需在请求体中显式声明工具列表与调用约束，否则服务器默认禁用所有工具。
1、构造POST请求至https://api.minimax.chat/v1/text/chatcompletion。
2、Header中必须包含：Authorization: Bearer sk-xxx与Content-Type: application/json。
3、Body中messages数组末尾添加一条用户消息，内容为含工具意图的自然语言指令，例如：“请搜索2026年8月最新发布的Python 3.13特性说明。”
4、在Body顶层添加"tools": [{"type": "function", "function": {"name": "web_search", "description": "执行全网实时搜索", "parameters": {"type": "object", "properties": {"query": {"type": "string"}}}}}]字段。
5、添加"tool_choice": "auto"——【不可省略】，否则即使配置了tools字段，服务端也不会触发工具调用逻辑。
