OpenClaw工具拆解之tavily+auxiliary

一、tavily 工具

1.1 工具概述

功能：AI 优化搜索引擎
核心特性：

• AI 优化搜索结果
• 支持搜索深度（basic/advanced）
• 支持主题分类
• 需要 API Key

1.2 Schema 定义

constTavilySearchToolSchema=Type.Object({query:Type.String({description:"Search query"}),searchDepth:Type.Optional(Type.String({enum:["basic","advanced"],description:"Search depth level"})),topic:Type.Optional(Type.String({description:"Topic category for better results"})),maxResults:Type.Optional(Type.Number({description:"Maximum number of results to return",default:10}))});

1.3 执行代码

functioncreateTavilyTool(options){constapiKey=options?.config?.tools?.tavily?.apiKey??process.env.TAVILY_API_KEY;if(!apiKey){returnnull;// API Key 未配置，工具不可用}return{label:"Tavily",name:"tavily",description:"AI-optimized search engine for research and fact-finding.",parameters:TavilySearchToolSchema,execute:async(_toolCallId,args)=>{constparams=args;// 1. 解析查询（必填）constquery=readStringParam$1(params,"query",{required:true});// 2. 解析搜索深度constsearchDepth=params.searchDepth==="advanced"?"advanced":"basic";// 3. 解析主题consttopic=readStringParam$1(params,"topic");// 4. 解析结果数量constmaxResults=typeofparams.maxResults==="number"?Math.max(1,Math.min(params.maxResults,20)):10;// 5. 调用 Tavily APIconstresponse=awaitfetch("https://api.tavily.com/search",{method:"POST",headers:{"Content-Type":"application/json","Authorization":`Bearer${apiKey}`},body:JSON.stringify({query,search_depth:searchDepth,topic:topic||"general",max_results:maxResults,include_answer:true,include_raw_content:false})});if(!response.ok){thrownewError(`Tavily API error:${response.status}${response.statusText}`);}constdata=awaitresponse.json();// 6. 返回结果returnjsonResult({query:data.query,answer:data.answer,results:data.results.map((r)=>({title:r.title,url:r.url,content:r.content,score:r.score})),total:data.results.length});}};}

1.4 返回结果格式

成功：

{"query":"OpenClaw documentation","answer":"OpenClaw is an AI assistant framework...","results":[{"title":"OpenClaw Documentation","url":"https://docs.openclaw.ai","content":"Official documentation for OpenClaw...","score":0.95}],"total":10}

二、辅助工具

2.1 apply_patch（已在第 13 组涉及）

功能：应用补丁到多个文件
详细说明：见apply_patch+sandboxed_read.md

2.2 image_generate（已在第 10 组涉及）

功能：生成图像（文生图/图生图）
详细说明：见web_fetch+image_generate.md

2.3 sessions_history（已在第 03 组涉及）

功能：获取会话历史消息
详细说明：见sessions_list+sessions_history.md

三、工具分类总览

3.1 完整工具列表（36 个）

3.2 文档覆盖情况

四、17 组（36 个工具）最终总结

已完成 17 组（36 个工具）：

总计：约300KB文档，覆盖36 个核心工具！

五、使用指南

5.1 工具选择指南

5.2 沙盒模式选择

沙盒模式启用时： ├─ 读取文件 → sandboxed_read ├─ 写入文件 → sandboxed_write └─ 编辑文件 → sandboxed_edit 非沙盒模式时： ├─ 读取文件 → read ├─ 写入文件 → host_workspace_write └─ 编辑文件 → host_workspace_edit