← 返回 Skills 市场
97
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install 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...
安全使用建议
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install omada-viewer - 安装完成后，直接呼叫该 Skill 的名称或使用
/omada-viewer触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 97 次。
如何安装 Omada Viewer？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install omada-viewer」即可一键安装，无需额外配置。
Omada Viewer 是免费的吗？
是的，Omada Viewer 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Omada Viewer 支持哪些平台？
Omada Viewer 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Omada Viewer？
由 imJuff（@imjuff）开发并维护，当前版本 v1.0.2。
推荐 Skills