核心用法
research-tool 是 OpenClaw 生态的官方网络搜索技能，通过 OpenRouter 平台调用具备实时联网能力的 LLM（默认 GPT-5.2:online）。用户以自然语言提问，工具自动检索网络、阅读页面、整合信息并返回带引用来源的 Markdown 格式答案。
关键特性
- `:online` 后缀机制：为任意 OpenRouter 模型启用实时网页搜索、页面阅读与 URL 引用
- 四级推理强度：
low（1-5秒快速事实）→medium（5-15秒标准研究）→high（15-60秒深度分析）→xhigh（30-120秒+复杂多源合成） - 灵活模型切换：默认 GPT-5.2 擅长文档与引用，可切换 Claude、Gemini 等任意模型
- 环境变量驱动：
OPENROUTER_API_KEY必需，RESEARCH_EFFORT/RESEARCH_MODEL可预设默认行为
显著优点
1. 引用可靠性：输出自带 URL 引用，便于追溯与事实核查
2. 管道友好：标准输出为纯 Markdown 文本，错误/进度/Token 消耗走 stderr，适合脚本集成
3. 成本可控：单次查询约 $0.01–0.05，结束后自动打印 Token 用量
4. 领域定制：-s 系统提示可注入专家角色（如"资深基础设施工程师"），显著提升垂直领域回答质量
潜在缺点与局限性
- 网络依赖：完全依赖 OpenRouter 服务可用性与网络质量，离线环境无法使用
- 延迟波动：
xhigh模式下可能耗时 2 分钟以上，不适合实时交互场景 - 成本累积：高频调用（如自动化监控）可能产生显著费用，无内置预算限制或熔断机制
- 模型幻觉风险：虽带引用，但 LLM 仍可能误读或合成错误信息，关键决策需人工复核
适合人群
- 开发者：查询最新 API 文档、框架更新、技术方案对比
- 研究员/分析师：市场趋势、竞品动态、新闻事实核查
- 内容创作者：快速获取带来源的背景资料与数据
- 自动化工作流：结合 CI/CD 或 Agent 进行文档同步、变更检测
常规风险
| 风险类型 | 说明 |
|---------|------|
| API 密钥泄露 | `OPENROUTER_API_KEY` 需妥善保管，避免硬编码或日志泄露 |
| 敏感信息外泄 | 查询内容发送至第三方（OpenRouter→OpenAI/Anthropic 等），企业机密需谨慎 |
| 引用失效 | 返回的 URL 可能随时间 404，长期存档需本地备份 |
| 服务中断 | OpenRouter 或上游模型商故障将直接导致工具失效 |