Lg Thinq Universal

Universal LG ThinQ device setup and control. Discovers appliances and generates secure device skills.

LG ThinQ Universal Manager

🎯 Goal

Provide a secure, automated gateway for LG ThinQ device integration. This skill acts as a discovery engine and skill generator, allowing users to control their appliances via OpenClaw without duplicating sensitive credentials across multiple files.

📦 Supply Chain & Dependencies

For transparency and security, this skill performs the following automated installation steps:

1. Python Virtual Environment: Created locally within the skill directory to ensure isolation.
2. External Packages (via PyPI):
   • requests: Used for secure communication with the LG ThinQ API.
   • python-dotenv: Used for local management of the LG_DEVICE_ID.
3. Network Access: The installation script connects to pypi.org to download these libraries.

🔑 Obtaining Credentials

If the user asks how to get their tokens, provide these instructions:

1. Visit the Portal: https://connect-pat.lgthinq.com
2. Log In: Use your official LG ThinQ account.
3. Create Token: Click "ADD NEW TOKEN", give it a name (e.g., "OpenClaw"), and select the required features.
4. Copy PAT: Copy the generated Personal Access Token (PAT) immediately.
5. Identify Country: Use your 2-letter ISO country code (e.g., US, IN, GB).

🛠️ Prerequisites

The agent MUST ensure the following are set before proceeding:

1. LG_PAT: Stored in shell environment or root .env.
2. LG_COUNTRY: Stored in shell environment or root .env.

🔄 Agent Workflow (Mandatory)

Follow these steps in order when a user requests setup:

Step 1: Discovery

Run the automated discovery script. It validates configuration and prepares the device database.

Mandatory Safety Flow:

1. Generate Manifest: Run ./setup.sh (without flags).
2. Brief User: Present the Manifest and explain exactly what actions will be performed.
3. Ask for Permission: Use ask_user to obtain explicit consent.
4. Execute: Only after approval, run: ./setup.sh --confirm.

Step 2: Assemble Workspace

Review the output from Step 1. Present the discovered devices to the user. Once an ID is selected, move immediately to assembly:

1. Generate Manifest: Run python3 scripts/assemble_device_workspace.py --id <DEVICE_ID> (without flags).
2. Ask for Permission: Use ask_user to obtain consent for the file/directory operations.
3. Execute: Run: python3 scripts/assemble_device_workspace.py --id <DEVICE_ID> --confirm.

Step 3: Document and Persist

After the assembly script completes, you MUST immediately:

1. Analyze: Review the [AVAILABLE COMMANDS] and [ENGINE CODE] printed by the script.
2. Consult Reference: Read references/api-reference.md for technical headers and control logic.
3. Generate SKILL.md: Create the documentation in the new directory using references/device-skill-template.md as your guide.
4. Persistence: Save the trigger phrase, skill path, and command summary into your global MEMORY.md.

⌨️ Universal Management Commands

Use these commands for maintenance and discovery:

Command	Description	Use Case
python scripts/lg_api_tool.py list-devices	List all linked appliances	Verify connectivity
python scripts/lg_api_tool.py save-route	Discover regional server	Fix "Route not found" errors
python scripts/lg_api_tool.py get-state <id>	Get raw device state	Deep debugging
python scripts/lg_api_tool.py --help	Show all API tool options	Explore advanced features

🛡️ Security Mandates

1. Zero-Leak Policy: NEVER ask the user to paste their LG_PAT into the chat.
2. Credential Isolation: NEVER copy LG_PAT into generated device skill directories. Only LG_DEVICE_ID is permitted in those locations.
3. Local-Only: All API communication must remain local.

📚 References

Document	Purpose
references/skill-creation.md	Detailed post-setup workflow for creating device skills
references/skill-generation-guide.md	Instructions for building device-specific SKILL.md files
references/manual-setup.md	Manual installation steps (without setup scripts)
references/api-reference.md	Technical details on API headers and control logic
references/device-example.md	Complete example of a generated device skill
references/public_api_constants.json	Public API keys and constants used by the scripts

🚨 Error Handling

Symptom	Resolution
401 Unauthorized	Token expired. Guide user to https://connect-pat.lgthinq.com.
No devices found	Verify device is added to the official LG ThinQ App on mobile first.
Permission denied	The script should already be executable. If not, inform the developer.