核心用法
SQL Connector 是 OpenClaw 生态中的通用 SQL Server 连接组件，通过封装 sqlcmd 工具提供标准化数据库访问能力。用户可通过环境变量配置或直连方式初始化连接，支持执行原始 SQL、标量查询和结构化数据查询三种模式。典型工作流为：使用 from_env(profile) 从环境变量读取配置 → 调用 ping() 验证连接 → 通过 query() 或 execute() 执行操作。
显著优点
可靠性设计：内置指数退避自动重试机制，应对瞬时网络波动；连接验证与错误分类机制可快速定位问题根因（网络层 vs SQL 语法层）。安全基线：强制参数化查询接口，从 API 设计层面消除 SQL 注入风险；日志脱敏处理（DEBUG 级别记录）。运维友好：环境变量驱动的多环境配置（dev/staging/prod），支持连接池减少资源消耗，返回结构化字典列表便于下游处理。
潜在局限
供应商锁定：当前仅支持 MSSQL/sqlcmd，PostgreSQL/MySQL 需等待 ODBC/pyodbc 扩展。外部依赖：强制要求客户端安装 mssql-tools，容器化部署需额外处理。功能边界：非 ORM 工具，复杂事务管理、迁移版本控制需自行实现。
适合人群
- 已部署 SQL Server 的 OpenClaw 自动化工作流开发者
- 需要快速集成数据库能力、无需重型 ORM 的基础设施团队
- 注重连接稳定性与注入防护的安全敏感型项目
常规风险
- 凭据泄露：
.env文件需纳入.gitignore及密钥管理体系 - 连接风暴：默认池配置在突发流量下可能耗尽连接数
- 日志敏感数据：DEBUG 日志虽脱敏，生产环境仍建议提升至 INFO 级别
- 命令注入残留：
execute()方法若直接拼接字符串仍存在风险，应优先使用query()的参数化接口