OpenClaw 에이전트 대시보드

OpenClaw 에이전트를 위한 아름답고 안전하며 실시간 모니터링 대시보드입니다. 세션 추적, API 사용량 모니터링, 비용 확인, 메모리 파일 관리, 시스템 상태 확인을 한곳에서 수행할 수 있습니다.

📸 스크린샷

개요	세션	비용

속도 제한	라이브 피드	로그

✨ 기능

• 🤖 세션 관리 - 모든 에이전트 세션을 실시간 활동 상태로 확인
• 📊 속도 제한 모니터링 - Claude 및 Gemini API 사용량을 롤링 윈도우 기준으로 추적
• 💰 비용 분석 - 모델, 세션, 기간별 상세 지출 내역
• ⚡ 라이브 피드 - 모든 세션의 에이전트 메시지를 실시간 스트리밍
• 🧠 메모리 뷰어 - 에이전트 메모리 파일(MEMORY.md, HEARTBEAT.md, 일일 노트) 열람 및 읽기
• 📁 파일 관리자 - 작업 공간 파일, 스킬, 설정을 보안 강화된 상태로 확인 및 편집
• 📈 시스템 상태 - CPU, RAM, 디스크, 온도 모니터링 (스파크라인 포함)
• 🔄 서비스 제어 - OpenClaw, 대시보드 또는 기타 서비스를 빠르게 재시작
• 📋 로그 뷰어 - 자동 새로고침으로 실시간 시스템 로그 확인
• ⏰ Cron 관리 - cron 작업 조회, 활성화/비활성화, 수동 실행
• 🌐 Tailscale 통합 - Tailscale 상태, IP, 연결된 피어 확인
• 🎯 활동 히트맵 - 최근 30일간 피크 사용 시간 시각화
• 🔥 연속 트래킹 - 일일 활동 연속 일수 모니터링
• 🔍 세션 검색 및 필터링 - 상태, 모델, 날짜 범위로 필터링 (라이브 검색)
• 🎨 다크/라이트 테마 - 다크 모드와 라이트 모드 전환 (선호도 유지)
• ⌨️ 키보드 단축키 - 단축키(1-7, Space, /, Esc, ?)로 빠른 탐색
• 📱 모바일 반응형 - 휴대폰 및 태블릿에서 작동
• 🔔 브라우저 알림 - 사용량 제한에 근접할 때 알림
• 📊 타임라인 뷰 - 세션 활동의 시각적 타임라인
• 💾 Git 활동 - 리포지토리의 최근 커밋 추적
• 🎛️ Claude 사용량 스크레이퍼 - Claude Code CLI에서 실제 사용량 데이터 가져오기
• 🔷 Gemini 사용량 추적 - 모델별 세분화된 Google Gemini 사용량 모니터링
• 🔀 프로바이더 전환 - 개요 카드에서 Claude와 Gemini 사용량 간 전환
• 📊 모델별 선택기 - 표시할 모델/윈도우 선택 (Opus, Sonnet, Pro, Flash 등)
• 🔄 자동 새로고침 - 5초마다 데이터 실시간 업데이트
• 🌟 평생 통계 - 최초 세션 이후 총 토큰, 메시지, 비용
• 📈 상태 기록 - 24시간 CPU, RAM, 온도, 디스크 사용량 스파크라인
• 🎯 빠른 작업 - 원클릭 시스템 유지보수 (업데이트, 정리, 재시작)
• 🍎 macOS 호환 - macOS 시스템 통계, 서비스, 메모리 보고 완벽 지원
• 🛡️ 시스템 보안 대시보드 - UFW 규칙, 열린 포트, fail2ban, SSH 로그, 보안 감사 (재인증 필요)
• ⚙️ 설정 편집기 - JSON 검증, 자동 백업, 게이트웨이 재시작 기능이 있는 OpenClaw 설정 편집 (재인증 필요)
• 🐳 Docker 관리 - 컨테이너, 이미지, 시스템 사용량 확인; 컨테이너 시작/중지/재시작; 사용하지 않는 리소스 정리
• 🔔 알림 센터 - 읽지 않은 배지 카운터가 있는 감사 로그 이벤트 피드 (로그인, 설정 변경, 보안 이벤트)
• 🔐 사용자 이름/비밀번호 인증 - PBKDF2 비밀번호 해싱을 사용한 보안 등록
• 🔑 TOTP MFA - 선택적 이중 인증 (Google Authenticator 호환)
• 💾 로그인 유지 - 세션 전용 또는 3시간 지속 로그인
• 🛡️ 보안 강화 - HSTS, CSP, 속도 제한, 타이밍 안전 비교, 감사 로깅
• 📦 최소 의존성 - 순수 Node.js, 데이터베이스나 npm 패키지 불필요. 선택 사항: jq (Docker 페이지), tmux + python3 (Claude CLI 사용량 스크레이퍼), docker (Docker 관리)

