qlik-cloud

# Qlik Cloud Skill

Complete OpenClaw integration for Qlik Cloud — 37 tools covering the full platform.

## Setup

Add credentials to TOOLS.md:

```markdown
### Qlik Cloud
- Tenant URL: https://your-tenant.region.qlikcloud.com
- API Key: your-api-key-here
```

Get an API key: Qlik Cloud → Profile icon → Profile settings → API keys → Generate new key

## ⚡ When to Use What

| You Want... | Use This | Example |
|-------------|----------|---------|
| **Actual data values** (KPIs, numbers, trends) | `qlik-insight.sh` | "what is total sales", "which store has lowest stock" |
| **App structure** (field names, tables) | `qlik-app-fields.sh` | Understanding data model |
| **Refresh data** | `qlik-reload.sh` | Trigger reload before querying |
| **Find apps** | `qlik-search.sh` or `qlik-apps.sh` | Locate app by name |

**🚨 Decision Tree:**

```
User asks about data (numbers, KPIs, trends)?
  └─ YES → Use qlik-insight.sh
           └─ Response has 'narrative' or 'data'? 
              └─ YES → Return the results
              └─ NO → Try rephrasing, check drillDownLink
  └─ NO (structure/metadata) → Use qlik-app-fields.sh
```

**Key insight:** `qlik-app-fields.sh` returns **metadata** (structure), NOT actual data. To get real numbers, always use `qlik-insight.sh` (Insight Advisor).

## Quick Reference

All scripts: `QLIK_TENANT="https://..." QLIK_API_KEY="..." bash scripts/<script>.sh [args]`

### Core Operations
| Script | Description | Args |
|--------|-------------|------|
| `qlik-health.sh` | Health check / connectivity test | — |
| `qlik-tenant.sh` | Get tenant & user info | — |
| `qlik-search.sh` | Search all resources (returns `resourceId`) | `"query"` |
| `qlik-license.sh` | License info & usage | — |

### Apps
| Script | Description | Args |
|--------|-------------|------|
| `qlik-apps.sh` | List apps (supports space filtering) | `[--space personal\|spaceId] [--limit n]` |
| `qlik-app-get.sh` | Get app details | `<app-id>` |
| `qlik-app-create.sh` | Create new app |...

# Qlik Cloud Skill for OpenClaw

Complete Qlik Cloud integration with 37 tools for the OpenClaw/Clawd agent platform.

## Features

- **Core**: Health checks, tenant info, search, licensing
- **Apps**: List, create, delete, get details, inspect fields
- **Reloads**: Trigger, monitor, cancel, view history
- **Insight Advisor**: Natural language queries against your data ⭐
- **Automations**: List, run, monitor automation workflows
- **AutoML**: Experiments and deployments
- **Qlik Answers**: AI assistants and Q&A
- **Alerts**: Data alerts management
- **Users & Spaces**: User management, space organization
- **Data**: Dataset info, lineage tracking

## Installation

Copy the `qlik-cloud` folder to your OpenClaw skills directory, or install via ClawdHub (coming soon).

## Setup

1. Get a Qlik Cloud API key:
   - Go to Qlik Cloud → Profile icon → Profile settings → API keys
   - Generate a new key

2. Add to your `TOOLS.md`:
```markdown
### Qlik Cloud
- Tenant URL: https://your-tenant.region.qlikcloud.com
- API Key: your-api-key-here
```

## Usage

All scripts follow the same pattern:

```bash
QLIK_TENANT="https://your-tenant.qlikcloud.com" \
QLIK_API_KEY="your-key" \
bash scripts/<script>.sh [arguments]
```

### Examples

```bash
# Health check
bash scripts/qlik-health.sh

# Search for apps
bash scripts/qlik-search.sh "sales"

# Natural language query
bash scripts/qlik-insight.sh "show revenue by region"

# Trigger app reload
bash scripts/qlik-reload.sh "app-id-here"
```

## Scripts Reference

See [SKILL.md](SKILL.md) for complete documentation.

## Requirements

- bash
- curl
- Python 3 (standard library only)

## License

MIT

## Author

Built by [undsoul](https://github.com/undsoul) with [OpenClaw](https://github.com/moltbot/moltbot).