ClickHouse

核心用法

本技能通过 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 或重启网关恢复。

核心用法

clickhouse-analytics 是一款面向 ClickHouse 数据库的只读分析型 Skill，通过 ClawLink 插件实现安全代理访问。用户无需在聊天中配置任何凭证，仅需完成 ClawLink 账号配对与 ClickHouse 连接授权，即可在 OpenClaw 对话环境中执行以下操作：数据库列表浏览、表结构探查、完整 Schema 概览获取，以及基于 ClickHouse SQL 语法的只读分析查询。典型工作流遵循"先探查 Schema，再执行查询"的安全模式——通过 clickhouse_list_databases 和 clickhouse_get_database_schema 理解数据结构后，使用 clickhouse_execute_query 执行带 LIMIT 约束的查询，避免全表扫描带来的性能风险。

显著优点

零凭证暴露设计是该 Skill 的核心安全优势。所有 ClickHouse 连接信息由 ClawLink 平台托管，通过 API Key 自动注入请求，用户侧完全无感知。其次，纯只读操作约束从根本上杜绝了误操作风险——INSERT、ALTER、DROP 等 DML/DDL 操作被完全屏蔽，适合生产环境的数据探查场景。第三，可视化工作流支持提供了 clickhouse_get_play_interface 工具，可一键获取 ClickHouse Play 交互界面 URL，满足复杂 SQL 的手动编写需求。此外，智能查询确认机制会对大数据量查询或昂贵操作（如无 LIMIT 的 GROUP BY）触发用户确认，防止资源滥用。

潜在缺点与局限性

作为 T3 来源的社区项目，作者可信度验证成本是需要考量的因素——维护者 hith3sh 为个人开发者，虽采用 MIT-0 宽松许可，但缺乏企业级背书。功能层面，依赖 ClawLink 平台稳定性构成单点风险，若 ClawLink 服务中断或策略变更，Skill 将完全不可用。查询能力上，纯只读约束既是安全特性也是功能边界，无法满足数据写入、ETL 作业或表结构变更需求。此外，ClickHouse 特有的 SQL 方言（如 toStartOfInterval、arrayJoin 等函数）需要用户具备一定学习成本，工具本身不提供语法智能补全。网络层面，境外服务依赖（claw-link.dev、raw.githubusercontent.com）可能对特定网络环境下的访问稳定性造成影响。

适合的目标群体

该 Skill 最契合以下三类用户：一是数据分析师与 BI 工程师，需要快速探查 ClickHouse 中的事件流、日志或指标数据，生成即席分析查询；二是SRE 与运维工程师，用于生产数据库的健康检查、容量盘点和慢查询排查；三是产品经理与运营人员，在无需技术团队介入的情况下自主获取业务数据洞察。对于拥有自建 ClickHouse 集群的中小企业，该 Skill 可显著降低数据访问的技术门槛。

使用风险与注意事项

性能风险需重点关注：尽管 Skill 内置查询确认机制，但复杂的 JOIN 操作或针对超大表的聚合仍可能消耗大量资源，建议在 ClickHouse 侧配置查询超时和资源配额。凭证托管风险方面，ClawLink 作为第三方代理平台，其安全实践直接影响用户数据安全，建议定期审查平台安全公告并启用 ClickHouse 侧的 IP 白名单。版本兼容性风险：ClickHouse 迭代迅速，部分新特性函数可能尚未被 Skill 工具集覆盖，复杂查询需通过 Play 界面验证语法。数据隐私合规：虽然 Skill 本身不收集敏感信息，但查询内容可能经过 ClawLink 代理转发，涉及敏感数据的场景建议私有化部署或进行流量审计。