DashClaw

Multi-agent management dashboard for OpenClaw

DashClaw gives you a real-time web console to monitor and manage all your OpenClaw agents in one place — token usage, memory files, soul/tools editing, and scheduled tasks.

DashClaw 是 OpenClaw 的多 Agent 管理控制台，提供实时 Token 监控、记忆文件读写、Soul/Tools 编辑和定时任务一览。

---

Features / 功能

Feature	Description
Overview / 总览	All agents' today token usage, cost, call count, last active time
Token Monitor / Token监控	Daily trend chart + per-agent breakdown for the last 1/7/30 days
Cron Jobs / 定时任务	OpenClaw cron jobs + systemd timers in one view
Memory Files / 记忆文件	Read, write, create and delete each agent's memory/*.md files
Soul & Tools	Edit SOUL.md, TOOLS.md, IDENTITY.md for any agent

All data is read directly from OpenClaw's local files — no database, no external service required.

所有数据直接从 OpenClaw 本地文件读取，不需要数据库，不依赖外部服务。

---

Requirements / 环境要求

• Python 3.10+
• OpenClaw installed and configured
• systemd (Linux) for the service installer

---

Installation / 安装

git clone https://github.com/branzoom/DashClaw.git
cd DashClaw
bash install.sh

The dashboard will be available at http://127.0.0.1:8901.

安装完成后访问 http://127.0.0.1:8901。

Custom port / 自定义端口

DASHCLAW_PORT=9000 bash install.sh

Manual start / 手动启动

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python3 app.py

---

Login / 登录

Use your OpenClaw gateway token to log in.

使用 OpenClaw Gateway Token 登录。

# Find your token / 查看 token
python3 -c "import json; d=json.load(open('~/.openclaw/openclaw.json'.replace('~', __import__('os').path.expanduser('~')))); print(d['gateway']['auth']['token'])"

---

Nginx reverse proxy (optional) / 反向代理（可选）

To expose DashClaw via a domain with HTTPS:

server {
    listen 443 ssl;
    server_name dashclaw.yourdomain.com;

    ssl_certificate     /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:8901;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_read_timeout 86400;
    }
}

---

Data sources / 数据来源

Data	Source
Agent list	~/.openclaw/openclaw.json → agents.list
Token usage	~/.openclaw/agents/*/sessions/*.jsonl
Memory files	~/.openclaw/agents/*/memory/*.md
Soul / Tools	~/.openclaw/agents/*/SOUL.md, TOOLS.md, IDENTITY.md
Cron jobs	~/.openclaw/cron/jobs.json + systemctl --user list-timers

Supports both current and legacy OpenClaw session JSONL formats.

同时支持新版和旧版 OpenClaw session JSONL 格式。

---

Security / 安全

• Auth via OpenClaw gateway token (session cookie, server-side)
• All file operations are path-validated and restricted to ~/.openclaw/agents/
• Dashboard binds to 127.0.0.1 by default (not exposed to the internet without a reverse proxy)

---

License

MIT