必须在配置界面准确填写tools字段的JSON结构：一、网页端Agent创建时在「工具集」添加自定义工具并填入含type、function.name等四字段的合法JSON；二、API调用时在POST body中与messages同级传入tools数组；三、OpenClaw本地部署需在openclaw.json中为模型配置tools并重启gateway服务。

要在MiniMax Agent中正确启用联网搜索、代码执行或文档解析等工具能力，必须在配置界面准确填写tools字段的JSON结构，否则模型将无法识别可用工具或触发调用。

网页端Agent创建时填写tools参数

适用于通过Minimax控制台创建通用对话型Agent的场景，需在系统提示词下方手动填入结构化工具定义。

第一步：进入Agent配置页，在「工具集」区域点击「添加工具」→选择「自定义工具」。

第二步：在弹出的JSON编辑框中，粘贴标准格式的tools数组。每个tool对象必须包含type、function.name、function.description和function.parameters四个字段，缺一不可。

第三步：确保function.parameters符合JSON Schema v7规范——例如字符串类型必须写"string"，必填字段需列在required数组中，properties内嵌结构不能漏掉type声明。写错任意一层嵌套都会导致400错误。

第四步：点击「保存并发布」，此时Agent ID才正式绑定该tools配置。未发布的修改不会生效，且已发布的Agent无法直接编辑tools，只能新建版本。

API调用时动态传入tools参数

当需要为单次请求定制工具集（如临时启用PDF解析），可在HTTP POST body中与messages同级传入tools字段。

方法一：直接构造JSON body

在POST请求体中，除messages外，显式添加tools字段，值为合法数组，例如：【"tools": [{"type": "function", "function": {"name": "search_web", "description": "实时联网搜索最新信息", "parameters": {"type": "object", "properties": {"query": {"type": "string"}}, "required": ["query"]}}}]】。

方法二：使用curl命令行快速验证

执行以下命令（替换your_api_key和agent_id）：curl -X POST "https://api.minimax.chat/v1/text/chatcompletion" -H "Authorization: Bearer your_api_key" -H "Content-Type: application/json" -d '{"agent_id":"your_agent_id","messages":[{"role":"user","content":"查2026年8月中国新能源汽车销量排名"}],"tools":[{"type":"function","function":{"name":"search_web","description":"全网实时检索","parameters":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]}}}]}'。

注意：若返回{"error":{"code":"invalid_parameter","message":"tools must be an array"}}，说明JSON格式有误，常见原因是tools值不是数组、function缺失name字段或parameters里少了type声明。

OpenClaw本地部署时配置tools

适用于通过openclaw gateway自托管MiniMax模型的开发者，工具定义需写入配置文件并重启服务。

① 打开终端，执行nano ~/.openclaw/openclaw.json。

② 在对应provider的models数组中，找到目标模型（如abab6.5-chat），在其下添加tools字段，值为完整工具列表JSON数组。

③ 保存后执行openclaw gateway restart，使配置热加载生效。不重启则tools不会被模型读取。

这一步操作起来很简单，直接把文件拖进去就行。但【必须确认openclaw gateway进程已完全停止再启动，否则旧配置仍会缓存】。