Gateway Monitor

Provides real-time monitoring, log search, service status, alerts, and one-click config restore for OpenClaw Gateway and related services.

Gateway Monitor - OpenClaw 监控面板

实时监控 OpenClaw Gateway 状态、日志检索、服务健康检查的一站式监控面板。

功能特性

• 实时监控：Gateway 运行状态、资源使用、会话上下文
• 日志检索：错误/警告高亮，支持关键字搜索和过滤
• 服务状态：launchd 服务、LiteLLM、oMLX、acpx
• LiteLLM 按需唤起：默认可保持停止，支持自动唤起或手动唤起/停止
• 告警系统：基于错误频率、资源消耗的自动告警
• 一键还原：配置出错时可从备份恢复
• 皮肤主题：深色 / 浅色 / 跟随系统，响应式布局

快速开始

安装

bash

# 克隆项目
git clone https://github.com/yes999zc/gateway-monitor.git
cd gateway-monitor

# 无需依赖，直接运行
node server.js

# 浏览器访问
open http://127.0.0.1:18990

环境变量配置

bash

# 可选配置
export PORT=18990                      # 服务端口（默认 18990）
export OMLX_MODELS_URL=http://127.0.0.1:9981/v1/models  # oMLX 模型端点
export OMLX_API_KEY=8888               # oMLX API 密钥
export LITELLM_BASE_URL=http://127.0.0.1:4000  # LiteLLM 端点
export LITELLM_CONTAINER_NAME=litellm-omlx  # LiteLLM docker 容器名
export LITELLM_AUTO_WAKE_DEFAULT=0     # 是否默认自动唤起（0/1）

API 端点

• GET / - 仪表盘页面
• GET /api/summary - 聚合状态快照
• GET /api/logs - 日志列表
• GET /api/gateway-status - Gateway 状态
• GET /api/launchd-status - launchd 服务状态
• GET /api/restore-config?confirm=true - 恢复配置
• GET /api/gateway-restart?confirm=true - 重启 Gateway
• GET /api/litellm-status?autoWake=1 - LiteLLM 状态（可自动唤起）
• GET /api/litellm-control?action=wake|start|stop|restart&confirm=true - 控制 LiteLLM 容器
• GET /api/omlx-capabilities - oMLX 能力检测（模型/VLM/Embedding/Rerank）
• GET /api/litellm-wake - LiteLLM 按需唤起
• GET /api/omlx-update?check=1 - 检查 oMLX 更新

监控面板截图

使用场景

1. Gateway 健康检查：实时监控 Gateway 运行状态、token 使用情况
2. 日志排查：快速定位错误日志，支持关键字搜索
3. 配置恢复：配置出错时一键从备份恢复
4. 服务管理：LiteLLM、oMLX 等服务状态监控与控制

安全说明

• 密钥脱敏显示：API key 首尾保留，中间用 *** 填充
• 恢复配置需要二次确认（前端弹窗 + URL 参数）
• 重启 Gateway 需要二次确认

后台运行

bash

# 使用 launchd 托管（推荐）
cp bin/ai.openclaw.gateway-monitor.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/ai.openclaw.gateway-monitor.plist

# 手动后台运行
nohup node server.js > gateway-monitor.log 2>&1 &

更新日志

v1.0.1

• 改进 UI 界面设计
• 新增快照捕获功能
• 增强监控能力检测

v1.0.0

• 初始发布
• Gateway 状态监控
• 日志检索与告警系统
• 一键配置恢复

许可证

MIT License

贡献

欢迎提 Issue 和 PR！