Raspberry Pi 管理

为 Raspberry Pi 主机提供完整的系统监控与自省能力。可查看网络配置、系统资源、存储状态、运行服务等信息。

适用场景

• 检查 Pi 的网络配置（IP 地址、Tailscale）
• 监控系统资源使用情况（CPU、内存、存储）
• 查看正在运行的服务及其状态
• 检查设备温度与硬件信息
• 排查系统故障
• 获取系统概览以辅助调试

使用方法

# 信息查询命令
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 Gateway

# 获取完整系统信息
./skill.sh all

可用工具

示例

# 快速系统检查
./skill.sh overview

# 调试网络问题
./skill.sh network && ./skill.sh tailscale

# 检查 Gateway 是否正在运行
./skill.sh services | grep gateway

# 监控磁盘空间
./skill.sh storage

采集的信息

网络：

• 主机名
• 本地 IP 地址（eth0、wlan0）
• 网络接口详情
• DNS 配置

Tailscale：

• 状态（运行中/已停止）
• Tailscale IP 地址
• 已连接的对端节点（peers）
• 出口节点（exit node）状态

资源：

• CPU 使用率
• 内存使用情况（已用/空闲/总量）
• CPU 温度
• 系统运行时间（uptime）

存储：

• 各挂载点的磁盘使用情况
• Inode 使用情况
• 剩余可用空间

服务：

• Gateway 服务状态
• Docker 容器列表
• systemd 服务状态
• 监听端口列表

硬件：

• CPU 型号与核心数
• Raspberry Pi 型号
• GPU 内存大小
• 总 RAM 容量

维护命令

update

通过 apt 更新系统软件包：

• 更新软件包索引列表
• 列出可升级的软件包
• 升级前需手动确认
• 提示是否需要重启系统
• 模拟运行： ./skill.sh update --dry-run 显示将要执行的更新操作

clean

清理系统以释放磁盘空间：

• 移除未使用的软件包（autoremove）
• 清空软件包缓存
• 清理旧的 journal 日志（保留最近 7 天）
• 可选：清理 Docker 相关产物（镜像、容器、卷等）
• 显示释放的空间大小
• 模拟运行： ./skill.sh clean --dry-run 显示将要清理的内容

reboot

安全地重启系统：

• 10 秒倒计时
• 按 Ctrl+C 可取消重启
• 底层调用 systemctl reboot
• 模拟运行： ./skill.sh reboot --dry-run 仅显示倒计时，不实际重启

restart-gateway

重启 Clawdis Gateway 服务：

• 终止所有正在运行的 gateway 进程
• 在端口 18789 上启动全新的 gateway 实例
• 验证目标端口是否处于监听状态
• 显示可访问的 URL 列表
• 模拟运行： ./skill.sh restart-gateway --dry-run 显示将要执行的操作

optimize

应用安全的系统优化措施：

• 禁用 Bluetooth 服务（约节省 50MB RAM）
• 禁用 ModemManager（约节省 30MB RAM）
• 禁用 Avahi/Zeroconf（约节省 20MB RAM）
• 将 swappiness 设为 10（提升内存利用效率）
• 模拟运行： ./skill.sh optimize --dry-run 显示将要变更的配置项
• 回滚操作： ./skill.sh optimize --undo 恢复所有已更改的设置

总计 RAM 节省量： 约 100MB
是否可逆： 是，使用 --undo 参数即可全部还原

注意： 所有维护命令均需 sudo 权限，并在执行变更前请求用户确认。可通过添加 --dry-run 参数预览操作效果，而不会实际应用任何更改。