了解 OpenClaw Nexus‑Safe 技能：自主本地系统可靠性代理

Source: Dev.to

OpenClaw 项目汇集了一系列可复用的自动化技能，简化日常运维任务。
其中，Nexus‑Safe 技能作为专用的本地系统可靠性代理尤为突出。它的主要目的在于：

• 监控主机的健康状态，
• 提供可操作的诊断信息，且
• （在明确授权的情况下）执行恢复操作，例如重启出现问题的服务。

由于它完全在本地运行，Nexus‑Safe 确保任何指标、日志或系统数据都不会离开服务器——这使其非常适合对隐私或合规性要求严格的环境。

什么是 Nexus‑Safe？

Nexus‑Safe 以单个 Markdown 文件（SKILL.md）的形式打包在 OpenClaw 技能仓库中。该文件描述了一项可以加载到 OpenClaw 代理并通过斜杠命令调用的技能。

在 1.3.0 版本中，技能提供了三条主要命令：

• /nexus-safe status – 健康快照
• /nexus-safe logs – 最近日志
• /nexus-safe recover – 安全恢复

每条命令都轻量、依赖最小，并默认安全。该技能依赖广泛可用的 psutil Python 库来获取系统指标，并假设 Docker 和 PM2 已经在主机的 PATH 中，以便进行容器和进程管理。

隐私与安全政策

• 所有数据收集和处理均在本地进行。
• 初始设置阶段后不进行任何外部网络调用（该阶段仅需要通过 pip 下载 psutil 包以获取互联网访问）。
• 敏感信息，如 CPU 使用率、内存消耗、磁盘 I/O 和服务日志，绝不会通过网络传输。
• 恢复操作默认已禁用；必须由管理员显式启用，以降低意外服务中断的风险。

核心功能

/nexus-safe status

提供系统健康的实时快照，报告包括：

• CPU 使用率
• 内存使用情况
• 磁盘空间
• 负载平均值

输出格式化为在终端或聊天界面中易于阅读，帮助运维人员快速判断主机是否在正常参数范围内运行。

/nexus-safe logs

从 Docker 容器和 PM2 管理的 Node.js 进程中检索诊断日志。
该命令聚合最近的日志条目并按时间顺序呈现，帮助定位错误、警告或异常行为。

/nexus-safe recover

如果日志显示可恢复的故障且运维人员在最近五分钟内已审阅这些日志，则此命令可以重启受影响的服务。
重启仅针对预先定义的白名单中的服务执行，以确保关键或不相关的进程不会被误触。

逻辑与执行

Nexus‑Safe 包含若干防护措施，以防止滥用或意外的恢复操作。

必须使用白名单

两个环境变量定义白名单：

• NEXUS_SAFE_ALLOWED_DOCKER – 以逗号分隔的 Docker 容器名称列表
• NEXUS_SAFE_ALLOWED_PM2 – 以逗号分隔的 PM2 进程名称列表

如果服务未列在其中，recover 命令将拒绝执行，并记录拒绝日志以供审计。

先日志后操作策略

在允许任何重启之前，skill 会检查通过 /nexus-safe logs 最近一次获取日志的时间戳。
如果自日志检查已超过 五分钟，则阻止 recover 命令。这迫使操作员先审阅当前状态信息，降低基于过时数据操作的风险。

速率限制

为防止重启循环失控，Nexus‑Safe 实施滑动窗口限制，每小时最多三次重启。每次成功恢复都会递增计数器；一旦达到阈值，进一步的尝试将被忽略，直至窗口向前移动。

安装步骤

1. Python – 确保主机上已安装 Python 3.8 或更高版本。

2. psutil – 安装依赖：

   pip install psutil

   （此步骤仅需要互联网访问。）

3. Docker & PM2 – 验证二进制文件已在系统 PATH 中：

   docker --version
   pm2 --version

4. 获取技能 – 克隆 OpenClaw 技能仓库或将 Nexus‑Safe 的 SKILL.md 文件复制到本地技能目录。

