树莓派系统管理

技能简介

pi-admin 是一套面向 Raspberry Pi 主机的系统管理脚本集合，提供网络状态查看、资源监控、存储检查、服务管理及系统维护等功能。通过命令行快速获取 Pi 的完整运行状况，支持日常巡检与故障排查。

业务背景

运维团队常需远程管理分散部署的树莓派设备，人工登录排查效率低。该工具通过标准化脚本实现一键巡检，快速掌握网络连通、资源负载、存储健康等关键状态，及时发现温度异常、磁盘爆满等隐患，减少现场维护成本，保障边缘节点稳定运行。

落地案例：某零售企业在200家门店部署树莓派作为门店网关。运维人员每日通过SSH执行系统检查脚本，批量获取各节点IP配置、CPU温度及Docker容器状态；发现某门店磁盘使用率超90%时，远程执行清理命令释放空间，避免业务中断。

能做什么

• 查看网络配置：IP 地址、主机名、Tailscale 状态
• 监控系统资源：CPU、内存、温度、运行时长
• 检查存储空间：磁盘用量、挂载点、inode 使用
• 管理服务状态：Gateway 进程、Docker 容器、systemd 服务
• 执行维护操作：系统更新、清理垃圾、重启设备
• 获取硬件信息：CPU 型号、Pi 型号、GPU 内存

使用说明

安装步骤

1. 克隆或下载技能仓库到本地目录
2. 进入技能目录：cd /home/srose/clawd/skills/pi-admin
3. 确保脚本可执行：chmod +x skill.sh

常用命令

# 信息查询
./skill.sh overview      # 系统概览
./skill.sh network       # 网络详情
./skill.sh tailscale     # Tailscale 状态
./skill.sh resources     # CPU/内存/温度
./skill.sh storage       # 磁盘使用
./skill.sh services      # 服务状态
./skill.sh hardware      # 硬件信息
./skill.sh all           # 完整信息输出

# 维护操作（需 sudo）
./skill.sh update        # 更新系统包
./skill.sh clean         # 清理无用包、日志、Docker
./skill.sh reboot        # 倒计时重启
./skill.sh restart-gateway   # 重启 Gateway 服务
./skill.sh optimize      # 系统优化（可撤销）

安全提示：所有维护命令均要求确认，可使用 --dry-run 预览变更，optimize --undo 可回滚优化。

输入与输出

见下方输入与输出表格。

风险提示

• 维护命令需要 sudo 权限，操作前请确认当前环境
• reboot 命令有 10 秒倒计时，期间可按 Ctrl+C 取消
• clean 命令会删除旧日志（保留 7 天），请确认无重要日志需求
• optimize 修改系统服务配置，建议先 dry-run 测试
• restart-gateway 会中断现有连接，生产环境谨慎使用

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/thesethrose/pi-admin/SKILL.md
来源类型：GitHub 仓库