← Back to Skills Marketplace
207
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install traffic-monitor
Description
监控服务器指定网卡月度网络流量,定期生成使用报告并在流量超过80%阈值时提供警告。
Usage Guidance
This skill appears to do what it says: generate monthly traffic reports using vnstat and optionally show realtime cumulative stats. Before installing or running: 1) Ensure vnstat is installed and running (vnstat uses /var/lib/vnstat by default). 2) Be aware the included script writes state to /root/.openclaw/workspace/memory/traffic-state.json — if you run the agent as a non-root user you may need to change STATE_FILE in the script or run as a user with write permission to that path. 3) The script calls the local vnstat binary and reads /proc/net/dev only as a fallback (those are local operations; there are no external network calls). 4) If you want different interface, monthly limit, or state location, edit INTERFACE, MONTHLY_LIMIT_GB, or STATE_FILE in traffic_report.py. 5) If you need tighter review, verify the script contents yourself (it is short and straightforward) and confirm any automation (heartbeat) will run under an account that has permission to run vnstat and write the state file.
Capability Analysis
Type: OpenClaw Skill
Name: traffic-monitor
Version: 1.0.0
The traffic-monitor skill is a legitimate utility designed to track network usage via the standard 'vnstat' tool. The script traffic_report.py safely retrieves local interface statistics from /proc/net/dev and vnstat, uses a local JSON file for state persistence, and contains no evidence of data exfiltration, command injection, or malicious intent.
Capability Assessment
Purpose & Capability
Name and description claim monthly network traffic monitoring; the SKILL.md and traffic_report.py both use vnstat and /proc/net/dev to produce monthly and cumulative reports. The requested items (vnstat, systemctl commands) align with the stated purpose.
Instruction Scope
SKILL.md instructs the agent to run vnstat and the included script and to check vnstat service status — all within scope. Note: the script writes a state file at /root/.openclaw/workspace/memory/traffic-state.json (not mentioned in SKILL.md), and the fallback to /proc/net/dev is only a cumulative since-boot view (the code does avoid using it as monthly data). Running the script as a non-root user may fail to create or write the state file as currently configured.
Install Mechanism
No install spec (instruction-only with a single included script). Nothing is downloaded or written during install beyond running the provided script — low install risk.
Credentials
The skill requests no environment variables or credentials, which is appropriate. Minor mismatch: SKILL.md lists vnstat DB location (/var/lib/vnstat/vnstat.db) as vnstat's data store (expected), while the script independently stores state under /root/.openclaw/... — an internal state file path that may be surprising and requires write access.
Persistence & Privilege
always is false and model invocation is normal. The script persists its own small JSON state file but does not modify other skills or system-wide config. It does not request elevated privileges explicitly, though interacting with vnstat/systemctl or writing to /root may require root permissions.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install traffic-monitor - After installation, invoke the skill by name or use
/traffic-monitor - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Traffic Monitor Skill 1.0.0 — Initial Release
- Monitors monthly and daily server network traffic using vnstat.
- Provides monthly usage reports via a human-readable Python script.
- Alerts when usage exceeds 80% of the 2TB monthly limit.
- Includes quick reference for relevant commands and setup tips.
- Designed for persistent tracking and integration with heartbeat checks.
Metadata
Frequently Asked Questions
What is traffic-monitor?
监控服务器指定网卡月度网络流量,定期生成使用报告并在流量超过80%阈值时提供警告。 It is an AI Agent Skill for Claude Code / OpenClaw, with 207 downloads so far.
How do I install traffic-monitor?
Run "/install traffic-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is traffic-monitor free?
Yes, traffic-monitor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does traffic-monitor support?
traffic-monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created traffic-monitor?
It is built and maintained by binyuli (@binyuli); the current version is v1.0.0.
More Skills