← Back to Skills Marketplace
97
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install omada-viewer
Description
Read-only diagnostics for TP-Link Omada SDN controllers via the Open API. Use when inspecting Omada devices, clients, VLANs, LAN networks, WAN status, router...
Usage Guidance
This package largely does what it claims (read-only Omada diagnostics) but before installing or running it: 1) Treat OMADA_CLIENT_SECRET and related values as secrets — don't paste them into chat; set them as environment variables on a local machine you control. 2) Expect the repository/registry metadata to be incorrect about required env vars — SKILL.md and the scripts do require OMADA_URL, OMADA_CLIENT_ID, and OMADA_CLIENT_SECRET. 3) Inspect the included scripts locally (they're bundled) and run them in a safe environment; there are a few code-quality bugs (inconsistent JSON access and broad exception handling) that could conceal errors. 4) Use a Viewer-scoped API app in Omada (no admin privileges). 5) If you plan to let an autonomous agent invoke this skill, be cautious because the agent would have network access to your controller; prefer to run the scripts manually until you verify behavior. 6) Ask the publisher to correct the registry metadata to list the required environment variables so the requirements are explicit.
Capability Assessment
Purpose & Capability
The skill's name and description match the included scripts and endpoint references: it is a read-only Omada Open API viewer. However the registry metadata claims no required env vars / primary credential while SKILL.md and the scripts require OMADA_URL, OMADA_CLIENT_ID, and OMADA_CLIENT_SECRET — a mismatch between declared metadata and actual capability requirements.
Instruction Scope
Runtime instructions limit activity to querying the user's Omada controller over HTTPS and running the included Python scripts. The SKILL.md explicitly recommends Viewer role and warns not to paste secrets in chat. The instructions and scripts do not direct data to third-party endpoints or attempt to read unrelated local files; they only read environment variables and call the controller APIs.
Install Mechanism
There is no install spec and no external downloads; all code is bundled in the skill (two scripts and reference docs). That minimizes install-time risk — nothing is fetched from arbitrary URLs or written automatically to system locations.
Credentials
The scripts legitimately need controller credentials (OMADA_URL, OMADA_CLIENT_ID, OMADA_CLIENT_SECRET) and optional OMADA_OMADAC_ID, OMADA_SITE, OMADA_VERIFY_SSL. Those requested secrets are proportionate to the stated purpose. The concern is the registry metadata failing to declare these required env vars/primary credential, which may mislead users into installing without realizing they must supply sensitive credentials.
Persistence & Privilege
The skill does not request permanent presence (always is false), does not modify other skills or global agent settings, and has no elevated platform privileges. It only runs as a user-invoked Python script using environment variables the user provides.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install omada-viewer - After installation, invoke the skill by name or use
/omada-viewer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Clarified that user-provided Omada Open API credentials and HTTPS access are required.
- Improved setup and requirements instructions for easier onboarding.
- Reorganized and simplified endpoint documentation for better readability.
- Emphasized security practices and the use of the Viewer role for diagnostics.
- No functional changes; documentation updates only.
v1.0.0
Initial public release of omada-viewer — a read-only diagnostic tool for TP-Link Omada SDN controllers using the Open API.
- Supports safe inspection of devices, clients, VLANs, DHCP, WAN/LAN status, port forwards, and controller/network health.
- Read-only: does not allow configuration changes; diagnostics and inventory only.
- Works with both local and cloud-accessible Omada controllers.
- Provides recommended setup, authentication, and usage guidance with detailed API endpoint references.
- Includes scripts for quick diagnostics and troubleshooting tips.
Metadata
Frequently Asked Questions
What is Omada Viewer?
Read-only diagnostics for TP-Link Omada SDN controllers via the Open API. Use when inspecting Omada devices, clients, VLANs, LAN networks, WAN status, router... It is an AI Agent Skill for Claude Code / OpenClaw, with 97 downloads so far.
How do I install Omada Viewer?
Run "/install omada-viewer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Omada Viewer free?
Yes, Omada Viewer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Omada Viewer support?
Omada Viewer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Omada Viewer?
It is built and maintained by imJuff (@imjuff); the current version is v1.0.2.
More Skills