Govee Control for Openclaw

A script-free integration for controlling Govee smart devices via the official OpenAPI using simple curl commands.

cole-z
v1.0.1
Feb 17, 2026
0
1.6k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install govee-control

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install govee-control using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Govee Control?

The Govee Control skill provides a streamlined, script-free method for AI agents to interact with Govee smart home devices. By leveraging the Govee OpenAPI, this skill allows for direct device discovery, state monitoring, and command execution without the need for complex middleware or heavy libraries. It is a vital part of the Openclaw Skills ecosystem, designed for developers who want granular control over their smart environment using standardized web protocols.

This skill prioritizes security and simplicity by guiding users through the process of obtaining an API key and setting up secure local storage to prevent credential leakage. Whether you are automating your home office lighting or building complex environment-aware workflows, this skill ensures your AI agent can communicate effectively with Govee hardware.

Govee Control Use Cases

  • Automating home or office lighting based on schedule or context triggers.
  • Integrating smart light control into developer workflows or CLI environments.
  • Monitoring the current state (power, brightness, color) of Govee devices remotely.
  • Providing AI agents with the capability to manage physical environment settings during task execution.
  • Setting up quick, script-free lighting presets for various activities using Openclaw Skills.

How Govee Control Works

  1. The user obtains a Govee API key from the official developer portal.
  2. The API key is stored securely in a local per-user secrets file to ensure privacy.
  3. The skill uses curl to fetch a list of available devices and their unique identifiers.
  4. Device state is queried to verify current settings like brightness or connectivity.
  5. Control commands (PUT requests) are sent to the OpenAPI to change power status, brightness levels, or RGB colors.
  6. The skill interprets the API response codes to confirm success or troubleshoot issues.

Govee Control Setup

To get started with this skill, first obtain your API key from the Govee Developer portal. Then, configure your local environment:

mkdir -p "$HOME/.openclaw/secrets"
cat > "$HOME/.openclaw/secrets/govee.env" <<'EOF'
export GOVEE_API_KEY='<YOUR_API_KEY>'
EOF
chmod 600 "$HOME/.openclaw/secrets/govee.env"

Load the credentials into your shell before using the Openclaw Skills commands:

source "$HOME/.openclaw/secrets/govee.env"

Govee Control Data Schema & Taxonomy

The skill interacts with the Govee OpenAPI schema using a standard JSON structure. Key data points include:

Attribute Description
device The unique hardware ID (MAC address) of the Govee device.
model The specific model number of the hardware.
cmd A nested object containing the name of the action and its value.
code The HTTP response code (e.g., 200 for success).

All interactions are logged locally according to your agent's configuration, following the security protocols of Openclaw Skills.

Govee Control Advanced Features

  • Secure key handling using localized environment files to prevent credential exposure.
  • Direct OpenAPI communication bypassing the need for third-party scripts or bulky SDKs.
  • Support for granular RGB color control and brightness adjustments ranging from 1 to 100.
  • Built-in guardrails to restrict outbound requests only to authorized Govee API endpoints.
  • Compatibility with any shell environment that supports bash and curl within the Openclaw Skills framework.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*