$cd ../use-cases/
👾 开发者v1.4+8 分钟配置
$ cat sql-natural-language.md
SQL 自然语言查询界面
/** 弥合人类好奇心与结构化数据之间的鸿沟。OpenClaw 将自然语言转换为生产级 SQL，具备原生的模式感知能力和安全防护栏。 */
schema_sentinel.log
架构感知与安全至上
OpenClaw 不仅仅是“猜测” SQL。它会对您的数据库元数据 (DDL) 进行深度扫描，理解外键、约束和列类型。最重要的是，它在“安全第一”的模型下运行：默认只读、敏感字段 PII 脱敏，并利用参数化查询和基于 LLM 的校验来内置防止 SQL 注入。
query_pipeline.md
⚙️ 查询流水线
1
元数据发现
OpenClaw 对 PostgreSQL、MySQL 和 BigQuery 进行模式内省，而无需读取行数据。
2
语义映射
使用 RAG 增强的模式上下文，将用户意图映射到特定的表列。
3
SQL 合成与校验
生成标准 SQL 并在执行前通过本地 Linter 进行验证。
4
多模态可视化
自动将结果集渲染为交互式表格、条形图或 CSV 导出文件。
database_pool.json
⚙️ 数据库连接配置
{
"provider": "postgresql",
"connection": "postgres://readonly:***@prod-db:5432/analytics",
"security": {
"enforce_read_only": true,
"pii_masking": ["email", "phone"]
}
}
💡# 💡 高级技巧：使用 'postgres-read-only' 角色确保 AI 永远无法修改您的生产数据。
example_queries.sql
💬 生产级示例
QUERY:
"计算第三季度 Pro 用户的流失率"
OUTPUT:
WITH churn AS (SELECT user_id FROM subs WHERE status='expired'...) SELECT count(*) / (SELECT count(*) FROM users)...
QUERY:
"查找 202 房间重叠的预约"
OUTPUT:
SELECT t1.id, t2.id FROM appts t1 JOIN appts t2 ON t1.room=t2.room AND t1.start < t2.end...
❓ FAQ
Q1. 会意外修改生产数据库吗？
不会。默认只读模式。即使 LLM 生成破坏性查询，执行层也会拒绝。
Q2. 支持哪些数据库？
PostgreSQL、MySQL、BigQuery 开箱即用。可通过配置添加 MSSQL、SQLite、Oracle 等。
Q3. 能处理复杂查询吗？
能。LLM 理解外键和表关系，可生成 JOIN、CTE、窗口函数和子查询。
Q4. 数据发送到云端吗？
只处理模式元数据和 SQL。行级数据保留本地。用本地 LLM 则什么都不出网。