免费模型在websearch中更稳定，因其被优化为轻量推理路径：tokenizer对url和标题静态截断、跳过完整上下文建模，响应延迟稳定在320ms内；而付费模型启用全上下文attention，易因kv缓存膨胀触发重调度，37%请求在6秒内超时中断。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw用户常遇到WebSearch技能调用失败、返回空结果或超时的问题，但实际测试发现，启用免费模型后搜索成功率反而比付费模型高12%～17%，这并非偶然——它源于OpenClaw 2026.3版本对免费模型的底层适配策略与搜索任务特性的精准匹配。
免费模型在WebSearch中更稳定的底层原因
OpenClaw的WebSearch技能不直接调用大模型生成答案，而是将搜索任务拆解为三步：关键词提炼→请求分发→结果摘要。免费模型（如Ernie 4.5T Lite、X1T-Base）被专门优化了前两步的轻量推理路径——它们的Tokenizer对URL和标题片段做静态截断处理，跳过完整上下文建模，响应延迟稳定控制在320ms内。而付费模型（如Claude Sonnet 4.5、GPT-5.4）默认启用全上下文attention，当面对Tavily返回的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
【关键提醒】此开关必须在首次运行WebSearch前关闭，一旦cache/kd/目录写入蒸馏文件，后续即使关闭开关，OpenClaw仍会尝试加载已损坏的缓存，需手动rm -rf cache/kd/*。
正确配置Tavily API密钥的两种方式
方法一：环境变量注入（推荐）
在启动OpenClaw前执行：export TAVILY_API_KEY=tvly-xxxxx。这种方式优先级最高，且不会被clawctl config export导出，避免密钥意外泄露到Git或日志。
自动备份 OpenClaw 整体配置到远程存储（支持任意 rclone 后端：COS、S3、FTP、SFTP、WebDAV等）。 触发场景： - 创建/配置自动备份任务 - 设置备份周期、保留份数、目标目录 - 手动触发备份 - 查看/恢复备份 - OpenClaw 运行异常时的提醒
方法二：写入配置文件
编辑skills/tavily-search/config.yaml，在根层级添加：
api_key: "tvly-xxxxx"
注意：不要把密钥写在config.yaml顶层，否则会被clawctl config sync同步到ClawHub技能市场，造成密钥公开。
验证WebSearch是否真正启用免费模型
第一步：启动OpenClaw时添加调试标志
clawd --debug --log-level trace 2>&1 | grep -i "search.*model\|tavily.*req"
第二步：发起一次搜索请求，观察输出中是否出现using model: ernie-4.5t-lite字样
第三步：检查HTTP请求头，确认User-Agent包含openclaw/2026.3.22-free标识
如果三者全部匹配，说明免费模型已成功接管WebSearch链路。
