OpenClaw Toolbox

🧰 一站式 OpenClaw 运维工具箱 - 监控、告警、备份、Web Dashboard

📋 目录

• 特性
• 架构
• 快速开始
• 工具说明
• 配置
• 开发

✨ 特性

工具	功能	说明
🔍 Watchdog	Gateway 自检 + 自动重启	防止服务崩溃
🔄 Version Check	自动检测新版本 + 自动升级	版本管理
🤝 Partner Watchdog	双机互备监控	高可用架构
📊 Token Alert	Token 使用率告警	成本控制
💾 Auto Backup	自动备份关键配置	数据安全
📋 View Logs	统一日志查看	快速调试
🖥️ Web Dashboard	实时监控面板	可视化管理

🏗️ 架构

┌─────────────────────────────────────────────────────────┐
│                    OpenClaw Toolbox                       │
├─────────────────────────────────────────────────────────┤
│                                                         │
│   ┌──────────────┐    ┌──────────────┐               │
│   │   Watchdog   │    │Partner Watchdog│              │
│   │  (Gateway)   │    │  (双机互备)   │              │
│   └──────────────┘    └──────────────┘               │
│                                                         │
│   ┌──────────────┐    ┌──────────────┐               │
│   │Token Alert   │    │Auto Backup   │               │
│   │ (成本控制)    │    │  (数据安全)  │              │
│   └──────────────┘    └──────────────┘               │
│                                                         │
│   ┌──────────────┐                                    │
│   │ View Logs    │                                    │
│   │  (调试)      │                                    │
│   └──────────────┘                                    │
│                                                         │
├─────────────────────────────────────────────────────────┤
│                    通知渠道                              │
│   ┌────────┐ ┌────────┐ ┌────────┐                  │
│   │Telegram │ │  Email │ │ System │                  │
│   └────────┘ └────────┘ └────────┘                  │
└─────────────────────────────────────────────────────────┘

🚀 快速开始

一键安装

# 从 GitHub 安装
curl -sL https://raw.githubusercontent.com/SonicBotMan/openclaw-toolbox/main/scripts/install.sh | bash

# 或克隆安装
git clone https://github.com/SonicBotMan/openclaw-toolbox.git
cd openclaw-toolbox && bash scripts/install.sh

OpenClaw 远程部署

在你的 OpenClaw 对话中发送：

部署 openclaw-toolbox

🔧 工具说明

1. Watchdog 监控

# 启动监控
systemctl --user start openclaw-watchdog.timer

# 查看状态
systemctl --user status openclaw-watchdog.timer

# 查看日志
tail -f /tmp/openclaw-watchdog.log

# 手动检查
~/openclaw-watchdog.sh

2. Partner Watchdog 互备监控

# 配置对方 IP
echo "PARTNER_IP=192.168.11.xxx" > ~/.openclaw/workspace/config/partner.conf

# 启动互备监控
~/partner-watchdog.sh &

3. Token 告警

# 手动检查
~/token-alert.sh

# 添加定时任务
*/30 * * * * ~/token-alert.sh >> /tmp/token-alert.log 2>&1

4. 自动备份

# 手动备份
~/auto-backup.sh

# 查看备份
ls -la ~/.openclaw/backups/

5. 统一日志查看

# 查看所有日志
~/view-logs.sh

# 实时监控
watch -n 5 ~/view-logs.sh

6. Web Dashboard 🖥️ NEW!

# 启动 Dashboard
cd openclaw-toolbox
bash scripts/start-dashboard.sh

# 访问
open http://localhost:3100

# 停止
bash scripts/stop-dashboard.sh

Dashboard 功能：

• ✅ Gateway 状态实时监控
• ✅ Watchdog 监控状态
• ✅ 磁盘/Token 使用率可视化
• ✅ 一键自动修复
• ✅ 系统日志查看
• ✅ 每 5 秒自动刷新

⚙️ 配置

配置文件位置

~/.openclaw/workspace/config/
├── watchdog.json      # Watchdog 配置
├── partner.conf      # 互备监控配置
└── telegram.conf    # Telegram 通知配置

Telegram 通知配置

# 创建配置文件
mkdir -p ~/.openclaw/workspace/config
echo "BOT_TOKEN=your_bot_token" > ~/.openclaw/workspace/config/telegram.conf
echo "CHAT_ID=your_chat_id" >> ~/.openclaw/workspace/config/telegram.conf

# 测试发送
curl -X POST "https://api.telegram.org/bot<BOT_TOKEN>/sendMessage" \
  -d "chat_id=<CHAT_ID>" \
  -d "text=OpenClaw Toolbox 测试消息"

📊 性能影响

工具	CPU	内存	磁盘 I/O
Watchdog	< 1%	< 10MB	极低
Partner Watchdog	< 0.5%	< 5MB	极低
Token Alert	< 0.1%	< 2MB	无
Auto Backup	< 2%	< 20MB	中等（每日）
View Logs	< 0.5%	< 5MB	低

🔧 开发

项目结构

openclaw-toolbox/
├── README.md
├── LICENSE
├── .gitignore
├── .github/workflows/
│   └── release.yml        # 自动 Release
├── scripts/
│   ├── install.sh           # 一键安装
│   ├── openclaw-watchdog.sh # Gateway 监控
│   ├── partner-watchdog.sh  # 互备监控
│   ├── token-alert.sh      # Token 告警
│   ├── auto-backup.sh      # 自动备份
│   ├── view-logs.sh        # 日志查看
│   ├── start-dashboard.sh  # 启动 Dashboard
│   └── stop-dashboard.sh   # 停止 Dashboard
├── dashboard/
│   ├── server.js           # Express 服务器
│   ├── templates/
│   │   └── index.html      # Dashboard 前端
│   └── static/             # 静态资源
├── config/
│   ├── watchdog.json.example
│   ├── partner.conf.example
│   └── telegram.conf.example
└── docs/
    └── FAQ.md

本地开发

git clone https://github.com/SonicBotMan/openclaw-toolbox.git
cd openclaw-toolbox

# 测试各个脚本
bash scripts/openclaw-watchdog.sh
bash scripts/token-alert.sh
bash scripts/auto-backup.sh
bash scripts/view-logs.sh

🤝 致谢

• OpenClaw - AI Agent 框架
• systemd - 系统服务管理
• Telegram Bot API - 消息通知

📝 License

MIT License - 详见 LICENSE

🐛 问题反馈

如有问题或建议，请提交 Issue

---

Made with ❤️ for OpenClaw Community