MiniMax Agent工具参数填写方法

使用时必须在配置界面准确填写 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四个字段，缺一不可。

第三步：确保

符合JSON Schema v7规范——例如，字符串类型必须写为“string”，必填字段需要明确列在数组中，里的内嵌结构也不能遗漏声明。只要任意一层嵌套写错，就可能直接导致400错误。

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

API调用时动态传入tools参数

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

方法一：直接构造JSON body

在POST请求体中，除messages外，显式添加tools字段，值为合法数组，例如：

。

方法二：使用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不会被模型读取。

这一步操作起来很简单，直接把文件拖进去就行。但

。