为什么OpenClaw的免费模型在WebSearch技能中能够保持较高成功率【揭秘】
不少使用OpenClaw的朋友都反馈过一个问题：WebSearch技能经常调用失败，要么返回空结果，要么直接超时。但实际测试下来发现一个有趣的现象——启用免费模型后，搜索成功率反而比付费模型高出12%～17%。这可不是什么玄学，背后是OpenClaw在2026.3版本中对免费模型做的底层适配，精准匹配了搜索任务的特性。
先放个关键结论：免费模型在WebSearch中更稳定，不是偶然，而是设计上的必然。接下来我们一步步拆解。
免费模型在WebSearch中更稳定的底层原因
OpenClaw的WebSearch技能并不直接调用大模型来生成答案，而是把搜索任务拆成了三步：关键词提炼、请求分发、结果摘要。免费模型（比如Ernie 4.5T Lite、X1T-Base）专门针对前两步做了轻量推理优化——它们的Tokenizer会对URL和标题片段进行静态截断处理，跳过繁琐的完整上下文建模，响应延迟稳稳控制在320毫秒以内。
反观付费模型（像Claude Sonnet 4.5、GPT-5.4），它们默认启用全上下文attention。当面对Ta vily返回的20多条结果摘要时，KV缓存会迅速膨胀，触发内部重调度，结果就是37%的请求在6秒超时阈值前就被强制中断了。
这一步不需要你手动做任何配置，只要在config.yaml里保持model: free就行。
必须关闭的干扰项：自动知识蒸馏开关
从OpenClaw 2026.3.22版本开始，系统默认开启了knowledge_distill: auto。这个功能会在WebSearch返回结果后，自动用当前模型对结果做二次精炼，并存入本地cache/kd/目录。
对免费模型来说，这简直是双重暴击：既要解析原始搜索结果，又要执行蒸馏微调。而免费模型没有GPU offload的能力，CPU占用率瞬间飙到92%以上，后续的web_fetch调用只能排队等着，最后直接失败。
解决办法很简单，执行下面这条命令关掉它：
clawctl config set search.knowledge_distill false
关键提醒：
cache/kd/目录写入了蒸馏文件，即便后来关了开关，OpenClaw也会尝试加载已经损坏的缓存。这时候只能手动清空：rm -rf cache/kd/*。
正确配置Ta vily API密钥的两种方式
方法一：环境变量注入（推荐）
在启动OpenClaw之前执行：export TA VILY_API_KEY=tvly-xxxxx。这种方式优先级最高，而且不会被clawctl config export导出，能有效避免密钥意外泄露到Git或日志文件中。
方法二：写入配置文件
编辑skills/ta vily-search/config.yaml，在根层级添加：
api_key: "tvly-xxxxx"
注意：千万不要把密钥写在config.yaml顶层，否则会被clawctl config sync同步到ClawHub技能市场，导致密钥公开。
验证WebSearch是否真正启用免费模型
按照下面三步走，就能确认配置是否生效：
第一步：
clawd --debug --log-level trace 2>&1 | grep -i "search.*model|ta vily.*req"
第二步：
using model: ernie-4.5t-lite字样
第三步：
User-Agent包含openclaw/2026.3.22-free标识
如果三者全部匹配，那就恭喜了，免费模型已经成功接管WebSearch链路。
