核心用法
本技能通过 ClawLink 托管服务，为 OpenClaw 用户提供开箱即用的 ClickHouse 数据库访问能力。用户无需手动配置 ClickHouse HTTP API 或管理 API 密钥，只需完成三步配对（安装插件 → 设备授权 → 连接数据库），即可在聊天会话中调用标准化工具执行以下操作：
| 功能类别 | 具体能力 |
|---------|---------|
| **Schema 探索** | 列出数据库、枚举表、获取库/表级完整结构 |
| **查询执行** | 运行只读 SQL 查询（自动注入凭证） |
| **交互界面** | 获取 ClickHouse Play 网页端入口 |
所有工具调用均通过 clawlink_call_tool 完成，ClawLink 负责请求代理、身份验证与结果返回。
显著优点
1. 零配置接入：ClawLink 托管连接流与凭据，消除 API 密钥管理的复杂性与泄露风险。
2. 只读安全设计：工具层强制限制为 SELECT 类操作，INSERT/ALTER/DROP/TRUNCATE 等变更操作被完全屏蔽，降低误操作风险。
3. 用户确认机制：针对大数据量查询（全表扫描、无 LIMIT 的 GROUP BY 等），系统要求用户显式确认后方可执行，防止资源耗尽。
4. 标准化工作流：强制 "先 Schema 探索 → 后查询执行" 的交互模式，减少因表名/列名错误导致的失败。
潜在局限与风险
- 依赖第三方托管：ClawLink 作为中间代理层，若其服务可用性或安全性出现问题，将直接影响本技能功能。
- 网络与延迟：所有查询需经 ClawLink 转发，相较于直连 ClickHouse 会引入额外网络跳数与延迟。
- 功能边界：严格只读设计意味着无法通过本技能完成数据写入、Schema 变更或运维操作。
- 查询复杂度限制：虽然 ClickHouse 本身擅长大规模分析，但未经优化的复杂查询仍可能在 ClawLink 层触发超时或资源管控。
适合人群
- 数据分析师、产品经理等非工程背景用户，需要快速探查 ClickHouse 中的业务数据。
- 运维人员需要在聊天环境中快速验证数据库状态、排查数据问题。
- 希望避免管理云凭证、追求即开即用体验的团队。
常规风险提示
- 数据隐私：查询内容与部分元数据会流经 ClawLink 服务，需评估是否符合组织的数据合规要求。
- 查询成本：虽然只读，但大规模扫描仍可能消耗 ClickHouse 集群计算资源并产生云账单。
- 工具可见性故障：若插件配置或网关缓存异常，可能导致工具列表不可见，需按文档执行
/new或重启网关恢复。