← Back to Skills Marketplace
h8kxrfp68z-lgtm

Openclaw Network Diagnostics

by h8kxrfp68z-lgtm · GitHub ↗ · v0.1.1
cross-platform ⚠ suspicious
386
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install openclaw-network-diagnostics
Description
Standalone advanced network diagnostics for OpenClaw to continuously test end-to-end connectivity from OpenClaw agent to Telegram Bot API and approximate del...
Usage Guidance
This package appears to do what it says, but take these precautions before deploying: (1) Review the full scripts/netdiag.py source yourself (or have someone you trust) to confirm there are no unexpected network endpoints or hidden behaviors. (2) Keep your Telegram bot token and personal chat id out of world-readable locations; prefer a restricted config file and OS-level secret storage. (3) Ensure logging.redact_sensitive_fields is true before running; if you must share logs externally (AI analysis, etc.), mask tokens and PII first. (4) Run the worker as an external background process (the SKILL.md recommendation) rather than in-process to avoid impacting OpenClaw runtime. (5) Start in a sandboxed host or staging environment to observe actual network traffic and any subprocess invocation (ping/traceroute/dig) before deploying to production. (6) If you supply a proxy_url or NETDIAG_CONFIG via environment, double-check those values to prevent accidental routing of telemetry to an unintended server.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-network-diagnostics Version: 0.1.1 The skill bundle provides a network diagnostic tool that executes system commands (ping, traceroute, dig) via subprocess using parameters from a configuration file (scripts/netdiag.py). While these functions support the stated purpose of monitoring Telegram Bot API connectivity, the lack of strict sanitization on configuration values like 'telegram_api_host' could allow for argument injection attacks. Furthermore, the tool's ability to run as a persistent background process and its handling of sensitive Bot Tokens, combined with instructions to upload detailed telemetry logs to external AI services (references/ai-log-analysis.md), creates a high-risk profile for data exposure and system abuse.
Capability Assessment
Purpose & Capability
Name/description match the files and runtime instructions: the worker probes DNS, ICMP, traceroute, MTU, and exercises the Telegram Bot API for delivery verification. Required artifacts (bot token, personal chat id) are consistent with the stated functionality and no unrelated cloud credentials or system-wide accesses are requested.
Instruction Scope
SKILL.md stays focused on diagnostics and gives explicit CLI commands and background/foreground modes. It recommends both external-process and in-process integration; the latter is explicitly flagged as higher-risk. Attention: the workflow and references encourage later AI-based log analysis and may involve sharing log slices externally — ensure tokens/PII are redacted before exporting logs.
Install Mechanism
No install spec is provided (instruction-only), so nothing is fetched or executed at install time. The runtime requires Python 3.11+ and common networking tools (dig/ping/traceroute) which are proportional to the task.
Credentials
The skill does not ask for unrelated environment credentials in registry metadata. It expects a config file containing a Telegram bot token and personal chat id (or NETDIAG_CONFIG can point to a config), which is appropriate. Be aware the tool writes detailed JSON logs that could include sensitive headers or tokens if redaction is disabled; default config sets redaction=true, but you should verify it's enabled.
Persistence & Privilege
The skill is not always-enabled and is user-invocable. It runs as a long-running process (writes PID file, logs) which is normal for a monitoring worker. The in-process integration option is documented and acknowledged to be riskier; prefer the external-process option to maintain isolation.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-network-diagnostics
  3. After installation, invoke the skill by name or use /openclaw-network-diagnostics
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
openclaw-network-diagnostics v0.1.1 - Updated `scripts/netdiag.py` (details not shown, likely minor or internal changes). - No changes to features, configuration, usage, or documentation. - No impact on main workflow or CLI arguments.
v0.1.0
Initial public release of OpenClaw Network Diagnostics - Introduces standalone network diagnostics worker for continuous end-to-end monitoring from OpenClaw agent to Telegram Bot API and simulated delivery to a Telegram client. - Provides CLI commands: `run`, `start`, `stop`, `status`, `validate-config`. - Delivers structured, rotating JSON logs with detailed network and API metrics. - Supports multiple delivery verification modes: Bot API acknowledgement, user reply, callback query. - Designed for strong isolation (runs independently from LLM/AIlow), with clear OpenClaw integration patterns. - Includes reference configuration, sample logs, and AI-based log analysis workflow documentation.
Metadata
Slug openclaw-network-diagnostics
Version 0.1.1
License
All-time Installs 1
Active Installs 1
Total Versions 2
Frequently Asked Questions

What is Openclaw Network Diagnostics?

Standalone advanced network diagnostics for OpenClaw to continuously test end-to-end connectivity from OpenClaw agent to Telegram Bot API and approximate del... It is an AI Agent Skill for Claude Code / OpenClaw, with 386 downloads so far.

How do I install Openclaw Network Diagnostics?

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

Is Openclaw Network Diagnostics free?

Yes, Openclaw Network Diagnostics is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Openclaw Network Diagnostics support?

Openclaw Network Diagnostics is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Openclaw Network Diagnostics?

It is built and maintained by h8kxrfp68z-lgtm (@h8kxrfp68z-lgtm); the current version is v0.1.1.

💬 Comments