设置

首次使用时，需说明计划在 ~/beszel/ 目录下使用的本地存储，并在创建或更新文件前向用户请求确认。

适用场景

当用户需要协助规划、部署或维护用于基础设施监控的 Beszel 时使用。 Agent 负责处理拓扑选型、安全 Agent 接入、告警校准以及支持平滑升级的操作流程。

架构

记忆数据存储于 ~/beszel/ 目录中。具体初始化方式请参阅 memory-template.md。

~/beszel/
├── memory.md                  # 当前环境状态、目标与优先级
├── nodes.md                   # Agent 清单及归属信息
├── alerts.md                  # 告警阈值与升级通知目标
└── incidents.md               # 事件时间线与恢复记录

快速参考

数据存储

所有技能相关文件均存于 ~/beszel/ 目录中。 在写入新文件前，须先汇总拟变更内容并获得用户明确确认。

核心规则

1. 安装前明确定义监控范围

• 在推荐部署结构前，须确认哪些主机、服务及故障模式最为关键。
• 优先覆盖高影响系统，确保上线首日即具备实质性监控能力。

2. 最小化 Agent 访问权限

• 对被监控主机采用最小权限原则；默认避免大范围 root 级自动化操作。
• 将接入凭证视为敏感信息，禁止将密钥类凭据复制到 workspace 笔记中。

3. 先建立基线，再调优告警

• 应用严格阈值前，应先采集一段短期运行基线数据。
• 结合业务时段、维护窗口及预期流量突发模式等实际运行上下文调优告警级别。

4. 按固定顺序排查问题

• 始终按服务状态 → Agent 连通性 → 时钟同步 → 资源压力的顺序验证。
• 每次仅隔离一个变量，避免在活跃事件中同时修改多个因素。

5. 确保升级操作可回滚

• 版本变更前必须包含备份与回滚步骤。
• 逐环境升级，并在确认健康状态后，再推进至更广范围。

6. 持续更新运维记忆

• 在发生重要变更后，及时记录节点归属、告警意图及历史事件。
• 将重复发生的事件转化为预防性规则，并相应调整阈值。

常见陷阱

• 未定义告警责任人即批量接入 Agent → 导致告警泛滥且响应职责不清。
• 直接复用其他环境的阈值 → 频繁误报或漏报真实故障。
• Hub 与 Agent 同步升级 → 引发难以调试的版本不匹配问题。
• 忽略主机时钟漂移 → 导致时间线失真、事件分析混乱。
• 在笔记中记录敏感凭据 → 造成非必要的安全暴露。

安全与隐私

可能离开您本地机器的数据（仅当用户主动配置外部集成时）：

• 发送至选定通道或告警工具的监控通知。
• 用户所选外部通知端点所需的元数据。

默认仅保留在本地的数据：

• 存储于 ~/beszel/ 中的监控拓扑、节点备注、阈值历史与事件日志。

本技能明确不执行以下操作：

• 自动启用外部告警目的地。
• 未经用户显式授权创建新凭据。
• 发起任何未声明的网络请求。

相关技能

若用户确认，可通过 clawhub install 安装：

• monitoring — 监控架构与运维规范
• server — 服务器诊断与日常维护工作流
• self-host — 自托管部署与加固实践
• docker — 容器运行时与镜像管理规范
• docker-compose — 多服务编排模式

反馈

• 如觉得有用：clawhub star beszel
• 保持更新：clawhub sync