用 PostgreSQL Query Skill 做数据分析

适用场景

• 每日/每周数据报表自动生成
• 即席查询：产品经理问一个问题，Agent 直接查数据库回答
• 数据异常检测和告警
• 数据迁移和清洗

步骤 1：安装并配置

clawhub install postgres-query

配置只读连接（推荐先给 Agent 只读权限）：

export PG_HOST=your-db-host
export PG_PORT=5432
export PG_DATABASE=analytics
export PG_USER=agent_readonly
export PG_PASSWORD=readonly-password

在数据库中创建只读用户：

CREATE ROLE agent_readonly WITH LOGIN PASSWORD 'readonly-password';
GRANT CONNECT ON DATABASE analytics TO agent_readonly;
GRANT USAGE ON SCHEMA public TO agent_readonly;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO agent_readonly;

步骤 2：探索数据库结构

列出数据库里有哪些表

users 表的结构是什么

步骤 3：即席查询

查一下上个月的新注册用户数量

哪个产品的销量最高？给我 Top 10

步骤 4：定时报表

配置 cron 每天早上 8 点生成日报：

{
  "schedule": "0 8 * * *",
  "task": "查询昨日的关键指标（新增用户、订单量、收入），发送到 #daily-report"
}

步骤 5：安全加固

1. 只读优先：日常查询用只读账号
2. 写操作需确认：涉及 UPDATE/DELETE 的操作，Agent 应先询问
3. 查询超时：设置 statement_timeout，防止慢查询
4. 日志审计：记录所有 Agent 发起的查询
5. 连接池：设置合理的连接池大小，避免耗尽

常见问题

连接超时

• 检查数据库是否允许远程连接
• 确认防火墙和安全组规则

权限不足

• 使用 \dp 检查用户权限
• 确认 GRANT 语句已执行

查询太慢

• 检查是否有索引
• 用 EXPLAIN ANALYZE 分析查询计划