树莓派系统运维
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-pi-admin。
技能介绍
当你只有 SSH,却要在 Pi 上「看清整机」
树莓派常被当作网关、内网服务或边缘节点,问题往往集中在:IP 和接口对不对、Tailscale 是否在跑、CPU/内存/温度是否异常、磁盘是否顶满、Gateway 或 Docker 是否在监听。在终端里逐条敲 ip、free、systemctl 既慢又容易漏项,维护动作(升级、清理、重启)若不做预览,也可能误伤生产中的网关进程。
技能如何组织信息
技能把内省拆成一组可读工具:overview 快速总览;network / tailscale 覆盖主机名、本地 IP、接口与 Tailscale 状态、对端、出口节点;resources 看 CPU、内存、温度与 uptime;storage 看挂载点、inode 与剩余空间;services 汇总 Gateway、Docker 与 systemd 监听端口;hardware 识别 Pi 型号、CPU 与 GPU 内存;all 输出完整 dump 便于贴进工单或日志。
维护侧通过 ./skill.sh 子命令完成 update(apt 列表与可升级包,需确认)、clean(autoremove、缓存、journal 保留 7 天、可选 Docker 清理)、reboot(10 秒倒计时可 Ctrl+C 取消)、restart-gateway(停旧进程并在 18789 端口拉起 Gateway、给出访问 URL)、optimize(可逆地关蓝牙/ModemManager/Avahi、调整 swappiness)。上述命令均要求 sudo,执行前会确认,且支持 --dry-run;optimize 还支持 --undo 回滚。
边界与注意点
这是单机 introspection + 安全维护脚本的范畴,不负责跨集群编排,也不替代你对业务流量的根因分析。变更类命令务必先 dry-run;optimize 会动 systemd 服务开关,若你依赖蓝牙或 mDNS,需自行评估是否执行或及时 undo。
使用场景
- Tailscale 远程连不上 Pi 时,先拉 tailscale/network 核对 VPN IP、对端与出口节点再改路由
- Gateway 页面 502 时,用 services 查 18789 是否监听,再用 restart-gateway 做可控重启
- 磁盘告警前用 storage 看各挂载点与 inode,再决定是否跑 clean 清 journal 与 apt 缓存
- 机器发热或卡顿排查时,用 resources 取 CPU 温度与内存,并用 services 列出 Docker/systemd
适合人员
- 在家用树莓派托管 Clawdis Gateway 的维护者,需要一次性确认端口、容器与 systemd 状态
- 经 Tailscale 管理家庭/边缘节点的运维者,改防火墙前要先留存 network 与 tailscale 快照
- Homelab 单机管理员,希望在 apt upgrade 或 optimize 关蓝牙前用 --dry-run 看清实际变更
- 用 Pi 做 7×24 轻量服务的开发者,故障时需要 all 级 dump 贴进 issue 或工单