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.

README (SKILL.md)

LG ThinQ Skill

Name: LG ThinQ
Author: kaiofreitas

Control LG smart home appliances via the ThinQ Connect API.

Setup

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

Quick Commands

All scripts are in the skill's scripts/ directory. Activate venv first:

cd ~/clawd && source .venv/bin/activate

List Devices

python3 skills/lg-thinq/scripts/thinq.py devices

Get Device Status

python3 skills/lg-thinq/scripts/thinq.py status \x3Cdevice_id>
python3 skills/lg-thinq/scripts/thinq.py status fridge  # alias

Control Refrigerator

# 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

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

Usage Guidance

This skill appears to do what it says: it talks to LG ThinQ via the thinqconnect library and uses a Personal Access Token you supply. Before installing, verify the token source (https://connect-pat.lgthinq.com) and keep the token private. Ensure you install the Python dependencies (pip install thinqconnect aiohttp) in a controlled virtualenv; SKILL.md's virtualenv path looks inconsistent — confirm where you keep your venv. Check and restrict permissions on ~/.config/lg-thinq/token and be aware the skill will cache device metadata at ~/.config/lg-thinq/devices.json. If you want stronger protection, consider using a secrets manager or environment-restricted token rather than storing long-lived PATs in plaintext.

Capability Analysis

Type: OpenClaw Skill Name: lg-thinq Version: 1.0.0 The skill is designed to control LG ThinQ appliances and generally appears benign, using standard configuration practices and a legitimate third-party library. However, the `scripts/thinq.py` file includes a `raw` command-line argument that allows sending arbitrary JSON payloads to the device control API. While not explicitly used for malicious purposes within the provided files, this capability (`thinq.py raw <device> <json>`) provides an unconstrained interface for device control, which could be exploited by a compromised agent or a malicious prompt to perform actions beyond the skill's stated high-level functions.

Capability Assessment

✓ Purpose & Capability

Name/description match the code and instructions: the CLI uses the ThinQ API (via thinqconnect) to list devices, query status, and send control payloads. Required resources (a ThinQ personal access token and country code file) are directly related to the stated purpose.

ℹ Instruction Scope

SKILL.md instructs storing a ThinQ PAT in ~/.config/lg-thinq/token and running the included Python script to interact with devices — this is within scope. Minor issues: the docs reference activating a virtualenv at 'cd ~/clawd && source .venv/bin/activate' (path/name appears inconsistent with the skill slug) and the README doesn't explicitly tell the user to pip-install the thinqconnect/aiohttp dependencies that the script requires. The script reads/writes only under ~/.config/lg-thinq (token, country, devices cache) and sends requests via the ThinQ API; it does not reference unrelated system paths.

ℹ Install Mechanism

There is no automated install spec (instruction-only plus an included script). That keeps disk changes minimal, but the provided Python script requires third-party packages (thinqconnect, aiohttp). SKILL.md does not provide explicit pip install steps for these dependencies, which is an operational omission but not a sign of maliciousness.

ℹ Credentials

No environment variables or unrelated credentials are requested. The skill asks the user to store a ThinQ Personal Access Token as a plaintext file in ~/.config/lg-thinq/token and to set a country code file; this is proportionate to interacting with the ThinQ API. Storing an access token in plaintext is sensitive — the token grants access to the user's devices and should be protected (file permissions, consider more secure storage).

✓ Persistence & Privilege

The skill is not always-enabled and does not request elevated persistence. It caches device lists under ~/.config/lg-thinq/devices.json (expected) and does not modify other skills or system-wide settings.

Version History

v1.0.0

Initial release: Control LG smart appliances (fridge, washer, dryer) via ThinQ API

Metadata

Slug lg-thinq

Version 1.0.0

License —

All-time Installs 1

Active Installs 1

Total Versions 1

Frequently Asked Questions

What is LG ThinQ?

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. It is an AI Agent Skill for Claude Code / OpenClaw, with 1992 downloads so far.

How do I install LG ThinQ?

Run "/install lg-thinq" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is LG ThinQ free?

Yes, LG ThinQ is completely free (open-source). You can download, install and use it at no cost.

Which platforms does LG ThinQ support?

LG ThinQ is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).

Who created LG ThinQ?

It is built and maintained by hikaio (@kaiofreitas); the current version is v1.0.0.

More Skills

LG ThinQ