# opc-dashboard

**Repository Path**: jasonchan0754/opc-dashboard

## Basic Information

- **Project Name**: opc-dashboard
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-27
- **Last Updated**: 2026-03-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OPC 神兽团队控制面板

面向 OpenClaw 运行环境的真实监控面板，覆盖六个神兽 Agent 的状态、工作区、飞书投递、模型使用、Token 轨迹和自动任务健康。

## 当前功能

- 六个神兽的状态、最近活动、默认模型、工作区体量
- OpenClaw Gateway 健康检查
- 工作区重点目录扫描，含 Git 分支和提交信息
- 基于 `~/.openclaw/agents/*/sessions/*.jsonl` 的 Token / 模型统计
- 基于 `~/.openclaw/cron` 的自动任务健康统计
- 基于 `~/.openclaw/delivery-queue` 的飞书投递队列监控
- SQLite 快照持久化
- React 控制面板，包含总览、神兽、工作区、分析四个页面
- Docker Compose 一键部署

## 技术栈

- 后端：Node.js + Express + TypeScript + SQLite
- 前端：React + TypeScript + Vite + Tailwind CSS + Recharts
- 部署：Docker + Docker Compose + Nginx

## 目录结构

```text
opc-dashboard/
├── backend/               # Express 采集器与 API
├── frontend/              # React 控制面板
├── docker/                # Compose 编排
├── data/                  # SQLite 数据文件
├── deploy.sh              # 一键部署脚本
├── PROJECT_SUMMARY.md     # 项目摘要
└── README.md
```

## 本地开发

### 后端

```bash
cd backend
npm install
npm run dev
```

默认监听 `http://127.0.0.1:3001`。

### 前端

```bash
cd frontend
npm install
npm run dev
```

默认监听 `http://127.0.0.1:3000`，并将 `/api` 代理到后端。

## Docker 部署

要求：

- 服务器本机已安装 Docker / Docker Compose
- 本机存在 OpenClaw 运行目录 `/root/.openclaw`
- 本机 Gateway 运行在 `http://127.0.0.1:18789`
- 目标环境为 Linux，Compose 使用 `network_mode: host` 以便容器访问宿主机 loopback 上的 Gateway

执行：

```bash
./deploy.sh
```

或者手动：

```bash
docker compose -f docker/docker-compose.yml build
docker compose -f docker/docker-compose.yml up -d
```

启动后：

- 前端：`http://127.0.0.1:3000`
- 后端健康检查：`http://127.0.0.1:3001/health`

## 环境变量

后端支持以下环境变量：

- `PORT`：后端端口，默认 `3001`
- `WORKSPACE_ROOT`：OpenClaw 工作区路径，默认 `/root/.openclaw/workspace`
- `OPENCLAW_ROOT`：OpenClaw 根目录，默认 `/root/.openclaw`
- `OPENCLAW_CONFIG_PATH`：配置文件路径，默认 `/root/.openclaw/openclaw.json`
- `OPENCLAW_GATEWAY_URL`：Gateway 健康检查地址，默认 `http://127.0.0.1:18789`
- `DATABASE_PATH`：SQLite 文件路径，默认 `backend/data/opc-dashboard.db`
- `REFRESH_INTERVAL_MS`：后台采集刷新频率，默认 `60000`

## 数据来源

控制面板不会修改 OpenClaw 配置，只读以下数据：

- `openclaw.json`
- `agents/*/sessions/*.jsonl`
- `cron/jobs.json`
- `cron/runs/*.jsonl`
- `delivery-queue/**/*.json`
- `/workspace` 文件系统
- `Gateway /health`