init: oc-monitor dashboard

README.md

@@ -0,0 +1,45 @@
+# OpenClaw Monitor
+
+Multi-node monitoring dashboard for OpenClaw instances.
+
+## Architecture
+
+- **Server**: Node.js + SQLite + WebSocket (central dashboard)
+- **Agent**: Bash script on each OpenClaw machine, reports heartbeat + metrics
+
+## Quick Start
+
+### Server (Docker)
+```bash
+docker run -d --name oc-monitor -p 3800:3800 -v oc-monitor-data:/app/data ghcr.io/mango082888-bit/oc-monitor
+# Get auth token
+docker logs oc-monitor 2>&1 | grep "Auth token"
+```
+
+### Agent
+```bash
+curl -sL https://raw.githubusercontent.com/mango082888-bit/oc-monitor/main/agent/agent.sh -o agent.sh
+chmod +x agent.sh
+./agent.sh -s http://YOUR_SERVER:3800 -t YOUR_TOKEN -n "My Node" -r master
+```
+
+## Features
+
+- Real-time node status (CPU/mem/disk/swap)
+- Provider health matrix across all nodes
+- API request logging with TTFT/latency tracking
+- Auto-detect OpenClaw config changes
+- WebSocket live updates
+- Dark theme UI
+
+## API
+
+| Endpoint | Method | Auth | Description |
+|---|---|---|---|
+| `/api/dashboard` | GET | No | Full dashboard data |
+| `/api/heartbeat` | POST | Yes | Agent heartbeat report |
+| `/api/request` | POST | Yes | Log API request |
+| `/api/node/rename` | POST | Yes | Rename a node |
+| `/api/node/:id` | DELETE | Yes | Remove a node |
+
+Auth: `Authorization: Bearer <token>`