← Back to Skills Marketplace
Sp501lw Mqtt
by
likong-iot
· GitHub ↗
· v0.1.0
· MIT-0
88
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install serial-server-mqtt
Description
SP501LW 串口网关纯 MQTT 管理技能——支持串口透传和 Modbus RTU 数据采集两种工作模式,通过 MQTT 完全控制设备,支持自定义主题和 Broker。
Usage Guidance
This skill is coherent with its stated purpose but take care before using it: 1) Review sp501lw_mqtt.py and SKILL.md to confirm where MQTT traffic will go. 2) Do not rely on the bundled default broker — explicitly set --broker-host, --username and --password to a broker you control. 3) Inspect devices.json before and after adding devices; it stores credentials in plaintext. 4) If you must test quickly, run the tool in a network-isolated environment or monitor outbound network connections to ensure data isn't sent to untrusted endpoints. 5) If you need privacy, run your own MQTT broker (e.g., on localhost or on a trusted host) and update examples to use it. If you want, I can point to the exact lines in the Python file that set the default broker and write devices.json so you can review them.
Capability Analysis
Type: OpenClaw Skill
Name: serial-server-mqtt-skill
Version: 0.1.0
The skill bundle is a legitimate management tool for the SP501LW serial-to-MQTT gateway. The Python script (sp501lw_mqtt.py) implements standard MQTT communication using the paho-mqtt library to configure device modes, serial parameters, and Modbus RTU polling tasks. While it stores MQTT credentials in a local plain-text file (devices.json), this is a common functional requirement for CLI tools of this nature and does not indicate malicious intent. The documentation (SKILL.md and ARCHITECTURE.md) accurately describes the hardware's reboot behavior and provides clear instructions for the AI agent to manage the device without any evidence of prompt injection or unauthorized data exfiltration.
Capability Assessment
Purpose & Capability
Name/description, required binary (python3), SKILL.md and included Python script all line up: this is a tool to manage SP501LW gateways over MQTT and to configure Modbus polling. The dependency on paho-mqtt is proportional and expected.
Instruction Scope
Runtime instructions direct the agent to run the included Python CLI which will publish/subscribe to MQTT topics and write a local devices.json containing device and broker settings. The SKILL.md and examples rely on a default remote broker (mqtt.likong-iot.com) and provide examples that include plaintext credentials — this means out-of-the-box use (or following examples exactly) will cause network traffic to a third-party broker and may upload device data unless the user supplies a different broker.
Install Mechanism
No binary downloads or obscure install steps; the only runtime dependency is paho-mqtt (pip). SKILL.md lists pip install for paho-mqtt, which is normal and low-risk.
Credentials
The skill requests no environment variables, which is proportional, but it stores broker credentials in devices.json in plaintext and ships with default broker host/username/password values pointing to mqtt.likong-iot.com/public: 'Aa123456'. Using defaults without review could leak telemetry/Modbus data to the author-controlled broker. Requiring credentials (via CLI args) is reasonable for MQTT control, but persistent plaintext storage and defaults to a remote host increase risk.
Persistence & Privilege
always:false and no evidence the skill modifies other skills or system-wide configs. It writes its own devices.json (expected for a CLI tool). Autonomous invocation is allowed by platform defaults; combined with the networking behavior above, this increases the need for caution but is not in itself a new privilege.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install serial-server-mqtt - After installation, invoke the skill by name or use
/serial-server-mqtt - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
sp501lw-mqtt v1.0.0 introduces initial support for SP501LW MQTT serial gateway management.
- Supports two main modes: serial transparent transmission (mqtt_tcp) and Modbus RTU data acquisition.
- Provides complete device management via MQTT, including custom topics and Broker.
- Implements device add, list, remove, update, mode switching, serial/data send/listen, Modbus item management, and polling controls.
- Documents all available and planned commands, with clear distinction between currently implemented and future features.
- Includes detailed usage instructions, parameter explanations, and device registration/configuration flow.
Metadata
Frequently Asked Questions
What is Sp501lw Mqtt?
SP501LW 串口网关纯 MQTT 管理技能——支持串口透传和 Modbus RTU 数据采集两种工作模式,通过 MQTT 完全控制设备,支持自定义主题和 Broker。 It is an AI Agent Skill for Claude Code / OpenClaw, with 88 downloads so far.
How do I install Sp501lw Mqtt?
Run "/install serial-server-mqtt" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Sp501lw Mqtt free?
Yes, Sp501lw Mqtt is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Sp501lw Mqtt support?
Sp501lw Mqtt is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Sp501lw Mqtt?
It is built and maintained by likong-iot (@likong-iot); the current version is v0.1.0.
More Skills