5. 加载技能 – 按照 OpenClaw 代理的文档（通常是配置文件或动态加载命令）加载该技能。

6. 配置白名单 – （可选）设置环境变量 NEXUS_SAFE_ALLOWED_DOCKER 和 NEXUS_SAFE_ALLOWED_PM2，以指定哪些服务可以被重启。

7. 重启代理 – 重启 OpenClaw 代理以激活新技能。

验证 – 在聊天界面中调用 /nexus-safe status。如果返回健康摘要，则说明技能已正确加载并正常工作。

使用示例

检查系统健康

/nexus-safe status

典型输出：

CPU: 23% | RAM: 4.2GB / 7.8GB (54%) | Disk: 120GB / 500GB (24%) | Load: 0.45, 0.38, 0.30

获取最近日志

/nexus-safe logs

该命令返回每个相关 Docker 容器和 PM2 进程的最近 20 行日志，按时间顺序排列。

执行恢复

/nexus-safe recover

只有在以下条件满足时，命令才会成功：

1. “ 在相应的白名单中。
2. 在最近五分钟内已获取日志。
3. 未超过每小时重启限制。

允许的 Docker 容器和 PM2 进程

明确标注服务名称。

执行受控重启

假设您刚刚查看了名为 web‑app 的容器日志，并且它在白名单中，您可以运行：

/nexus-safe recover

该指令将：

1. 验证 先查看日志 条件。
2. 检查速率限制器。
3. 发出 docker restart web‑app 命令。

系统会发布确认信息，指示成功或失败的原因。

操作 Nexus‑Safe 的最佳实践

• 定义准确的白名单。 只包含已知可以安全自动重启的服务。
• 定期轮换白名单，以反映服务架构的变化。
• 安排定期的手动日志审查，即使没有明显的事件；这可以满足 “日志优先” 的计时要求，并帮助你熟悉正常的日志模式。
• 监控技能自身的日志（如果你的 OpenClaw 代理提供这些日志），以确保速率限制或白名单拒绝不会意外阻止所需的操作。
• 将 Nexus‑Safe 与更广泛的可观测性工具结合使用。 虽然它能快速提供本地洞察，但与集中监控集成可以实现趋势分析和长期容量规划。
• 保持 psutil 包为最新，以受益于性能改进和安全补丁。

常见问题排查

技能未响应

如果斜杠命令没有返回响应，首先确认技能文件已正确放置在代理的 skills 目录中，并且在安装后已重新加载代理。检查代理日志中是否有与 psutil 相关的导入错误。

日志命令无输出

如果 Docker 或 PM2 未在 PATH 中，或白名单变量为空，可能会出现这种情况。验证以下命令：

which docker
which pm2

返回有效路径，并确保在启动代理之前已导出环境变量。

恢复命令被阻止

最常见的原因包括：

• 在过去五分钟内未检查日志 – 请先运行 /nexus-safe logs。
• 目标服务未在白名单中 – 将其添加到相应的环境变量。
• 已超过每小时速率限制 – 请等待窗口重置，或在运营策略允许的情况下调整限制。

结论

Nexus‑Safe 技能展示了 OpenClaw 如何利用简单的、本地优先自动化，在不牺牲隐私或安全的前提下提升系统可靠性。通过提供清晰的健康诊断、强制执行以日志为先的恢复工作流，以及应用强大的速率限制和白名单控制，Nexus‑Safe 使运营者能够自信且安全地操作。

它的依赖最小，仅需 psutil、Docker 和 PM2，因而能够轻松部署在各种基于 Linux 的主机上，从普通的边缘设备到强大的生产服务器皆可。对于希望在严格的数据隐私约束下保持服务健康、并寻找可信赖的自包含工具的团队而言，Nexus‑Safe 在 OpenClaw 生态系统中脱颖而出，成为即插即用的解决方案。

技能可在以下位置找到: safe/SKILL.md