A comprehensive system diagnostics and health check tool for Linux servers that generates detailed reports in terminal, HTML, or JSON formats.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install sys-doctor
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install sys-doctor using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is System Doctor (sys-doctor)?
System Doctor, also known as sys-doctor, is a robust diagnostic utility designed for real-time server monitoring and health assessment. As a featured part of the Openclaw Skills ecosystem, it provides developers and system administrators with an immediate overview of critical system metrics including disk occupancy, memory utilization, CPU load, and network interface status.
Built specifically for Linux environments, sys-doctor leverages native system tools and the /proc/ file system to deliver accurate telemetry without requiring external API dependencies. Whether you are troubleshooting performance bottlenecks or conducting a routine audit of running services, this skill ensures you have the technical visibility needed to maintain a healthy infrastructure.
System Doctor (sys-doctor) Use Cases
- Performing instant server health audits and resource usage checks.
- Diagnosing performance issues and CPU bottlenecks in production environments.
- Generating automated system health reports for persistent monitoring.
- Inspecting disk space across all mounted volumes to prevent storage-related outages.
- Troubleshooting network connectivity and auditing active system services.
How System Doctor (sys-doctor) Works
- The skill executes native Linux commands such as df, free, ip, and systemctl to gather raw system telemetry.
- It parses the /proc/ filesystem to extract granular CPU load and memory statistics.
- The diagnostic engine applies health status logic to determine if system thresholds (e.g., disk usage above 80%) require warning or critical alerts.
- Collected data is aggregated and formatted based on the user's requested output: standard terminal text, structured JSON, or a styled HTML report.
- The tool returns specific exit codes (0 for OK, 2 for Critical) to allow for integration with broader automation workflows.
System Doctor (sys-doctor) Setup
To get started with this entry in the Openclaw Skills collection, ensure you are on a Linux-based system. For macOS support, the psutil library is required.
# Standard execution
python3 skills/sys-doctor/scripts/sys_doctor.py
# For macOS users, install dependencies first
pip install psutil
System Doctor (sys-doctor) Data Schema & Taxonomy
The sys-doctor skill organizes data into logical categories based on system subsystems. It supports structured metadata for easy parsing by other Openclaw Skills.
| Data Category | Key Metrics Captured |
|---|---|
| DISK | Mount points, percentage used, total size, available space |
| MEMORY | RAM usage, Swap usage, utilization percentages |
| CPU | Load averages (1/5/15 min), core count, logical processor count |
| NETWORK | Interface names, operational status (UP/DOWN), IP addresses |
| SERVICES | Status of critical systemd units like nginx, docker, and sshd |
System Doctor (sys-doctor) Advanced Features
- Multi-format reporting: Generate styled HTML reports or raw JSON for integration with custom dashboards.
- Granular filtering: Use flags like
--check diskor--check networkto isolate specific diagnostic scopes. - Exit code signaling: Integration-ready logic that triggers a critical status when disk usage exceeds 90%.
- Offline operation: Zero external API calls ensures data privacy and functionality in air-gapped environments.
- Automated file naming: The
--reportflag generates timestamped files for historical tracking.
SKILL.md
Loading
Related Openclaw Skills
BrickLink AFOL Skill
A professional-grade CLI integration for the BrickLink API that enables automated Lego inventory management, order processing, and market data retrieval.
BrickEconomy AFOL Skill
A professional-grade LEGO valuation and investment tracking tool that integrates BrickEconomy API data directly into your AI agent workflow.
BrickEconomy LEGO Asset Analysis
A comprehensive LEGO valuation and portfolio analysis skill that leverages the BrickEconomy API to track set performance and investment ROI.
AFOL Meta Skill
A sophisticated orchestration layer that routes broad LEGO collector queries to the ideal provider for cataloging, valuation, and marketplace data.
API Tester
A lightweight Python-based toolkit for testing, validating, and benchmarking REST API endpoints without external dependencies.
Backup Rotator
A robust Python-based tool for managing automated backup rotation, retention policies, and file integrity verification.
Featured*
