← 返回 Skills 市场

Govee Lights Control

Name: Govee Lights Control
Author: joeynyc

作者 joeynyc · GitHub ↗ · v1.0.0

cross-platform ⚠ suspicious

2155

总下载

当前安装

版本数

在 OpenClaw 中安装

/install govee-lights

功能描述

Control Govee smart lights to turn on/off, adjust brightness, set colors, and manage device states via the Govee API.

使用说明 (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

Get API key from Govee Developer Portal
Set environment variable: export GOVEE_API_KEY="your-key"
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.

安全使用建议

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.

功能分析

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.

能力评估

⚠ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install govee-lights
安装完成后，直接呼叫该 Skill 的名称或使用 /govee-lights 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug govee-lights

版本 1.0.0

许可证 —

累计安装 1

当前安装数 1

历史版本数 1

常见问题