核心用法
WeChat Search Skill 是一款专注于微信公众号（WeChat Official Account）文章检索的工具型技能，采用「搜索优先、抓取兜底」的双层架构设计。用户可通过命令行直接输入关键词进行搜索，默认返回最新 5 篇相关文章，支持时间范围筛选、结果数量调整及多种输出格式（文本/JSON/Markdown）。
典型工作流：
1. 主策略：调用 web_search 工具，通过 site:mp.weixin.qq.com 限定域进行搜索引擎检索
2. 降级策略：当搜索API受限或结果不足时，启用 web_fetch 直接抓取页面，内置 5 秒延迟与请求头伪装
3. 结果输出：自动去重并按时间排序，支持配置缓存时长与自定义 User-Agent
显著优点
- 合规优先架构：明确遵循 robots.txt、强制速率限制（5秒间隔）、透明 Bot 标识，降低法律与平台封禁风险
- 鲁棒性设计：搜索 API 与网页抓取双保险，任一通路失效自动切换，配合 3 次网络重试机制
- 灵活配置：JSON 配置文件支持自定义最大结果数（上限 20）、缓存周期、请求延迟等参数
- 隐私克制：仅采集公开文章元数据（标题、链接、时间），不存储完整正文内容
潜在局限与风险
| 维度 | 说明 |
|------|------|
| **功能边界** | 无法突破微信的登录墙，仅限公开可访问文章；不支持阅读数、点赞数等互动数据获取 |
| **时效依赖** | 搜索引擎索引存在延迟，最新发布文章可能 数小时至数天后才可检索 |
| **平台对抗** | 微信公众号反爬机制持续升级，长期稳定性依赖维护者更新请求策略与 headers |
| **地域限制** | `mp.weixin.qq.com` 部分域名存在区域访问限制，海外 IP 可能触发验证或拦截 |
| **Tavily 依赖** | 增强搜索能力需外部 API Key，存在第三方服务的成本与可用性绑定 |
适合人群
- 研究者与分析师：需批量追踪特定领域公众号内容动态（如 AI、金融科技政策解读）
- 市场运营人员：竞品公众号内容监测与热点话题挖掘
- 开发者与自动化用户：希望将微信内容检索集成至 RAG 知识库或自动化工作流的技术用户
- 合规敏感场景：对数据抓取合法性有明确要求的企业或学术机构
常规风险提示
1. 频率管控：即使内置 5 秒延迟，高频调用仍可能触发微信或搜索平台的风控，建议生产环境进一步限制并发
2. 内容版权：抓取内容仅限个人学习、研究用途，商业二次传播需遵守《微信公众平台服务协议》及原创作者授权
3. 配置安全：~/.openclaw/wechat-search-config.json 可能包含 API Key，需确保文件权限设置为仅用户可读（chmod 600）
4. 结果校验：建议对关键信息人工复核原文，自动化摘要存在语义偏差风险