Local Tuya Light Control

This skill may be installed outside the Tuya project directory, so do not assume the project root is relative to this SKILL.md.

Use these default project locations first:

• This Maschine - Windows: C:\Users\1111\.openclaw\workspace\tuya-lights
• Windows: %USERPROFILE%\.openclaw\workspace\tuya-lights
• Linux / Android / Termux: ~/src/tuya-lights

If the local installation uses a different location, adjust this SKILL.md to match the actual project path.

Prefer the Go CLI variant:

• Windows: lampctl.exe
• Linux / Android / Termux: lampctl

Use Python only as fallback when the CLI binary is not available.

Source of truth#

• Registry: tuya_lamps.json
• Preferred CLI: lampctl.exe (Windows) or lampctl (Linux/Android)
• Python fallback: lamp_control.py
• Single-device probe: tuya_test_lamp.py
• Recovery notes: KEY_EXTRACTION.md
• New-device flow: ONBOARDING.md

Command patterns#

Windows PowerShell / CMD (ohne cd, direkt mit .):

powershell

.\lampctl.exe stehlampe on
.\lampctl.exe stehlampe brightness --value 50
.\lampctl.exe stehlampe color --value rot
.\lampctl.exe kitchen off
.\lampctl.exe all off
.\lampctl.exe vorzimmer on

# Linux / Android / Termux (mit cd)
cd ~/src/tuya-lights && lampctl stehlampe on
cd ~/src/tuya-lights && lampctl stehlampe brightness --value 50
cd ~/src/tuya-lights && lampctl stehlampe color --value red
cd ~/src/tuya-lights && lampctl küche off
cd ~/src/tuya-lights && lampctl all off
cd ~/src/tuya-lights && lampctl vorzimmer on

# Python fallback only if CLI is unavailable
python lamp_control.py stehlampe on

Natural language mapping#

• an -> on
• aus -> off
• 50% -> brightness --value 50
• rot/blau/grün/... -> color --value <name>
• warmweiß -> warmwhite
• kaltweiß -> coldwhite
• alle Lampen -> group all
• Vorzimmer -> group vorzimmer

Onboarding / repair#

If a lamp was repaired, re-paired, or moved to another network, assume the local_key may have changed. Read KEY_EXTRACTION.md and ONBOARDING.md, refresh the key, test with the preferred CLI first ( lampctl <lamp> status), then use tuya_test_lamp.py --probe if Python fallback is needed, and finally update tuya_lamps.json.

Portability note#

This skill intentionally prefers explicit standard project paths so it can still work after being copied into a separate OpenClaw skills directory. If a local installation uses a different layout, update this SKILL.md so the binary and project paths match that environment.

Current live lamps#

• kitchen
• livingroom_floor
• vorzimmer1
• vorzimmer2
• vorzimmer3
• vorzimmer4

Live groups#

• all
• vorzimmer

Discover devices#

lampctl discover

• Beispiel für diese Maschiene: C:\Users\1111\.openclaw\workspace\tuya-lights\lampctl.exe" stehlampe off