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#

SectionInformationSystem OverviewOS, kernel, uptime, user, shellCPUModel, cores, speed, usageMemoryTotal, free, used, percentageStorageDisk usage, partitions, SMART statusNetworkInterfaces, IP addresses, DNSProcessesTop CPU/memory consumersServicesRunning/stopped servicesSecurityFirewall, antivirus statusSoftwareInstalled packages & appsHardwareGPU, USB, temperatureSummaryHealth 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#

VariableDefaultDescriptionPC_ASSISTANT_OUTPUT_DIR``/tmp/pc-healthcheck-reportsWhere to save reportsPC_ASSISTANT_REPORT_PREFIX``HealthCheckFilename prefixPC_ASSISTANT_KEEP_DAYS``30Days to keep reportsPC_ASSISTANT_CLEANUP``falseAuto-delete old reportsPC_ASSISTANT_CONFIG``~/.config/pc-assistant.confConfig 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