brave-search-setup

Brave Search Setup 是一款专为 OpenClaw 生态系统设计的网络配置与诊断工具，主要解决用户在使用 web_search 和 web_fetch 功能时遇到的连接性问题。该技能通过系统化的配置流程，帮助用户完成 Brave Search API 密钥设置、代理环境配置以及网络故障排除，特别针对中国大陆用户常见的网络访问限制提供了详细的解决方案。

核心用法涵盖四个关键场景：首先是 Brave Search API 密钥的配置，支持通过命令行工具或手动编辑 JSON 配置文件完成；其次是针对 macOS 系统的代理设置，详细说明了如何检测 Clash、V2Ray、Surge 等工具的端口并配置系统环境变量；第三是提供了完整的故障排除指南，包括 "fetch failed" 错误的诊断流程；最后是支持网关服务的重启与验证，确保配置生效。

该技能的显著优点在于其针对性和实用性。它提供了从基础配置到高级诊断的完整工作流，特别针对 macOS 用户提供了 launchctl、shell export 和配置文件修改三种代理设置方式，满足不同持久化需求。文档结构清晰，包含具体的命令示例和常见错误解决方案，降低了用户的配置门槛。此外，技能充分考虑了 GFW 环境下的特殊需求，提供了详细的代理端口检测方法和混合端口使用说明。

然而，该技能也存在一定局限性。首先，它主要针对 macOS 系统设计，其中 launchctl 等命令在其他操作系统上无法使用，限制了跨平台适用性。其次，技能假设用户已经具备 Clash、V2Ray 或 Surge 等代理工具的基础知识，对于新手用户可能存在理解门槛。另外，配置过程涉及修改系统环境变量和 shell 配置文件，如果操作不当可能影响系统其他网络应用的正常运行。

适合使用该技能的目标群体主要包括：OpenClaw 生态系统的深度用户，特别是需要启用网页搜索功能的开发者；身处网络受限地区（如中国大陆）需要通过代理访问 Brave Search API 的技术人员；以及遇到 "fetch failed" 等网络连接错误需要系统诊断的运维人员。对于普通终端用户或不熟悉命令行操作的人群，该技能可能存在一定的使用难度。

使用风险方面，需要注意该技能会修改系统的 HTTPS_PROXY 和 HTTP_PROXY 环境变量，错误的代理配置可能导致系统级网络访问异常。虽然安全报告显示代码本身无恶意行为，但由于来源为 T3 级别（个人开发者），建议用户在执行前审查脚本内容。此外，修改 ~/.zshrc 等配置文件前建议进行备份，避免因配置错误导致 shell 环境异常。技能中涉及的进程重启操作（kill -USR1）虽为标准操作，但需确保正确识别 OpenClaw 网关进程，避免误杀其他系统进程。