OpenClaw Watchdog
监控 OpenClaw Gateway 运行状态，支持多通道检测和自动恢复。
核心功能
- 进程检测：使用 systemd + 端口 + 进程名三重检测，避免误报
- 通道监控：飞书、企业微信、微信通道的 session 过期和错误检测
- 网络检测：百度/阿里 DNS 连通性检测
- 自动重启：最多 2 次重启，10 分钟冷却窗口
- 代理管理：网络异常时自动禁用系统代理
使用方式
手动运行
bash /path/to/openclaw-watchdog/scripts/watchdog.sh [interval]
# interval: 检测间隔（秒），默认 300（5分钟）
Systemd 服务部署
[Unit]
Description=OpenClaw Watchdog
After=network-online.target
[Service]
ExecStart=/bin/bash /path/to/openclaw-watchdog/scripts/watchdog.sh 300
Restart=always
RestartSec=10
[Install]
WantedBy=default.target
部署命令：
systemctl --user enable openclaw-watchdog.service
systemctl --user start openclaw-watchdog.service
配置参数（环境变量）
| 变量 | 默认值 | 说明 |
|---|---|---|
LOG_FILE |
/tmp/openclaw_watchdog.log |
日志文件路径 |
PID_FILE |
/tmp/openclaw_gateway.pid |
Gateway PID 文件 |
MAX_RESTARTS |
2 |
最大重启次数 |
RESTART_WINDOW |
600 |
重启窗口（秒） |
OPENCLAW_PORT |
18789 |
Gateway 端口 |
日志文件
- 主日志：
/tmp/openclaw_watchdog.log - Gateway 日志：
/tmp/openclaw_gateway.log - 通道暂停状态文件：
/tmp/openclaw_feishu_paused/tmp/openclaw_wecom_paused/tmp/openclaw_weixin_paused/tmp/openclaw_proxy_disabled
通道错误识别
| 通道 | 错误关键词 | 说明 |
|---|---|---|
| 飞书 | feishu.*error, lark.*error, session.*expired |
session 过期需等待 |
| 企业微信 | wecom.*error, wechat.*work.*error |
服务端错误 |
| 微信 | errcode.*-14, session.*expired |
暂停 60 分钟自动恢复 |
注意事项
- 微信 errcode -14 是微信官方限制，看门狗只能记录状态，无法提前解除
- 飞书/企业微信 token 过期需手动刷新授权
- 频繁重启可能导致通道被微信封禁，发现后会自动停止重启