🚀 빠른 시작```bash

Clone the repository

git clone https://github.com/tugcantopaloglu/openclaw-dashboard.git cd openclaw-dashboard

Set your OpenClaw workspace path (optional, auto-detects if not set)

export WORKSPACE_DIR=/path/to/your/openclaw/workspace

Start the dashboard

node server.js

`http://localhost:7000`을 브라우저에서 방문하세요. 처음 방문 시 사용자 이름과 비밀번호를 생성하는 **등록 화면**이 나타납니다. 등록 후에는 자격 증명으로 로그인합니다.

## 📦 설치

### 사전 요구 사항

- **Node.js** v18 이상 (`node --version`으로 확인)
- **OpenClaw** 설치 및 실행 중
- **Systemd** (선택 사항, Linux에서 서비스 설치용)

#### 선택적 종속성

| 도구 | 필요 용도 | 설치 방법 |
|------|-----------|-----------|
| `jq` | Docker 관리 페이지 | `sudo apt install jq` |
| `tmux` | Claude CLI 사용량 스크레이퍼 | `sudo apt install tmux` |
| `python3` | Claude CLI 사용량 파서 | 일반적으로 사전 설치됨 |
| `docker` | Docker 관리 페이지 | [docs.docker.com](https://docs.docker.com/engine/install/) |

### 수동 설치

1. **저장소 클론**   ```bash
   git clone https://github.com/tugcantopaloglu/openclaw-dashboard.git
   cd openclaw-dashboard

2. 환경 구성 (선택 사항) ```bash export DASHBOARD_PORT=7000 export WORKSPACE_DIR=/path/to/your/workspace export OPENCLAW_DIR=$HOME/.openclaw export OPENCLAW_AGENT=main

3. 서버 시작 ```bash node server.js

서버가 출력합니다: ``` 🚀 Dashboard running on http://localhost:7000 🔑 Recovery token: abc123def456...

**복구 토큰 저장** — 비밀번호를 잊어버릴 경우 필요합니다.

4. **대시보드 접속**
`http://localhost:7000`을 열고 계정을 등록하세요.

### Systemd 서비스 (install.sh)

대시보드를 자동 시작 및 충돌 복구 기능이 있는 시스템 서비스로 실행하려면:```bash
sudo ./install.sh

이 작업은 다음을 수행합니다:

• /etc/systemd/system/agent-dashboard.service 생성
• /etc/systemd/system/agent-dashboard.service.d/override.conf에 재정의 설정 생성
• 서비스 활성화 및 시작
• 워크스페이스 경로 설정 및 복구 토큰 생성

로그 보기:```bash journalctl -u agent-dashboard -f

### Docker```bash
# Build
docker build -t openclaw-dashboard .

# Run
docker run -d \
  --name openclaw-dashboard \
  -p 3001:3001 \
  -e WORKSPACE_DIR=/app/workspace \
  -e DASHBOARD_ALLOW_HTTP=true \
  -v ~/.openclaw:/home/node/.openclaw:ro \
  -v ~/.openclaw/workspace:/app/workspace \
  openclaw-dashboard

Docker 관리 페이지 접근을 위해 Docker socket을 전달하십시오:```bash docker run -d
--name openclaw-dashboard
-p 3001:3001
-e WORKSPACE_DIR=/app/workspace
-e DASHBOARD_ALLOW_HTTP=true
-v ~/.openclaw:/home/node/.openclaw:ro
-v ~/.openclaw/workspace:/app/workspace
-v /var/run/docker.sock:/var/run/docker.sock:ro
--group-add $(stat -c '%g' /var/run/docker.sock)
openclaw-dashboard

### 환경 변수

| 변수 | 설명 | 기본값 |
|----------|-------------|---------|
| `DASHBOARD_PORT` | 서버 포트 | `7000` |
| `DASHBOARD_TOKEN` | 비밀번호 재설정을 위한 복구 토큰 | 시작 시 자동 생성 |
| `WORKSPACE_DIR` | OpenClaw 작업 공간 경로 | `$OPENCLAW_WORKSPACE` 또는 현재 디렉터리 |
| `OPENCLAW_DIR` | OpenClaw 설정 디렉터리 | `~/.openclaw` |
| `OPENCLAW_AGENT` | 모니터링할 에이전트 ID | `main` |
| `DASHBOARD_ALLOW_HTTP` | 로컬이 아닌 IP의 HTTP 허용 | `false` |

**예시:**```bash
# Custom port
DASHBOARD_PORT=8080 node server.js

# Custom recovery token
DASHBOARD_TOKEN=my_secret_token_12345 node server.js

# Different workspace
WORKSPACE_DIR=/mnt/data/openclaw node server.js

🔐 인증

대시보드는 보안 서버 측 세션과 함께 사용자 이름 및 비밀번호 인증을 사용합니다.

최초 등록

1. 대시보드 URL(예: http://localhost:7000)을 방문하세요.
2. 등록 화면이 나타납니다.
3. 사용자 이름과 비밀번호를 선택하세요.
4. 등록을 클릭하세요.
5. 새 자격 증명으로 로그인하세요.

로그인

• 사용자 이름과 비밀번호를 입력하세요.
• 선택적으로 **"로그인 유지"**를 체크하면 3시간 동안 로그인 상태가 유지됩니다(localStorage 사용).
• "로그인 유지" 없이 세션은 브라우저를 닫을 때까지만 지속됩니다(sessionStorage 사용).

비밀번호 보안

• PBKDF2 해싱 — SHA-512로 100,000회 반복
• 무작위 솔트 — 비밀번호마다 고유
• 서버 측 세션 — 비밀번호는 브라우저에 저장되지 않으며 세션 토큰만 저장됩니다.
• 타이밍 안전 비교 — 비밀번호 확인 시 타이밍 공격 방지

속도 제한

무차별 대입 공격을 방지하려면:

• 5회 로그인 실패 → 15분 소프트 잠금
• 20회 로그인 실패 → 하드 잠금(서비스 재시작 필요)
• 속도 제한은 메모리 내에서 유지되며 서비스 재시작 시 초기화됩니다.

🔑 다중 인증(MFA)

시간 기반 일회용 비밀번호(TOTP)로 추가 보안 계층을 제공합니다.

MFA 활성화

1. 대시보드에 로그인하세요.
2. 보안 페이지(사이드바)로 이동하세요.
3. **"MFA 활성화"**를 클릭하세요.
4. QR 코드가 나타납니다 — 인증 앱으로 스캔하세요:
   • Google Authenticator (iOS, Android)
   • Authy (iOS, Android, Desktop)
   • Microsoft Authenticator (iOS, Android)
   • 1Password, Bitwarden 또는 모든 TOTP 호환 앱
5. 앱에 표시된 6자리 코드를 입력하여 확인하세요.
6. MFA가 활성화되었습니다! 🎉

MFA 사용

활성화 후, 모든 로그인 시 다음이 필요합니다:

1. 사용자 이름과 비밀번호(평소와 같이)
2. 인증 앱의 6자리 TOTP 코드