OpenClaw Gateway Guardian

OpenClaw 看门狗 - 自动监控 Gateway 状态，宕机时自动重启，支持配置守护和模型故障转移

Security Scan

The skill's code, runtime instructions, and requirements are consistent with a local Windows-focused OpenClaw gateway watchdog: it monitors a local port, can restart OpenClaw, backups config locally, and posts optional Feishu notifications.

Purpose & Capability

Name/description match what the files implement: the script monitors a local OpenClaw gateway port, attempts restarts, backs up/restores local OpenClaw config, optionally switches models, and sends Feishu notifications. Declared required binaries (python, openclaw) are appropriate and used by the code. There are no unrelated external service credentials requested.

Instruction Scope

SKILL.md instructions (copy files, run the Python script or run install.bat) align with the code. The runtime actions are local: checking TCP port, reading/writing files under the user's profile, launching/killing processes, and POSTing to a user-provided Feishu webhook. The script does read local OpenClaw logs and config (expected) and will kill processes on the gateway port (intended for restarting). It does not contain instructions to contact unknown external endpoints beyond the configured Feishu webhook.

Install Mechanism

No install spec is provided (instruction-only + included script). Installation is manual/copy-or-run via install.bat; nothing is downloaded from arbitrary URLs and no archives are extracted by the skill itself. This is a low-risk install pattern for this type of utility.

Credentials

The skill does not require environment secrets or external credentials in the registry metadata. The included config.json has placeholders for a Feishu webhook URL and an encryptKey for backups (both optional). Asking users to provide a webhook for notifications is proportionate; the script will send log snippets to that webhook if configured — this is expected behavior and should be configured only with a trusted webhook.

Persistence & Privilege

The skill can set up auto-start (the README/install will create a Windows scheduled task) and runs commands that kill/restart processes (netstat/taskkill). These are consistent with a watchdog but may require elevated permissions or affect other processes bound to the same port. The skill is not marked always:true and does not force inclusion in every agent run.

Assessment

This skill appears to do what it claims: monitor a local OpenClaw gateway, restart it, back up and restore local config, and optionally notify via Feishu. Before installing: 1) Review scripts/install.bat to see how the scheduled task is created (install will add an on-logon Task Scheduler entry). 2) Understand that the watchdog will attempt to kill processes using the gateway port (taskkill/netstat) — this can terminate unrelated processes if they bind the same port and may require elevated rights. 3) If you enable Feishu notifications, the script will post log snippets and alerts to the webhook you configure — only use a webhook you trust. 4) The backup files are stored locally and base64-encoded; set a proper backup encryptKey in config.json if you need encrypted backups (the default is a placeholder). 5) The script modifies your local OpenClaw config when performing failover/restore actions — review and test in a safe environment before deploying to production. Everything else (no hidden remote endpoints, no unexpected credential requests) looks consistent with the stated purpose.

<p align="center"> <img src="https://img.shields.io/badge/Python-3.8%2B-blue?style=for-the-badge&logo=python" alt="Python"> <img src="https://img.shields.io/badge/OpenClaw-2026.3%2B-green?style=for-the-badge" alt="OpenClaw"> <img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge" alt="License"> </p> <h1 align="center">🛡️ OpenClaw Gateway Guardian / OpenClaw 看门狗</h1> <p align="center"> <strong>自动监控 OpenClaw Gateway 状态，宕机时自动重启，支持配置守护和模型故障转移</strong><br> <em>Automatically monitor OpenClaw Gateway status, auto-restart on crash, with config guardian and model failover support.</em> </p>

---

✨ 功能特点 / Features

功能	说明
🏥 Gateway 监控	自动检测 Gateway 状态（每 15 秒）
🔄 自动重启	宕机 30 秒后自动重启（最多 3 次重试）
🛡️ 配置守护	监控配置文件变更，自动备份
🔀 模型故障转移	主模型失败时自动切换备用模型
📱 飞书通知	宕机/恢复/配置变更实时通知
🚀 开机自启动	通过 Windows 计划任务自动运行
💾 配置备份	自动备份配置文件，支持一键恢复

---

📦 安装 / Installation

方式一：安装脚本（推荐）

# 直接运行安装脚本
.\scripts\install.bat

方式二：手动安装

# 1. 创建看门狗目录
mkdir %USERPROFILE%\.openclaw\watchdog

# 2. 复制文件
copy scripts\* %USERPROFILE%\.openclaw\watchdog\

# 3. 配置（可选）
# 编辑 config.json 设置飞书 Webhook 等

