← Back to Skills Marketplace
joeynyc

Govee Lights Control

by joeynyc · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
2155
Downloads
2
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install govee-lights
Description
Control Govee smart lights to turn on/off, adjust brightness, set colors, and manage device states via the Govee API.
README (SKILL.md)

Govee Lights Control

Control Govee smart lights using natural language commands.

Quick Reference

Command Example
List devices python3 scripts/govee.py list
Turn on python3 scripts/govee.py on "lamp"
Turn off python3 scripts/govee.py off "lamp"
Brightness python3 scripts/govee.py brightness "lamp" 75
Color python3 scripts/govee.py color "lamp" 255 100 50

Natural Language Patterns

  • "Turn on [device name]"
  • "Turn off [device name]"
  • "Set [device name] to [brightness]%"
  • "Set [device name] to [color name or RGB]"
  • "Dim/Brighten [device name]"

Setup

  1. Get API key from Govee Developer Portal
  2. Set environment variable: export GOVEE_API_KEY="your-key"
  3. Install dependencies: pip3 install requests

Usage Examples

# List all devices
python3 scripts/govee.py list

# Control lights
python3 scripts/govee.py on "living room"
python3 scripts/govee.py off bedroom
python3 scripts/govee.py brightness "desk lamp" 50

# Set colors (RGB 0-255)
python3 scripts/govee.py color "strip" 255 0 0      # Red
python3 scripts/govee.py color "strip" 0 255 0      # Green
python3 scripts/govee.py color "strip" 255 165 0    # Orange

Troubleshooting

See TROUBLESHOOTING.md for common issues.

Usage Guidance
Before installing, inspect scripts/govee.py to confirm exactly what network calls and data it sends/receives (look for calls to external URLs, logging, or reading other env vars/files). Ask the publisher to update registry metadata to declare GOVEE_API_KEY as a required/primary credential and to provide a source URL or homepage (so you can verify provenance). If you want stricter control, require user-invocable-only or disable automatic model invocation. Run the script in a sandbox or review the code for any unexpected exfiltration of data (tokens, local files) before providing your Govee API key.
Capability Analysis
Type: OpenClaw Skill Name: govee-lights Version: 1.0.0 The OpenClaw AgentSkills skill bundle for Govee lights is benign. The `scripts/govee.py` script correctly implements the stated purpose of controlling Govee smart lights by interacting with the official Govee API (`openapi.api.govee.com`). It securely retrieves the API key from the `GOVEE_API_KEY` environment variable and does not attempt to access other sensitive data, exfiltrate information, or establish persistence. The `SKILL.md` and `TROUBLESHOOTING.md` files provide clear, legitimate instructions for setup and usage, without any evidence of prompt injection attempts or malicious commands.
Capability Assessment
Purpose & Capability
The SKILL.md and the included script (scripts/govee.py) describe controlling Govee devices via the Govee API, which reasonably requires an API key. However, the registry metadata declares no required environment variables or primary credential. The lack of source/homepage and unknown origin also reduces accountability.
Instruction Scope
Runtime instructions are narrowly scoped to running the bundled Python script and setting GOVEE_API_KEY; they do not request unrelated files or system-wide access. But the SKILL.md references an environment variable (GOVEE_API_KEY) that is not declared in the skill's metadata, and the agent will be instructed to execute a local script (scripts/govee.py) whose behavior should be audited.
Install Mechanism
There is no install spec (no code downloaded at install time). The README suggests installing the single dependency 'requests' via pip. That is a low-risk install model, but note the skill bundles an executable Python script that will be run locally.
Credentials
SKILL.md requires GOVEE_API_KEY to call the Govee API, but the skill metadata does not declare any required environment variables or a primary credential. This mismatch is suspicious because it hides a credential requirement from the registry metadata and policy checks.
Persistence & Privilege
The skill does not set always:true (so it is not force-included), but it also does not set disable-model-invocation:true. That means the model could invoke the skill autonomously (default behavior). For a device-control skill, consider whether autonomous invocation is acceptable.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install govee-lights
  3. After installation, invoke the skill by name or use /govee-lights
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Govee Lights Control skill. - Control Govee smart lights via the Govee API. - Supports turning devices on/off, adjusting brightness, setting RGB colors, and managing scenes. - Allows control of individual lights or groups by name using both command line and natural language. - Includes setup instructions and usage examples for easy integration.
Metadata
Slug govee-lights
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Govee Lights Control?

Control Govee smart lights to turn on/off, adjust brightness, set colors, and manage device states via the Govee API. It is an AI Agent Skill for Claude Code / OpenClaw, with 2155 downloads so far.

How do I install Govee Lights Control?

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

Is Govee Lights Control free?

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

Which platforms does Govee Lights Control support?

Govee Lights Control is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Govee Lights Control?

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

💬 Comments