news 2026/6/13 11:09:03

工具调用协议:模型如何决定调用哪个工具

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
工具调用协议:模型如何决定调用哪个工具

Agent 会做事,不是因为模型“有手”。

它能做事,是因为 OpenClaw 把工具能力以 schema 和协议的形式交给模型,再把模型的工具调用请求送到真实执行层。

先说结论:工具调用是一次协议协作

一次工具调用大致是:

OpenClaw 选择可用工具 ↓ 把工具说明和 schema 放进模型上下文 ↓ 模型决定是否调用工具 ↓ 模型生成 tool name + arguments ↓ OpenClaw 校验参数和权限 ↓ 执行工具 ↓ 把 tool result 返回给模型 ↓ 模型继续推理或给最终答案

模型只提出调用意图;OpenClaw 才真正执行。

工具 schema 的作用

工具 schema 告诉模型:

工具叫什么 解决什么问题 需要哪些参数 参数类型是什么 哪些字段必填 返回什么结果

如果 schema 含糊,模型就容易填错参数。

如果工具太多,模型就容易选错工具。

可用工具不是全部工具

每次 run 的工具集合会经过过滤:

agent policy profile / session setting sandbox mode plugin enabled state MCP availability client-provided tools permission boundary

所以“系统安装了某个工具”不等于“这个 run 里模型能看到它”。

Tool Search:大工具目录的解决思路

当工具很多时,直接把所有 schema 发给模型会很贵。

OpenClaw 的 Tool Search 提供另一种形态:

模型先 search 工具 再 describe 目标工具 最后 call 选中的工具

这样模型不需要一开始看到所有完整 schema。适合大型 MCP、插件、客户端工具目录。

工具调用失败怎么办

工具失败可能来自:

参数错误 权限不足 approval 未通过 sandbox 看不到文件 网络超时 外部服务失败 工具返回太大 模型重复调用

OpenClaw 要把失败结果返回给模型,让模型有机会修正;但权限和安全错误不应该被模型“说服”绕过。

一个真实场景

用户说:

打开后台,导出昨天的数据,然后总结异常。

模型可能选择:

browser.open browser.click browser.snapshot file.read spreadsheet analyze message.send

每一步都不是自然语言幻想,而是具体 tool call、参数、执行结果和后续推理组成的链。

常见误解

误解一:模型可以直接执行工具

不可以。模型只生成调用请求,OpenClaw 执行并返回结果。

误解二:工具越多越好

不一定。工具太多会增加上下文成本和误选概率。

误解三:工具失败就是模型失败

不一定。可能是权限、sandbox、外部服务或参数 schema 问题。

最后总结

工具调用让模型从“会说”变成“能做”,但它本质是协议协作。

一句话总结:

模型选择工具,OpenClaw 校验和执行,结果再回到模型继续推理。

本节作业

  1. 选一个工具,写出它需要的 name、description、parameters。
  2. 解释“已安装工具”和“本次 run 可用工具”的区别。
  3. 思考大型 MCP 目录为什么需要 Tool Search。
  4. 找一次工具失败,判断失败来源在哪一层。

下一节预告

下一节讲模型降级、重试和错误处理策略。

参考资料

  • OpenClaw Docs:Tools overview
  • OpenClaw Docs:Tool Search
  • OpenClaw Docs:Tool plugins
  • OpenClaw Docs:Tools invoke API
  • OpenClaw Docs:Exec approvals

原文链接:工具调用协议:模型如何决定调用哪个工具 | Harries Blog™

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/13 11:00:22

跨平台USB设备共享神器:USB/IP Windows客户端深度解析与实战指南

跨平台USB设备共享神器:USB/IP Windows客户端深度解析与实战指南 【免费下载链接】usbip-win2 USB/IP Client for Windows 项目地址: https://gitcode.com/gh_mirrors/us/usbip-win2 在当今多设备协同工作的时代,USB/IP协议为Windows用户带来了革…

作者头像 李华
网站建设 2026/6/13 10:59:06

2026本地视频怎么去水印?实用本地视频去水印方法+软件推荐

日常保存的本地视频大多带有平台水印、logo标识、滚动字幕水印,不仅影响画面观感,二次剪辑、素材收藏使用时也十分受限。很多用户在寻找本地视频去水印方法时,常会遇到工具仅支持在线链接、处理画质压缩、操作复杂、隐私泄露等问题。2026年主…

作者头像 李华
网站建设 2026/6/13 10:58:06

5分钟快速上手:TwitchDropsMiner自动掉宝工具终极指南

5分钟快速上手:TwitchDropsMiner自动掉宝工具终极指南 【免费下载链接】TwitchDropsMiner An app that allows you to AFK mine timed Twitch drops, with automatic drop claiming and channel switching. 项目地址: https://gitcode.com/GitHub_Trending/tw/Twi…

作者头像 李华
网站建设 2026/6/13 10:56:08

Python之rhythmic包语法、参数和实际应用案例

Python rhythmic 包全解:功能、安装、语法、参数、8大案例、报错与注意事项 一、rhythmic 包基础说明 1. 包简介与核心功能 rhythmic 是Python 节奏/韵律分析、时序节拍处理、音频节奏提取专用第三方库,主要面向音乐分析、音频节拍检测、时序节奏建模、鼓…

作者头像 李华
网站建设 2026/6/13 10:55:59

STM32F10x实战SPI工程:驱动W25QXX闪存与LCD显示的完整Keil例程

本文还有配套的精品资源,点击获取 简介:直接可运行的STM32F10x SPI通信工程,基于标准外设库,已通过Keil MDK编译验证。包含SPI外设完整初始化流程、主从模式切换配置、同步收发函数封装,以及GPIO复用、时钟使能、中…

作者头像 李华