OpenClaw-Finnhub 是一个专注于实时美股数据查询的轻量级工具，通过调用 Finnhub 金融数据 API，为用户提供快速准确的股票价格信息。
核心用法
该技能通过命令行脚本 ./scripts/app.py 运行，支持获取美股实时报价数据。用户需提供操作模式（如"1"代表查询实时报价）和股票代码（如 NVDA），系统将返回当前价格、涨跌额、涨跌幅及当日最高最低价等关键数据。使用前需配置 Python 3.11+ 环境，安装 finnhub-python 依赖包，并通过环境变量 finnhub_api_key 设置 API 密钥。
显著优点
首先，数据来源权威可靠，Finnhub 是业内知名的金融数据提供商，确保数据的准确性和实时性。其次，安全配置规范，API Key 通过环境变量获取，避免了敏感信息硬编码带来的泄露风险。代码结构简洁明了，无 eval、exec、system 等危险函数，也无动态代码加载或注入漏洞。此外，功能聚焦单一，专为股票查询优化，响应速度快，适合集成到自动化工作流中。
潜在缺点与局限性
作为 T3 来源的个人开发者项目，代码健壮性有待提升。主要局限包括：缺少输入验证机制，命令行参数不足时会直接抛出 IndexError 导致程序崩溃；未对股票代码格式进行有效性检查，可能传递无效代码至 API；依赖包版本未锁定，可能因 finnhub-python 更新导致兼容性问题；缺乏完善的异常处理和错误提示机制，用户体验不够友好。
适合的目标群体
该技能最适合个人投资者和量化交易爱好者进行快速股价查询，也适合开发者将其集成到本地数据分析脚本或自动化监控系统中。对于需要简单、轻量级金融数据获取方案的教育科研场景同样适用。但不适合需要高可用性和严格 SLA 的生产级金融服务场景。
使用风险
常规风险包括：命令行参数错误导致的程序异常中断；API 调用频率限制可能触发服务不可用；依赖包版本冲突或更新带来的兼容性风险；网络连接问题可能导致数据获取失败。虽然 API Key 通过环境变量配置相对安全，但用户仍需确保环境变量权限设置正确，避免多用户环境下密钥泄露。