AI助手 openclaw 翻车现场:一个参数引发的搜索故障

2026年2月28日，一个普通的周六上午，我的AI助手突然”失明”了。

离奇的故障现象

早上开始，我让AI助手搜索”今日网络热点”，它返回了1979年的老电影信息。

我又让它搜索”黄金价格”，它报错：”查询太短，最少需要2个字符”。

但我明明输入的是中文”黄金价格 实时报价 2026年2月28日”，足足20个字！

更奇怪的是：这个已经运行了几个月的搜索工具，突然就这样了。

真相大白

经过排查，问题找到了：

不是API额度用完，不是服务器故障，不是模型问题。

而是我用错了一个参数。

技术真相（给技术爱好者）

Tavily Search API的正确用法：

tavily.ts search "关键词" --limit 5

tavily.ts search "关键词" --count 5

脚本的参数解析逻辑有bug：

// 当检测到不支持的参数时，会把后面的值当作query
if (arg === "--count") {  // 脚本不支持这个参数！
  // 没有处理，继续往下走
}
// 下一个参数 "5" 被当作了 query
else if (!arg.startsWith("--")) {
  query = "5";  // 所以 query 变成了 "5"
}

最终发送给API的query是”5″，当然会报错”查询太短”！

为什么突然出现问题？

关键问题：我之前一直用的是正确的 --limit 参数，今天突然改成了 --count。

为什么会改？可能是：

• 记错了参数名

• 看了其他工具的用法混淆了

• 无意识的输入错误

一个字符的差别，导致整个搜索功能瘫痪。

给所有AI使用者的警示

1️⃣ 故障不一定复杂

• 不要一看到错误就怀疑API、服务器、模型

• 先检查最基本的：参数、命令、配置

2️⃣ 突然出现的问题，往往是最近的变化

• 问自己：我最近改了什么？

• 参数、配置、环境变量

• 回滚到最后一次成功的状态

3️⃣ 文档是最好的朋友

• 用工具前，先看支持的参数列表

• 不要靠记忆，不要凭直觉

• 官方文档永远是对的

4️⃣ 错误信息要仔细看

• “Query is too short” —— 真的是query太短

• 不要往复杂的方向想

• 相信错误提示，即使它看起来不合理

5️⃣ 测试要小步快跑

• 改了东西马上测

• 不要一次改多个地方

• 出问题了能快速定位

技术反思

作为开发者，这个脚本的设计也有问题：

❌ 不友好的错误处理

• 不支持的参数应该明确报错

• 而不是悄悄忽略，导致后续逻辑异常

❌ 参数解析不够健壮

• 应该使用成熟的参数解析库（如 commander, yargs）

• 而不是自己手写解析逻辑

✅ 建议：

• 使用标准工具库

• 做好参数校验和错误提示

• 写清楚使用文档

结尾

这次翻车让我想起了那句话：

“Computers don’t make mistakes, they do what you tell them to do.”

电脑不会犯错，犯错的是人类。

AI助手再强大，也只是工具。真正让它工作的，是你正确的使用方式。

💡 今日金句：

“当你怀疑系统出了大问题时，先检查是不是自己打错了一个字。”