🔐 为OpenClaw AI代理提供的安全、实时监控仪表盘。包含身份验证、TOTP多因素认证、成本追踪、实时动态、内存浏览器等功能。
一个美观、安全、实时的 OpenClaw agent 监控仪表盘。追踪会话、监控 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 socket:
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 挂载为只读:监控功能可用,但配置编辑器无法将更改保存到该挂载。仅当你打算通过仪表盘管理主机配置时,才启用写入。确保工作区对容器的 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 | 配置编辑器文件路径 | $OPENCLAW_DIR/openclaw.json |
OPENCLAW_AGENT | 要监控的 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)为防止暴力破解攻击:
通过基于时间的一次性密码(TOTP)增加一层额外的安全保护。
启用后,每次登录都需要:
如果你无法访问身份验证器应用(手机丢失、应用被卸载等):