核心用法
web-claude 是一款三层级回退式智能搜索聚合技能，专为解决单一搜索源不稳定、结果质量参差不齐的问题而设计。其核心机制如下：
第一层级：Brave API（推荐）
调用 OpenClaw 内置 web_search 工具，响应速度1-2秒，支持结构化 JSON 返回，可配置 freshness 参数（pd=24小时、pw=1周、pm=1月）实现时效性过滤，同时支持 search_lang 和 country 参数进行区域化搜索（如韩语搜索）。
第二层级：DuckDuckGo（隐私优先）
当 Brave API 不可用（如未配置 API Key）时，自动回退至 DuckDuckGo Python 库。无需 API Key，隐私友好，支持文本、新闻、图片、视频等多种搜索类型，但请求频率过高可能触发服务限制。
第三层级：Claude.ai 浏览器（深度分析）
前两者均失败时，通过浏览器自动化访问 claude.ai 网页版，利用 Claude 自带的网页搜索+分析+摘要能力处理复杂研究需求。此模式无需 API Key，但耗时15-30秒，且受限于免费账户每日消息配额。
智能缓存机制
所有搜索结果自动保存至 memory/research/search-YYYY-MM-DD-HH-MM-[keyword].md，包含查询时间、使用的方法、原始结果链接及摘要、提取的核心洞察，形成可检索的个人知识库。
显著优点
1. 极致可靠性：三级回退策略确保99%+的搜索成功率，单一服务故障不影响整体功能
2. 零配置门槛：DuckDuckGo 和 Claude.ai 模式无需任何 API Key，开箱即用
3. 隐私灵活性：DuckDuckGo 模式适合隐私敏感场景，Brave 模式适合企业级高速需求
4. 智能时效控制：freshness 参数精准获取最新资讯（24小时内新闻、一周动态等）
5. 自动知识沉淀：搜索结果结构化归档，支持后续回顾、引用和二次分析
6. 多语言原生支持：内置韩语等区域性搜索参数，全球化信息获取无障碍
潜在缺点与局限性
1. Brave API 依赖成本：最优体验需要配置 Brave API Key，对免费用户形成一定门槛
2. DuckDuckGo 质量波动：相比 Brave，搜索结果相关性和结构化程度略逊
3. Claude.ai 浏览器模式脆弱性：依赖本地浏览器实例（端口18800）、claude.ai 登录状态，且存在自动化检测风险可能导致账号限制
4. 缓存隐私风险：搜索历史本地持久化存储，敏感查询可能留下痕迹需定期清理
5. 响应时间梯度差异：三层模式响应时间从1秒到30秒不等，用户需有预期管理
6. 第三方服务依赖：完全依赖外部搜索服务商的可用性和政策变更
适合的目标群体
- 研究员与分析师：需要多渠道信息交叉验证、自动归档研究资料的知识工作者
- 内容创作者：进行选题调研、竞品监控、热点追踪的自媒体运营者
- 开发者与产品经理：快速获取技术文档、市场数据、用户反馈的技术决策者
- 隐私敏感用户：倾向使用 DuckDuckGo 而非 Google/Bing 的隐私优先人群
- 多语言信息需求者：需要韩语、日语等非英语区域化搜索的国际化用户
- Agent 工作流构建者：需要稳定搜索能力作为下游任务输入的自动化场景
使用风险与缓解建议
性能风险
- 现象：大量并发搜索时 DuckDuckGo 可能触发频率限制，Claude.ai 浏览器模式每日消息配额耗尽
- 缓解：高频场景配置 Brave API Key；监控缓存目录避免磁盘空间膨胀
隐私与合规风险
- 现象：搜索查询发送至 Brave/DuckDuckGo/Anthropic 服务器，敏感信息存在泄露可能；本地缓存文件可能包含受监管数据
- 缓解：敏感查询改用本地搜索方案；定期清理
memory/research/目录（建议30天周期）；企业环境配置私有 API Key 减少数据外传
账号安全风险
- 现象：Claude.ai 浏览器模式存在自动化检测风险，可能导致账号临时限制
- 缓解：避免连续快速提交查询；使用 "new chat" 模式减少上下文污染；控制每日使用频次
依赖可用性风险
- 现象：任一搜索服务商 API 变更或故障可能影响对应层级
- 缓解：利用三级回退机制天然容错；关注技能更新以适配 API 变更