pc-assistant

# PC Assistant - Healthcheck Skill ## Overview This skill runs a comprehensive PC healthcheck that provides detailed system information along with actionable recommendations to fix any issues found. **Supports Windows, macOS, and Linux.** ## When to Use - User asks for a "PC healthcheck", "system check", or "diagnostics" - User wants to check storage, CPU, memory, GPU, or network - User asks "how is my PC doing?" or "is everything ok?" - User needs specific recommendations to fix issues (like low disk space) ## Requirements - **Platform**: Windows, macOS, or Linux (including WSL) - **Permissions**: Read-only for most checks - **Tools used**: Platform-specific system utilities ## Execute Healthcheck The skill automatically detects your OS and runs the appropriate script: ```bash ~/.npm-global/lib/node_modules/openclaw/skills/pc-assistant/scripts/healthcheck.sh # Linux/WSL ~/.npm-global/lib/node_modules/openclaw/skills/pc-assistant/scripts/healthcheck.ps1 # Windows ~/.npm-global/lib/node_modules/openclaw/skills/pc-assistant/scripts/healthcheck.command # macOS ``` Or use the convenience wrapper (auto-detects OS): ```bash ~/.npm-global/lib/node_modules/openclaw/skills/pc-assistant/scripts/run.sh ``` The script outputs: - `healthcheck_YYYYMMDD_HHMMSS.txt` - Full human-readable report with recommendations - `healthcheck_YYYYMMDD_HHMMSS.json` - JSON summary ## Platform-Specific Features ### Linux/WSL - System overview (OS, kernel, uptime) - Storage & disk (df, partitions, SMART) - Network (interfaces, routes, DNS, ports) - Processes & services (systemctl) - Users & security (SSH keys, failed logins) - Package management (apt, npm, pip) - Containers (Docker, Podman) - GPU info (nvidia-smi) - Hardware (USB, PCI, temperature) ### Windows (PowerShell) - System overview (Win32_OperatingSystem) - CPU & memory (Win32_Processor, Win32_OperatingSystem) - Storage (Win32_LogicalDisk) - Network adapters - Processes (Get-Process) - Services (Get-Service) - Installed software (registry) - Security (Firewall, Windows Defender) - Event logs ### macOS - System overview (sw_vers, system_profiler) - CPU & memory (vm_stat, sysctl) - Storage (diskutil) - Network (ifconfig, airport) - Processes (ps) - Launch agents & daemons - Security (Firewall, Gatekeeper, FileVault) - Homebrew packages - Battery status ## What the Healthcheck Captures | Section | Information | |---------|-------------| | **System Overview** | OS, kernel, uptime, user, shell | | **CPU** | Model, cores, speed, usage | | **Memory** | Total, free, used, percentage | | **Storage** | Disk usage, partitions, SMART status | | **Network** | Interfaces, IP addresses, DNS | | **Processes** | Top CPU/memory consumers | | **Services** | Running/stopped services | | **Security** | Firewall, antivirus status | | **Software** | Installed packages & apps | | **Hardware** | GPU, USB, temperature | | **Summary** | Health score + recommendations | ## Recommendations Included The report automatically includes specific recommendations when issues are detected: ### Storage Issues (High disk usage) - Specific folders to check - Platform-specific cleanup instructions - Docker/container cleanup commands ### Memory Issues - How to free up RAM - Which apps to close ### General Maintenance - System update commands - Security best practices ## Scheduling (Cron Jobs) The skill includes a scheduler script for automated periodic healthchecks: ### Quick Start ```bash # Run with defaults (saves to /tmp/pc-healthcheck-reports) ~/.npm-global/lib/node_modules/openclaw/skills/pc-assistant/scripts/schedule.sh # Custom output folder PC_ASSISTANT_OUTPUT_DIR="$HOME/Downloads/pc-assistant reports" \ ~/.npm-global/lib/node_modules/openclaw/skills/pc-assistant/scripts/schedule.sh ``` ### Configuration Options Create a config file at `~/.config/pc-assistant.conf`: ```bash # Output directory for reports PC_ASSISTANT_OUTPUT_DIR="$HOME/Downloads/pc-assistant reports" # Report filename prefix PC_ASSISTANT_REPORT_PREFIX="HealthCheck" # Days to keep old reports (default: 30) PC_ASSISTANT_KEEP_DAYS=30 # Enable automatic cleanup of old reports PC_ASSISTANT_CLEANUP=true ``` ### Environment Variables | Variable | Default | Description | |----------|---------|-------------| | `PC_ASSISTANT_OUTPUT_DIR` | `/tmp/pc-healthcheck-reports` | Where to save reports | | `PC_ASSISTANT_REPORT_PREFIX` | `HealthCheck` | Filename prefix | | `PC_ASSISTANT_KEEP_DAYS` | `30` | Days to keep reports | | `PC_ASSISTANT_CLEANUP` | `false` | Auto-delete old reports | | `PC_ASSISTANT_CONFIG` | `~/.config/pc-assistant.conf` | Config file path | ### Cron Job Example ```bash # Add to crontab (runs daily at midnight) 0 0 * * * PC_ASSISTANT_OUTPUT_DIR="$HOME/Downloads/pc-assistant reports" \ ~/.npm-global/lib/node_modules/openclaw/skills/pc-assistant/scripts/schedule.sh ``` ## Output Reports are saved to: - **Linux/WSL**: `/tmp/pc-healthcheck/` (or custom via config) - **Windows**: `$env:TEMP\pc-healthcheck\` (usually `C:\Users\...\AppData\Local\Temp\pc-healthcheck\`) - **macOS**: `/tmp/pc-healthcheck/` When using scheduler: `HealthCheck_YYYYMMDD_HHMMSS.txt` and `.json` ## Tips - The script is read-only and safe to run multiple times - Reports are timestamped for historical tracking - Use JSON output for integration with monitoring - Set `PC_ASSISTANT_CLEANUP=true` to auto-remove old reports