# 4. 启动
python %USERPROFILE%\.openclaw\watchdog\watchdog_simple.py

---

⚙️ 配置 / Configuration

完整配置项

{
  "openclaw": {
    "exePath": "%USERPROFILE%\\AppData\\Roaming\\npm\\openclaw.cmd",
    "dataDir": "%USERPROFILE%\\.openclaw",
    "gatewayPort": 18789
  },
  "watchdog": {
    "checkIntervalMs": 15000,
    "maxDowntimeMs": 30000,
    "maxRetries": 3,
    "stopFlagPath": "%USERPROFILE%\\.openclaw\\stop.flag",
    "logDir": "%USERPROFILE%\\.openclaw\\watchdog\\logs"
  },
  "configGuardian": {
    "enabled": true,
    "checkIntervalSec": 60,
    "alertOnChange": true
  },
  "modelFailover": {
    "enabled": false,
    "primaryModel": "baiduqianfancodingplan/qianfan-code-latest",
    "fallbackModel": "custom-qianfan-baidubce-com/deepseek-v3.2"
  },
  "feishu": {
    "webhookUrl": "YOUR_FEISHU_WEBHOOK_URL"
  }
}

配置说明

配置项	类型	默认值	说明
openclaw.exePath	string	%USERPROFILE%\AppData\Roaming\npm\openclaw.cmd	OpenClaw 程序路径
openclaw.gatewayPort	number	18789	Gateway 端口
watchdog.checkIntervalMs	number	15000	检查间隔（毫秒）
watchdog.maxDowntimeMs	number	30000	最大宕机时间（毫秒）
watchdog.maxRetries	number	3	最大重试次数
configGuardian.enabled	boolean	true	启用配置守护
modelFailover.enabled	boolean	false	启用模型故障转移

飞书 Webhook 配置

1. 打开 https://open.feishu.cn/document/ukTMukTMukTM/uADOwUjLwgDM14CM4ATN
2. 创建自定义机器人
3. 复制 Webhook URL 到配置文件中

---

📖 使用方法 / Usage

自动模式（默认）

看门狗会自动监控 Gateway，宕机后自动重启。

# 启动看门狗
python watchdog_simple.py

命令行操作

# 查看状态
python watchdog_simple.py status
# 输出: Gateway Port 18789: UP

# 手动备份
python watchdog_simple.py backup

# 手动恢复
python watchdog_simple.py restore

手动控制

操作	命令
停止自动重启	type nul > %USERPROFILE%\.openclaw\stop.flag
恢复自动重启	del %USERPROFILE%\.openclaw\stop.flag

---

📁 文件结构 / File Structure

openclaw-watchdog/
├── SKILL.md                    # 技能说明文档
└── scripts/
    ├── watchdog_simple.py      # 主程序
    ├── config.json             # 配置文件
    └── install.bat             # 安装脚本

---

📊 日志 / Logs

• 主日志: %USERPROFILE%\.openclaw\watchdog\logs\guardian_YYYYMMDD.log
• 配置备份: %USERPROFILE%\.openclaw\watchdog\backup\

---

🔧 开机自启动 / Auto-start on Boot

安装时自动创建 Windows 计划任务：

schtasks /create /tn "OpenClaw Gateway Guardian" /tr "python %USERPROFILE%\.openclaw\watchdog\watchdog_simple.py" /sc onlogon /rl limited

---

🗑️ 卸载 / Uninstall

# 删除计划任务
schtasks /delete /tn "OpenClaw Gateway Guardian" /f

# 删除文件（可选）
rmdir /s %USERPROFILE%\.openclaw\watchdog

---

📝 更新日志 / Changelog

v1.1.0 (2026-03-26)

• ✨ 新增配置守护功能（监控配置文件变更）
• ✨ 新增模型故障转移支持
• ✨ 优化日志输出格式
• ✨ 增加更多标签（devops, monitoring, infrastructure）
• 🐛 修复多项 Bug

v1.0.0 (2026-03-20)

• 🎉 初始版本
• ✅ 基本的 Gateway 监控和自动重启
• ✅ 飞书通知支持
• ✅ 配置文件备份/恢复

---

📋 依赖 / Dependencies

• Python 3.8+
• OpenClaw 2026.3.22+

---

🤝 贡献 / Contributing

欢迎提交 Issue 和 Pull Request！

---

📄 许可证 / License

MIT License

---

<p align="center">🦐 感谢使用！有问题随时提问。</p> <p align="center">Thanks for using! Feel free to ask questions.</p>