OpenClaw Agent Dashboard

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 ログ、セキュリティ監査（再認証が必要）
• ⚙️ 設定エディタ - OpenClaw 設定の JSON 検証、自動バックアップ、ゲートウェイ再起動機能付き編集（再認証が必要）
• 🐳 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

Visit `http://localhost:7000` in your browser. On first visit, you'll see a **registration screen** where you create your username and password. After registration, log in with your credentials.

## 📦 インストール

### 前提条件

- **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 Service (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ソケットを渡してください:```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の有効化