← Back to Skills Marketplace
piwi3910

ReefBeat

by piwi3910 · GitHub ↗ · v1.0.3 · MIT-0
cross-platform ⚠ suspicious
275
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install reefbeat
Description
Control and monitor Red Sea ReefBeat aquarium equipment directly over the local HTTP API — no cloud required. Supports ALL actions on ALL devices — ReefLED G...
Usage Guidance
This skill is internally consistent with its purpose, but be aware of what it does: it will scan your local subnet and send HTTP requests to devices it finds. That is necessary to discover and control ReefBeat hardware, but could trigger network monitoring or affect devices you do not own. Before installing/running: 1) run discovery with an explicit subnet instead of letting it infer your interface if you are on a multi-network host; 2) avoid issuing commands like POST /firmware, POST /reset, or POST /resume unless you intend the change (these endpoints can reset or update devices); 3) use the tool only on trusted private networks and target only devices you control; 4) if you need additional assurance, inspect the script locally (scripts/reefbeat.py) — it performs only local HTTP probes and does not exfiltrate data to external services.
Capability Analysis
Type: OpenClaw Skill Name: reefbeat Version: 1.0.3 The skill provides a CLI for local control of Red Sea ReefBeat aquarium hardware. The script `scripts/reefbeat.py` implements a network discovery feature that performs multi-threaded HTTP probing across the local subnet, which is a risky capability. Additionally, the script allows for arbitrary HTTP requests (GET/POST/PUT/DELETE) to be sent to any endpoint on a target IP, creating a potential for SSRF or unauthorized device manipulation if the agent is misdirected. While these functions are aligned with the stated purpose of device management, they constitute high-risk network behaviors according to the analysis criteria.
Capability Assessment
Purpose & Capability
Name/description match the included files. The CLI and API reference only require local HTTP access to ReefBeat devices and the provided script implements discovery and control of those devices. No unrelated credentials, cloud access, or extra system access are requested.
Instruction Scope
SKILL.md and scripts instruct the agent to discover hosts on the local subnet and issue GET/POST/PUT/DELETE to device endpoints (e.g., /device-info, /dashboard, /manual). This stays within the stated purpose, but the documented endpoints include powerful actions (firmware update, factory reset, cloud enable/disable). Use caution: these are destructive device operations if run against devices you do not own or without intent.
Install Mechanism
No install spec; it's instruction-only with a bundled CLI script. Nothing is downloaded or written by an installer, so install risk is low.
Credentials
The skill requires no environment variables, no credentials, and no config paths. The network access it uses (local HTTP and a UDP socket to infer local IP) is proportional to the discovery/control functionality and is documented in SKILL.md.
Persistence & Privilege
Skill does not request always:true or persistent elevated privileges and will not modify other skills or system settings. It runs as an on-demand CLI with normal network sockets.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install reefbeat
  3. After installation, invoke the skill by name or use /reefbeat
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
Fix scan findings: remove undocumented cloud credential references (code never used them), clarify description to not claim cloud API support, document UDP/8.8.8.8 interface-detection behaviour in discovery.
v1.0.2
Clean release — control Red Sea ReefBeat aquarium devices via local HTTP API. Auto-discovers all devices on your network. Supports ReefLED G1/G2, ReefDose, ReefMat, ReefRun, ReefATO+, ReefWave. Zero dependencies.
v1.0.1
Remove user credentials and personal device IPs from published files
v1.0.0
Initial release — full local HTTP API control for Red Sea ReefBeat aquarium devices. Auto-discovers all devices on your network and identifies their type. Supports ReefLED G1/G2 (lighting, schedules, acclimation, moonphase), ReefDose (dosing, calibration, supplements), ReefMat (filter roll, new-roll), ReefRun (return pump + skimmer), ReefATO+ (auto top-off, resume), ReefWave (wave modes, preview). Zero dependencies — pure Python stdlib.
Metadata
Slug reefbeat
Version 1.0.3
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 4
Frequently Asked Questions

What is ReefBeat?

Control and monitor Red Sea ReefBeat aquarium equipment directly over the local HTTP API — no cloud required. Supports ALL actions on ALL devices — ReefLED G... It is an AI Agent Skill for Claude Code / OpenClaw, with 275 downloads so far.

How do I install ReefBeat?

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

Is ReefBeat free?

Yes, ReefBeat is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does ReefBeat support?

ReefBeat is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ReefBeat?

It is built and maintained by piwi3910 (@piwi3910); the current version is v1.0.3.

💬 Comments