介绍
# Qlik Cloud Skill
针对 Qlik Cloud 的完整 OpenClaw 集成——涵盖整个平台的 37 个工具。
## 设置
将凭据添加到 TOOLS.md：
```markdown ### Qlik Cloud - Tenant URL: https://your-tenant.region.qlikcloud.com - API Key: your-api-key-here ```
获取 API 密钥：Qlik Cloud → 头像图标 → Profile settings → API keys → Generate new key
## ⚡ 何时使用什么
| 您想要... | 使用此工具 | 示例 | |-------------|----------|---------| | **实际数据值**（KPI、数字、趋势） | `qlik-insight.sh` | "total sales 是多少"，"哪个商店库存最低" | | **应用结构**（字段名称、表） | `qlik-app-fields.sh` | 了解数据模型 | | **刷新数据** | `qlik-reload.sh` | 查询前触发刷新 | | **查找应用** | `qlik-search.sh` 或 `qlik-apps.sh` | 按名称定位应用 |
**关键提示：** `qlik-app-fields.sh` 返回 **元数据**（结构），而非实际数据。要获取真实数字，请始终使用 `qlik-insight.sh` (Insight Advisor)。
## 快速参考
所有脚本：`QLIK_TENANT="https://..." QLIK_API_KEY="..." bash scripts/<script>.sh [args]`
### 核心操作 | 脚本 | 描述 | 参数 | |--------|-------------|------| | `qlik-health.sh` | 健康检查 / 连接测试 | — | | `qlik-tenant.sh` | 获取租户和用户信息 | — | | `qlik-search.sh` | 搜索所有资源 | `"query"` | | `qlik-license.sh` | 许可证信息和使用情况 | — |
### 应用 | 脚本 | 描述 | 参数 | |--------|-------------|------| | `qlik-apps.sh` | 列出所有应用 | `[limit]` | | `qlik-app-get.sh` | 获取应用详细信息 | `<app-id>` | | `qlik-app-create.sh` | 创建新应用 | `"name" [space-id] [description]` | | `qlik-app-delete.sh` | 删除应用 | `<app-id>` | | `qlik-app-fields.sh` | 获取字段和表（仅限元数据，不含数据值） | `<app-id>` | | `qlik-app-lineage.sh` | 获取应用数据源 | `<app-id>` |
### 刷新 | 脚本 | 描述 | 参数 | |--------|-------------|------| | `qlik-reload.sh` | 触发应用刷新 | `<app-id>` | | `qlik-reload-status.sh` | 检查刷新状态 | `<reload-id>` | | `qlik-reload-cancel.sh` | 取消正在运行的刷新 | `<reload-id>` | | `qlik-reload-history.sh` | 应用刷新历史 | `<app-id> [limit]` | | `qlik-reload-failures.sh` | 最近失败的刷新 | `[days] [limit]` |
### 监控 | 脚本 | 描述 | 参数 | |--------|-------------|------| | `qlik-duplicates.sh` | 查找重复应用（同名） | `[limit]` |
### Insight Advisor ⭐ (自然语言查询) | 脚本 | 描述 | 参数 | |--------|-------------|------| | `qlik-insight.sh` | 用简单的英语提问，获取 **实际数据值** | `"question" [app-id]` |
**这是获取实际数据的主要工具！** 使用自然语言： - "total sales 是多少" - "哪些商店的可供应性最低" - "按地区显示库存数量" - "预计缺货的商品"
**注意：** 如果您不知道 app-id，请先不带参数运行 —— Qlik 会建议匹配的应用。app-id 为 UUID 格式（例如，`950a5da4-0e61-466b-a1c5-805b072da128`）。
### 用户与治理 | 脚本 | 描述 | 参数 | |--------|-------------|------| | `qlik-users-search.sh` | 搜索用户 | `"query" [limit]` | | `qlik-user-get.sh` | 获取用户详细信息 | `<user-id>` | | `qlik-spaces.sh` | 列出所有空间 | `[limit]` |
### 数据文件与血缘 | 脚本 | 描述 | 参数 | |--------|-------------|------| | `qlik-datafiles.sh` | 列出已上传的数据文件 | `[space-id] [limit]` | | `qlik-datafile.sh` | 获取数据文件详细信息 | `<file-id>` | | `qlik-datasets.sh` | 列出托管数据集* | `[space-id] [limit]` | | `qlik-dataset-get.sh` | 获取托管数据集详细信息* | `<dataset-id>` | | `qlik-lineage.sh` | 数据血缘图 | `<secure-qri> [direction] [levels]` |
*托管数据集在 Qlik Cloud 中可用。
### 自动化 | 脚本 | 描述 | 参数 | |--------|-------------|------| | `qlik-automations.sh` | 列出自动化 | `[limit]` | | `qlik-automation-get.sh` | 获取自动化详细信息 | `<automation-id>` | | `qlik-automation-run.sh` | 运行自动化 | `<automation-id>` | | `qlik-automation-runs.sh` | 自动化运行历史 | `<automation-id> [limit]` |
### AutoML | 脚本 | 描述 | 参数 | |--------|-------------|------| | `qlik-automl-experiments.sh` | 列出 ML 实验 | `[limit]` | | `qlik-automl-experiment.sh` | 实验详细信息 | `<experiment-id>` | | `qlik-automl-deployments.sh` | 列出 ML 部署 | `[limit]` |
### Qlik Answers (AI 助手) | 脚本 | 描述 | 参数 | |--------|-------------|------| | `qlik-answers-assistants.sh` | 列出 AI 助手 | `[limit]` | | `qlik-answers-ask.sh` | 向助手提问 | `<assistant-id> "question" [thread-id]` |
### 数据警报 | 脚本 | 描述 | 参数 | |--------|-------------|------| | `qlik-alerts.sh` | 列出数据警报 | `[limit]` | | `qlik-alert-get.sh` | 获取警报详细信息 | `<alert-id>` | | `qlik-alert-trigger.sh` | 触发警报评估 | `<alert-id>` |
## 示例工作流
### 检查环境 ```bash bash scripts/qlik-health.sh bash scripts/qlik-tenant.sh bash scripts/qlik-license.sh ```
### 查找并查询应用 ```bash bash scripts/qlik-search.sh "Sales" bash scripts/qlik-app-get.sh "abc-123" bash scripts/qlik-app-fields.sh "abc-123" bash scripts/qlik-insight.sh "What were total sales last month?" "abc-123" ```
### 查看应用数据源 ```bash # Simple: see what files/connections an app uses bash scripts/qlik-app-lineage.sh "950a5da4-0e61-466b-a1c5-805b072da128" # Returns: QVD files, Excel files, databases, etc. ```
### 刷新管理 ```bash 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 # Find apps that match your question bash scripts/qlik-insight.sh "show me sales trend"
# Query specific app with UUID bash scripts/qlik-insight.sh "ciro trend" "950a5da4-0e61-466b-a1c5-805b072da128" # Returns: "Total Ciro is 9,535,982. Max is 176,447 on 2025-01-02" ```
### Qlik Answers (AI) ```bash # List available AI assistants bash scripts/qlik-answers-assistants.sh
# Ask a question (creates thread automatically) bash scripts/qlik-answers-ask.sh "27c885e4-85e3-40d8-b5cc-c3e20428e8a3" "What products do you sell?" ```
## 响应格式
所有脚本均输出 JSON： ```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 上不可用）：
- ⚙️ **Automations** — 低代码工作流自动化 - 🤖 **AutoML** — 机器学习实验和部署 - 💬 **Qlik Answers** — AI 驱动的问答助手 - 🔔 **Data Alerts** — 基于阈值的警报 - 🔗 **Lineage (QRI)** — 数据流可视化 - 📊 **Managed Datasets** — 集中式数据管理