home / skills / openclaw / skills / lg-thinq

lg-thinq skill

safe

This skill helps you manage LG ThinQ devices by querying status and adjusting temperatures and modes across fridges, washers, dryers, and AC.

npx playbooks add skill openclaw/skills --skill lg-thinq

Review the files below or copy the command above to add this skill to your agents.

Files (3)

SKILL.md

2.5 KB

---
name: lg-thinq
description: "Control LG smart appliances via ThinQ API. Use when user asks about their fridge, washer, dryer, AC, or other LG appliances. Supports checking status, changing temperature, toggling modes (express, eco), and monitoring door status."
metadata: {"version":"1.0.0","clawdbot":{"emoji":"🧊","os":["darwin","linux"]}}
---

# LG ThinQ Skill

Control LG smart home appliances via the ThinQ Connect API.

## Setup

1. Get a Personal Access Token from https://connect-pat.lgthinq.com
2. Store token: `echo "YOUR_TOKEN" > ~/.config/lg-thinq/token`
3. Store country code: `echo "MX" > ~/.config/lg-thinq/country`

## Quick Commands

All scripts are in the skill's `scripts/` directory. Activate venv first:
```bash
cd ~/clawd && source .venv/bin/activate
```

### List Devices
```bash
python3 skills/lg-thinq/scripts/thinq.py devices
```

### Get Device Status
```bash
python3 skills/lg-thinq/scripts/thinq.py status <device_id>
python3 skills/lg-thinq/scripts/thinq.py status fridge  # alias
```

### Control Refrigerator
```bash
# Set fridge temperature (0-6°C)
python3 skills/lg-thinq/scripts/thinq.py fridge-temp 3

# Set freezer temperature (-24 to -14°C typical)
python3 skills/lg-thinq/scripts/thinq.py freezer-temp -15

# Toggle express fridge
python3 skills/lg-thinq/scripts/thinq.py express-fridge on|off

# Toggle express freeze
python3 skills/lg-thinq/scripts/thinq.py express-freeze on|off

# Toggle eco mode
python3 skills/lg-thinq/scripts/thinq.py eco on|off
```

### Washer/Dryer Status
```bash
python3 skills/lg-thinq/scripts/thinq.py status washer
python3 skills/lg-thinq/scripts/thinq.py status dryer
```

## Supported Devices

| Device | Status | Control |
|--------|--------|---------|
| Refrigerator | ✅ temp, door, modes | ✅ temp, express, eco |
| WashTower Washer | ✅ state, time | ⚠️ limited |
| WashTower Dryer | ✅ state, time | ⚠️ limited |
| Air Conditioner | ✅ temp, mode | ✅ temp, mode, fan |

## Temperature Ranges

- **Fridge**: 0°C to 6°C
- **Freezer**: -24°C to -14°C (varies by model)

## Error Handling

- `NOT_CONNECTED_DEVICE`: Device offline, check WiFi or open ThinQ app
- `INVALID_COMMAND_ERROR`: Wrong command format or value out of range
- `NOT_PROVIDED_FEATURE`: Feature not supported by this model

## Natural Language Examples

User says → Action:
- "check my fridge" → `status fridge`
- "set fridge to 5 degrees" → `fridge-temp 5`
- "turn on express freeze" → `express-freeze on`
- "is the fridge door open?" → `status fridge` (check doorStatus)
- "how's the washer doing?" → `status washer`

Overview

This skill lets you control LG ThinQ-compatible appliances through the ThinQ Connect API. It supports status checks and direct controls for refrigerators, washers, dryers, and air conditioners, including temperature changes and mode toggles. Use it to monitor door status, set fridge/freezer temps, toggle express or eco modes, and query laundry progress. Configuration requires a ThinQ personal access token and a country code stored in the local config.

How this skill works

The skill reads a stored personal access token and country code to authenticate with the ThinQ Connect API. It lists devices and inspects device-specific properties (temperature, door status, operation state, remaining time, mode flags) and sends control commands for supported features. The scripts map common natural-language intents (e.g., set fridge temp, check washer status) to API actions and handle common ThinQ errors like offline devices or unsupported features.

When to use it

You want to check current appliance status (fridge temp, door open, washer cycle).
You need to change refrigerator or freezer temperature remotely.
You want to enable or disable express, eco, or fan modes on supported devices.
You need to monitor washer/dryer progress or remaining time.
You need to verify an air conditioner’s set temperature or change its mode.

Best practices

Store the ThinQ personal access token and country code in the local config before using the skill.
Confirm device connectivity if you receive NOT_CONNECTED_DEVICE; check Wi‑Fi and the ThinQ app.
Respect device-specific temperature ranges (fridge 0–6°C, freezer roughly -24 to -14°C).
Validate command values to avoid INVALID_COMMAND_ERROR (use integer degrees within supported range).
Check feature availability per model; NOT_PROVIDED_FEATURE indicates unsupported controls.

Example use cases

Check if the fridge door is open and view current fridge/freezer temperatures.
Set the refrigerator to 3°C and the freezer to -18°C from a remote terminal.
Turn on express-freeze before a big grocery run, then disable it when done.
Query washer remaining time and get notified if a cycle finishes or an error appears.
Change AC mode and temperature remotely to cool the home before arrival.

FAQ

How do I authenticate the skill with my ThinQ account?

Obtain a personal access token from the ThinQ PAT site and save it with the country code in the skill's config location.

What if a command returns NOT_PROVIDED_FEATURE?

That means your model does not support the requested control; check the device capabilities via the devices/status command.