# Send Openclaw Lifx to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "lifx",
    "name": "Openclaw Lifx",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Stillstellung/lifx",
    "canonicalUrl": "https://clawhub.ai/Stillstellung/lifx",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/lifx",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=lifx",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "lifx-api.sh",
      "scene-status.py",
      "setup.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/lifx"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/lifx",
    "downloadUrl": "https://openagent3.xyz/downloads/lifx",
    "agentUrl": "https://openagent3.xyz/skills/lifx/agent",
    "manifestUrl": "https://openagent3.xyz/skills/lifx/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/lifx/agent.md"
  }
}
```
## Documentation

### LIFX Light Control

Control LIFX smart lights via the LIFX HTTP API through natural language.

### References

lifx-api.sh — Bash wrapper for all LIFX API calls
scene-status.py — Scene matching and active detection
setup.sh — Device discovery and skill configuration

### Configuration

Set your LIFX API token (get one at https://cloud.lifx.com/settings):

bash setup.sh <your-token>

This discovers your lights, groups, and scenes, then generates a personalized SKILL.md with your device context.

### Device Context

Run bash setup.sh <your-token> to populate this section with your lights, rooms, and scenes.
The setup script queries the LIFX API and rewrites this file with your personal device context.

Location: (not configured)

### Rooms and Lights

(populated by setup.sh)

### Scenes

(populated by setup.sh)

### Multi-zone Devices

(populated by setup.sh)

### Discover lights

bash lifx-api.sh discover

Shows all lights organized by room with power state, color, and brightness.

### Toggle lights on/off

bash lifx-api.sh toggle <selector>

Selectors:

Individual light: id:<light_id>
Group/room: group_id:<group_id>
All lights: all

### Set light state (color, brightness, power)

bash lifx-api.sh state <selector> '{"power":"on","color":"blue","brightness":0.75,"duration":1.0}'

Color formats:

Named: red, blue, green, white, warm white, purple, orange
Hex: #ff6b35
Kelvin: kelvin:2700 (warm) to kelvin:6500 (cool daylight)
HSB: hue:240 saturation:1.0

Always include "power":"on" and a brightness value when setting colors, or lights with brightness 0 will stay invisible.

### Activate a scene

bash lifx-api.sh scene <scene_uuid>

### Toggle a room

bash lifx-api.sh group-toggle <group_id>

### Multi-zone gradients (Beam / Strip devices)

Multi-zone devices support individually addressable zones. Create gradients by setting different zone ranges:

bash lifx-api.sh state 'id:<light_id>|0-4' '{"power":"on","color":"purple","brightness":1.0,"duration":1.0}'
bash lifx-api.sh state 'id:<light_id>|5-9' '{"power":"on","color":"red","brightness":1.0,"duration":1.0}'

The pipe character in zone selectors is automatically URL-encoded by the script.

### Check scene status

python3 scene-status.py all    # Show all active scenes
python3 scene-status.py check <uuid>  # Check specific scene

### List current light states

bash lifx-api.sh list    # Full JSON
bash lifx-api.sh groups  # Summary by room

### Behavior Guidelines

When user says a room name, match it to the group IDs in the device context above.
Default brightness to 1.0 (100%) when setting colors unless user specifies otherwise.
Default duration to 1.0 seconds for smooth transitions.
For "turn off" commands, use {"power":"off"} — don't toggle (toggling is ambiguous).
For "turn on" commands, use {"power":"on","brightness":1.0} to ensure visibility.
When asked about what's on/what scene is active, use the scene-status tool or discover command.
Be conversational about results: "Done, bedroom is now blue at 75%" not "API returned 207".
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Stillstellung
- Version: 1.0.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/lifx)
- [Send to Agent page](https://openagent3.xyz/skills/lifx/agent)
- [JSON manifest](https://openagent3.xyz/skills/lifx/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/lifx/agent.md)
- [Download page](https://openagent3.xyz/downloads/lifx)