名称： qlik-cloud
描述： 完整的 Qlik Cloud 分析平台集成，包含 37 个工具。功能涵盖健康检查、搜索、应用管理、重新加载、自然语言查询（Insight Advisor）、自动化、AutoML、Qlik Answers AI、数据警报、空间、用户、许可证、数据文件和血缘关系。当用户询问 Qlik、Qlik Cloud、Qlik Sense 应用、分析仪表板、数据重新加载，或希望使用自然语言查询业务数据时使用。

Qlik Cloud 技能

为 Qlik Cloud 提供的完整 OpenClaw 集成——包含覆盖整个平台的 37 个工具。

设置

将凭据添加到 TOOLS.md：

### Qlik Cloud
- 租户 URL：https://your-tenant.region.qlikcloud.com
- API 密钥：your-api-key-here

获取 API 密钥：Qlik Cloud → 个人资料图标 → 个人资料设置 → API 密钥 → 生成新密钥

⚡ 何时使用哪个工具

🚨 决策树：

用户询问数据（数字、KPI、趋势）？
  └─ 是 → 使用 qlik-insight.sh
           └─ 响应包含 'narrative' 或 'data'？
              └─ 是 → 返回结果
              └─ 否 → 尝试重新措辞，检查 drillDownLink
  └─ 否（结构/元数据） → 使用 qlik-app-fields.sh

关键提示： qlik-app-fields.sh 返回的是元数据（结构），而非实际数据。要获取真实数值，请始终使用 qlik-insight.sh（Insight Advisor）。

快速参考

所有脚本：QLIK_TENANT="https://..." QLIK_API_KEY="..." bash scripts/<script>.sh [参数]

核心操作

应用

重新加载

监控

Insight Advisor ⭐（自然语言查询）

这是获取实际数据的主要工具！ 可以自然地提问：
- “总销售额是多少”
- “哪些门店可用性最低”
- “按区域显示库存数量”
- “预测缺货的商品”

重要事项：

1. 使用 resourceId（UUID 格式）——来自搜索结果，而非项目的 id
2. 检查响应中是否包含 narrative 和/或 data——如果两者都缺失，尝试重新措辞
3. 对于数据问题，使用 insight.sh，而非 fields.sh——fields.sh = 元数据，insight.sh = 实际数值

用户与治理

⚠️ 个人空间

在 Qlik Cloud 中，个人空间是虚拟的——它不会出现在 /spaces API 中！

# ❌ 错误：qlik-spaces.sh 不会显示个人空间
bash scripts/qlik-spaces.sh

# ✅ 正确：使用 qlik-apps.sh 并带上 --space personal 参数
bash scripts/qlik-apps.sh --space personal

Qlik Cloud 中的空间类型：
- personal — 虚拟的，用户的私有应用（使用 --space personal）
- shared — 团队协作空间
- managed — 具有发布工作流的受治理空间
- data — 数据存储空间

数据文件与血缘关系

*托管数据集在 Qlik Cloud 中可用。

自动化

AutoML

Qlik Answers（AI 助手）

数据警报

示例工作流

检查环境

bash scripts/qlik-health.sh
bash scripts/qlik-tenant.sh
bash scripts/qlik-license.sh

查找并查询应用

# 搜索返回 resourceId (UUID) —— 所有应用操作都使用此 ID
bash scripts/qlik-search.sh "Sales"
# 输出：{ "resourceId": "950a5da4-0e61-466b-a1c5-805b072da128", ... }

# 使用 resourceId 进行应用操作
bash scripts/qlik-app-get.sh "950a5da4-0e61-466b-a1c5-805b072da128"
bash scripts/qlik-app-fields.sh "950a5da4-0e61-466b-a1c5-805b072da128"
bash scripts/qlik-insight.sh "上个月的总销售额是多少？" "950a5da4-0e61-466b-a1c5-805b072da128"

查看应用数据源

bash scripts/qlik-app-lineage.sh "950a5da4-0e61-466b-a1c5-805b072da128"
# 返回：QVD 文件、Excel 文件、数据库等。

重新加载管理

bash scripts/qlik-reload.sh "abc-123"
bash scripts/qlik-reload-status.sh "reload-id"
bash scripts/qlik-reload-history.sh "abc-123"

自然语言查询（Insight Advisor）

# 查找与问题匹配的应用
bash scripts/qlik-insight.sh "显示销售趋势"

# 使用 UUID 查询特定应用
bash scripts/qlik-insight.sh "按区域的收入" "950a5da4-0e61-466b-a1c5-805b072da128"

Qlik Answers（AI）

# 列出可用的 AI 助手
bash scripts/qlik-answers-assistants.sh

# 提问（自动创建会话）
bash scripts/qlik-answers-ask.sh "27c885e4-85e3-40d8-b5cc-c3e20428e8a3" "你们销售什么产品？"

响应格式

所有脚本输出 JSON：

{
  "success": true,
  "data": { ... },
  "timestamp": "2026-02-04T12:00:00Z"
}

环境变量

必需的凭据（添加到 TOOLS.md 或设置为环境变量）：

• QLIK_TENANT — 你的租户 URL（例如：https://company.eu.qlikcloud.com）
• QLIK_API_KEY — 来自 Qlik Cloud 个人资料设置的 API 密钥

仅限云端的特性

以下特性是 Qlik Cloud 独有（在 Qlik Sense Enterprise on Windows 上不可用）：

• ⚙️ 自动化 — 低代码工作流自动化
• 🤖 AutoML — 机器学习实验和部署
• 💬 Qlik Answers — AI 驱动的问答助手
• 🔔 数据警报 — 基于阈值的通知
• 🔗 血缘关系 (QRI) — 数据流可视化
• 📊 托管数据集 — 集中式数据管理