🔐 OpenClaw AI 에이전트를 위한 안전한 실시간 모니터링 대시보드. 인증, TOTP MFA, 비용 추적, 라이브 피드, 메모리 브라우저 등.
OpenClaw 에이전트를 위한 아름답고 안전한 실시간 모니터링 대시보드입니다. 세션 추적, API 사용량 모니터링, 비용 확인, 메모리 파일 관리, 시스템 상태 점검을 한 곳에서 모두 수행할 수 있습니다.

| 개요 | 세션 | 비용 |
|---|---|---|
![]() | ![]() | ![]() |
| 속도 제한 | 실시간 피드 | 로그 |
|---|---|---|
![]() | ![]() | ![]() |
jq(Docker 페이지), tmux + python3(Claude CLI 사용량 스크래퍼), docker(Docker 관리)# 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 --version으로 확인)| 도구 | 필요한 기능 | 설치 |
|---|---|---|
jq | Docker 관리 페이지 | sudo apt install jq |
tmux | Claude CLI 사용량 스크래퍼 | sudo apt install tmux |
python3 | Claude CLI 사용량 파서 | 일반적으로 사전 설치됨 |
docker | Docker 관리 페이지 | docs.docker.com |
저장소 복제
git clone https://github.com/tugcantopaloglu/openclaw-dashboard.git
cd openclaw-dashboard
환경 구성 (선택 사항)
export DASHBOARD_PORT=7000
export WORKSPACE_DIR=/path/to/your/workspace
export OPENCLAW_DIR=$HOME/.openclaw
export OPENCLAW_AGENT=main
서버 시작
node server.js
서버가 출력합니다:
Dashboard running on http://localhost:7000
Recovery token saved to: /path/to/your/workspace/data/recovery-token.txt
비공개 파일에서 복구 토큰을 읽고 저장하세요 - 비밀번호를 잊어버린 경우 필요합니다. 이 값은 시작 로그나 서비스 로그에 기록되지 않습니다.
대시보드에 접속하세요
http://localhost:7000을 열고 계정을 등록하세요.
자동 시작 및 충돌 복구 기능을 갖춘 시스템 서비스로 대시보드를 실행하려면:
./install.sh
이 작업은 다음을 수행합니다:
/etc/systemd/system/agent-dashboard.service 생성로그 보기:
journalctl -u agent-dashboard -f
# 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 소켓을 전달하세요:
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
이미지는 컨테이너 내부에서 0.0.0.0에서 수신 대기하므로 게시된 포트에 계속 접근할 수 있습니다. 로컬 리버스 프록시가 접근을 처리하는 경우 -p 127.0.0.1:3001:3001을 사용하세요. 예시 OpenClaw 마운트는 읽기 전용입니다. 모니터링은 작동하지만 Config Editor는 해당 마운트에 변경 사항을 저장할 수 없습니다. 대시보드를 통해 호스트 구성을 관리하려는 경우에만 쓰기를 활성화하세요. 워크스페이스가 컨테이너의 node 사용자가 쓸 수 있는지 확인하고, 재빌드 간에 인증 디렉터리를 보존하세요.
| 변수 | 설명 | 기본값 |
|---|---|---|
DASHBOARD_PORT | 서버 포트 | 7000 |
DASHBOARD_HOST | 수신 대기할 주소 | 0.0.0.0 |
DASHBOARD_TOKEN | 비밀번호 재설정을 위한 명시적 복구 토큰; 토큰 파일보다 우선함 | 영구 저장된 무작위 토큰 |
DASHBOARD_AUTH_DIR | 비공개 자격 증명, 복구 토큰 및 감사 디렉터리 | $WORKSPACE_DIR/data |
DASHBOARD_TRUSTED_PROXIES | X-Forwarded-Proto를 제공할 수 있는 정확한 프록시 IP의 쉼표 구분 목록 | 루프백만 |
DASHBOARD_GIT_BIN | 비표준 설치 환경에서 git의 절대 경로 | 표준 시스템 설치 디렉터리의 Git |
WORKSPACE_DIR | OpenClaw 워크스페이스 경로 | $OPENCLAW_WORKSPACE 또는 현재 디렉터리 |
OPENCLAW_DIR | OpenClaw 구성 디렉터리 | ~/.openclaw |
OPENCLAW_CONFIG | Config Editor 파일 경로 | $OPENCLAW_DIR/openclaw.json |
OPENCLAW_AGENT | 모니터링할 에이전트 ID | main |
DASHBOARD_ALLOW_HTTP | 비로컬 IP로부터의 HTTP 허용 | false |
예시:
# 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
대시보드는 안전한 서버 측 세션과 함께 사용자 이름 및 비밀번호 인증을 사용합니다.
http://localhost:7000)을 방문합니다localStorage 사용)sessionStorage 사용)