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
CODEBLOCK0
Tools Available
| Tool | Description |
|---|
| INLINECODE0 | Quick system summary |
| INLINECODE1 |
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
CODEBLOCK1
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.
Raspberry Pi 管理
对树莓派主机进行完整的系统监控与信息探查。可访问网络详情、系统资源、存储、服务等信息。
使用场景
- - 查看树莓派网络配置(IP、Tailscale)
- 监控系统资源(CPU、内存、存储)
- 查看运行中的服务及其状态
- 检查温度和硬件信息
- 排查系统问题
- 获取系统概览用于调试
使用方法
bash
信息查询命令
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
维护命令
./skill.sh update # 更新系统软件包
./skill.sh clean # 清理未使用的软件包、日志、Docker
./skill.sh reboot # 带倒计时重启
./skill.sh restart-gateway # 重启 Clawdis 网关
完整系统信息
./skill.sh all
可用工具
| 工具 | 说明 |
|---|
| overview | 快速系统摘要 |
| network |
IP地址、主机名、网络接口 |
| tailscale | Tailscale状态、IP、对等节点 |
| resources | CPU、内存、温度 |
| storage | 磁盘使用情况、挂载点 |
| services | 运行中的服务、网关状态 |
| hardware | CPU信息、树莓派型号、GPU |
| all | 完整详细信息输出 |
示例
bash
快速系统检查
./skill.sh overview
排查网络问题
./skill.sh network && ./skill.sh tailscale
检查网关是否运行
./skill.sh services | grep gateway
监控磁盘空间
./skill.sh storage
收集的信息
网络:
- - 主机名
- 本地IP地址(eth0、wlan0)
- 网络接口详情
- DNS配置
Tailscale:
- - 状态(运行中/已停止)
- Tailscale IP
- 已连接的对等节点
- 出口节点状态
资源:
- - CPU使用率
- 内存使用情况(已用/空闲/总计)
- CPU温度
- 运行时间
存储:
- - 按挂载点查看磁盘使用情况
- inode使用情况
- 剩余空间
服务:
- - 网关服务状态
- Docker容器
- Systemd服务
- 端口监听
硬件:
维护命令
update
通过apt更新系统软件包:
- - 更新软件包列表
- 显示可升级的软件包
- 升级前需要确认
- 报告是否需要重启
- 预演: ./skill.sh update --dry-run 显示将要更新的内容
clean
清理系统以释放磁盘空间:
- - 移除未使用的软件包(autoremove)
- 清除软件包缓存
- 清理旧的日志记录(保留7天)
- 可选清理Docker工件
- 显示节省的空间
- 预演: ./skill.sh clean --dry-run 显示将要清理的内容
reboot
优雅的系统重启:
- - 10秒倒计时
- Ctrl+C取消
- 使用systemctl reboot
- 预演: ./skill.sh reboot --dry-run 显示倒计时但不重启
restart-gateway
重启Clawdis网关服务:
- - 停止所有运行中的网关进程
- 在端口18789上启动全新网关
- 确认端口正在监听
- 显示访问URL
- 预演: ./skill.sh restart-gateway --dry-run 显示将要执行的操作
optimize
应用安全的系统优化:
- - 禁用蓝牙服务(节省约50MB内存)
- 禁用ModemManager(节省约30MB内存)
- 禁用Avahi/Zeroconf(节省约20MB内存)
- 将swappiness设置为10(更好的内存利用率)
- 预演: ./skill.sh optimize --dry-run 显示将要更改的内容
- 撤销: ./skill.sh optimize --undo 还原所有更改
总内存节省: 约100MB
可逆性: 是,使用 --undo 标志可还原
注意: 所有维护命令都需要sudo权限,并在进行更改前要求确认。使用 --dry-run 标志可预览更改而不实际应用。