--- name: pi-admin description: Raspberry Pi system administration. Monitor resources, manage services, perform updates and maintenance. metadata: {"clawdis":{"emoji":"🥧","requires":{"bins":[]}}} ---

Raspberry Pi Administration

Complete system monitoring and introspection for the Raspberry Pi host. Access network details, system resources, storage, services, and more.

When to Use

• Checking Pi network configuration (IP, Tailscale)
• Monitoring system resources (CPU, memory, storage)
• Viewing running services and their status
• Checking temperature and hardware info
• Troubleshooting system issues
• Getting system overview for debugging

Usage

# Information Commands
cd /home/srose/clawd/skills/pi-admin
./skill.sh overview
./skill.sh network
./skill.sh tailscale
./skill.sh resources
./skill.sh storage
./skill.sh services
./skill.sh hardware

# Maintenance Commands
./skill.sh update       # Update system packages
./skill.sh clean        # Clean unused packages, logs, Docker
./skill.sh reboot       # Reboot with countdown
./skill.sh restart-gateway  # Restart the Clawdis Gateway

# Complete system info
./skill.sh all

Tools Available

| Tool | Description | |------|-------------| | overview | Quick system summary | | network | IP addresses, hostname, network interfaces | | tailscale | Tailscale status, IP, peers | | resources | CPU, memory, temperature | | storage | Disk usage, mount points | | services | Running services, Gateway status | | hardware | CPU info, Raspberry Pi model, GPU | | all | Complete detailed dump |

Examples

# Quick system check
./skill.sh overview

# Debug network issues
./skill.sh network && ./skill.sh tailscale

# Check if Gateway is running
./skill.sh services | grep gateway

# Monitor disk space
./skill.sh storage

Information Collected

Network:

• Hostname
• Local IP addresses (eth0, wlan0)
• Network interface details
• DNS configuration

Tailscale:

• Status (running/stopped)
• Tailscale IP
• Connected peers
• Exit node status

Resources:

• CPU usage
• Memory usage (used/free/total)
• CPU temperature
• Uptime

Storage:

• Disk usage by mount point
• Inode usage
• Free space

Services:

• Gateway service status
• Docker containers
• Systemd services
• Port listeners

Hardware:

• CPU model and cores
• Raspberry Pi model
• GPU memory
• Total RAM

Maintenance Commands

update

Update system packages via apt:

• Updates package lists
• Shows upgradable packages
• Requires confirmation before upgrading
• Reports if reboot is needed
• Dry run: ./skill.sh update --dry-run shows what would be updated

clean

Clean up system to free disk space:

• Removes unused packages (autoremove)
• Clears package cache
• Cleans old journal logs (keeps 7 days)
• Optionally cleans Docker artifacts
• Shows space saved
• Dry run: ./skill.sh clean --dry-run shows what would be cleaned

reboot

Graceful system reboot:

• 10-second countdown
• Ctrl+C to cancel
• Uses systemctl reboot
• Dry run: ./skill.sh reboot --dry-run shows countdown without rebooting

restart-gateway

Restart the Clawdis Gateway service:

• Stops all running gateway processes
• Starts fresh gateway on port 18789
• Confirms port is listening
• Shows access URLs
• Dry run: ./skill.sh restart-gateway --dry-run shows what would happen

optimize

Apply safe system optimizations:

• Disable Bluetooth service (~50MB RAM saved)
• Disable ModemManager (~30MB RAM saved)
• Disable Avahi/Zeroconf (~20MB RAM saved)
• Set swappiness to 10 (better RAM utilization)
• Dry run: ./skill.sh optimize --dry-run shows what would change
• Undo: ./skill.sh optimize --undo reverts all changes

Total RAM savings: ~100MB Reversibility: Yes, use --undo flag to revert

Note: All maintenance commands require sudo and ask for confirmation before making changes. Use --dry-run flag to preview changes without applying them.