MiniMax Agent需手动开启工具开关并明确指令才能调用内置或自定义工具：网页端须在“工具权限”中启用联网搜索等开关，OpenClaw需配置yaml、编写Python函数并重启服务，提示词须清晰声明工具意图且单条指令仅绑定一个工具。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在MiniMax Agent网页端启用内置工具
想让智能体自动查天气、搜资料、算日期或调用计算器，必须先在网页端打开对应工具开关，否则所有含工具意图的提问都会被忽略或返回“暂不支持”。
第一步：访问 https://www.php.cn/link/38c754fbd23954a232a7f84019ba8092，使用已实名认证的账号登录。
第二步：点击右上角齿轮图标→进入“Agent设置”→切换到“工具权限”标签页。
第三步：找到“联网搜索”“日期计算”“单位换算”等开关，按需开启。其中【M2.5-Search必须手动开启才能响应时效性问题】，关闭状态下即使提问“今天北京气温多少度”也不会触发搜索。
第四步：关闭设置面板，直接在对话框输入测试指令，例如“2026年8月13日是星期几”，系统将自动调用日期工具并返回结果。
通过OpenClaw配置自定义工具链
如果你在本地部署OpenClaw并希望接入企业内部API、数据库或私有模型，就得手动编写工具描述并注册进框架。这一步跳过会导致Agent始终无法识别你的私有服务。
方法一：在config.yaml中声明工具
打开OpenClaw项目根目录下的config.yaml，在tools字段下添加如下结构：
```yaml
tools:
- name: "hr_api"
description: "查询员工在职状态和部门归属，输入工号，返回JSON格式信息"
parameters:
id: {"type": "string", "description": "员工工号，6位数字"}
帮助用户满足已验证的需求：代理用户在Clawhub上对类似浏览器的工作流程需求强烈，需要实际的帮助来修复Bug、强化系统。
```
方法二：编写Python工具函数
在tools/目录下新建hr_api.py，写入requests调用逻辑，函数名必须与yaml中name一致，且返回dict类型结果；【函数内不可包含print或input，否则OpenClaw解析失败】。
方法三：重启OpenClaw服务使配置生效
执行docker-compose down → docker-compose up -d，等待日志显示“Tools registered: 3”即表示hr_api等工具已加载成功。
在提示词中显式声明工具调用意图
Agent不会主动猜测你要用哪个工具，必须用清晰、无歧义的自然语言触发。含糊表述如“帮我弄一下”“看看这个”大概率被忽略。
① 正确写法：请调用联网搜索工具，查找截至2026年8月12日中国新能源汽车7月销量TOP5品牌。
② 正确写法：用单位换算工具，把128MB转换成GB，保留两位小数。
③ 错误写法：最近车卖得怎么样？→ 没提“搜索”，没提时间范围，Agent默认走知识库而非工具链。
这一步操作起来很简单，直接把带工具关键词的句子发过去就行，但要注意每条指令只绑定一个工具动作，别写成“先搜销量再换算单位”，Agent不支持单条指令多工具串联。
调试工具调用失败的三个检查点
当提示词明确、开关已开、工具已注册，却仍返回“工具不可用”时，请依次验证：
第一：确认Agent实例已发布。未发布的Agent在网页端调试时工具权限显示为灰色，且API调用会返回404错误。
第二：检查API密钥是否具备工具调用权限。在platform.minimax.io的「接口密钥」页，该密钥的权限栏必须勾选“Tool Execution”，旧密钥可能默认不包含此项。
第三：查看返回JSON中的tool_calls字段是否为空。若为空，说明Agent根本没识别出工具意图；若非空但status为failed，则需检查工具函数抛出的异常日志。
