Skill: Sql Buddy

Version: 1.0.0

Chunk: 1/1

SQL Buddy 技能

将自然语言问题转换为 SQL 查询、探索数据库模式、安全执行查询，并获得优化建议。支持 SQLite、PostgreSQL、MySQL 和 SQL Server。

核心能力

• 自然语言 → SQL：将中文/英文描述转换为正确的 SQL
• 模式探索：自动发现表、列、类型和关系
• 安全执行：默认只读；DDL/DML 需要显式 --allow-write
• 查询优化：EXPLAIN 计划分析、索引建议、性能警告
• 结果洞察：AI 对查询结果的解释（趋势、异常）
• 多方言：SQLite / PostgreSQL / MySQL / MSSQL（⚠ MSSQL 驱动为存根 — 需要 pymssql）

安全与隐私

• 默认 readonly: true — 所有非 SELECT 语句将被拦截
• 密码永不写入日志或历史记录
• 连接配置本地存储在 ~/.openclaw/data/sql-buddy/connections.json
• LLM 仅接收表名、列名和类型，绝不接收实际行数据
• 敏感列名（password_hash, secret, token）在模式上下文中被屏蔽
• 所有用户 SQL 参数均使用参数化查询（预编译语句）

使用方式

clawhub run sql-buddy --query "<自然语言>" --connection <连接字符串> [选项]

选项

连接格式

sqlite:///path/to/database.db
postgresql://user:pass@host:5432/dbname
mysql://user:pass@host:3306/dbname
mssql://user:pass@host:1433/dbname

或使用环境变量：DATABASE_URL / DB_PASSWORD。

示例提示

1. 简单聚合查询（零配置 SQLite）

clawhub run sql-buddy --query "最近7天注册了多少用户" \
  --connection sqlite://./app.db --execute
# → 生成的 SQL：SELECT COUNT(*) as new_users FROM users WHERE created_at >= DATE('now', '-7 days')
# → 结果：847 位新用户

2. 复杂 JOIN 查询

clawhub run sql-buddy --query "每个品类上个月的销售额，按金额从高到低排序，同时显示商品数量" \
  --connection postgresql://localhost:5432/shop --execute
# → 多表 JOIN，包含 GROUP BY、ORDER BY、窗口函数

3. SQL 优化分析

clawhub run sql-buddy --direct-sql "SELECT * FROM orders JOIN users ON orders.user_id = users.id WHERE users.status = 'active'" \
  --explain --suggest-indexes
# → 全表扫描警告、索引建议、优化后的 SQL 重写

4. 模式探索

clawhub run sql-buddy --connection postgresql://localhost:5432/shop --show-schema
# → 所有表及其列、类型、主键、外键和注释提示

5. 包含结果洞察的账务分析

clawhub run sql-buddy --query "本月各区域销售额对比" \
  --connection postgresql://localhost:5432/shop --execute
# → SQL + 结果 + AI 洞察：“华东区销售额环比下降15%，建议关注…”

首次成功路径

步骤 1：安装 → clawhub install sql-buddy
步骤 2：连接 SQLite → clawhub run sql-buddy --query "有哪些表" --connection sqlite://./test.db
步骤 3：查看模式 → 自动生成
步骤 4：查询 → clawhub run sql-buddy --query "每种状态有多少用户" --connection sqlite://./test.db --execute
步骤 5：查看聚合结果 → “原来不用写SQL也能查数据!”

核心脚本