Dashboard
The Dashboard is the main landing page of LordClaw. It uses a customizable widget grid where you choose which information to display and how it’s arranged.
Widget System
The dashboard is built from modular widgets that you can enable, disable, reorder, and resize.
Available Widgets
| Widget | Description |
|---|---|
| Quick Stats | Agents, tokens, cron jobs, and health at a glance |
| Claude Plan Usage | Session (5h) and weekly utilization with progress bars |
| MiniMax Plan | MiniMax coding plan usage tracker |
| Token Usage Chart | Time-series area chart of token consumption |
| Cron Jobs | Overview of scheduled jobs and recent failures |
| Channel Health | Status of Telegram, WhatsApp, and other channels |
| Sessions | Currently active sessions summary |
| Agent Card | Pin a specific agent to the dashboard (multiple allowed) |
| Agent Chat | Quick chat preview for an agent (multiple allowed) |
Customizing
Click the Customize button in the dashboard header to open the widget picker. From there you can:
- Toggle widgets on/off — enable or disable any widget
- Add Agent Cards — click the
+button to add a card for a specific agent, then select which agent from a dropdown - Adjust height — some widgets support multiple height units (e.g., the token chart can be 3 or 4 units tall)
Drag-and-Drop Reordering
Widgets can be reordered by dragging. The grid uses a responsive column layout:
- Desktop: 2 columns
- Mobile: 1 column
Widget positions and settings are saved to localStorage and persist across sessions.
Agent Card and Agent Chat are the only widget types that support multiple instances — you can pin as many agents as you like.
Claude Plan Usage
If you use Claude with an API plan, this widget shows:
- Session usage — tokens used in the current 5-hour window
- Weekly usage — consumption over the 7-day period
- Progress bars that change color at 70% (yellow) and 90% (red)
The widget auto-detects OAuth credentials from:
- macOS Keychain (
Claude Code-credentials) ~/.claude/.credentials.json(Linux)
If auto-detection fails, you can paste an OAuth token manually in Settings.
If you see “Invalid or expired OAuth token,” run claude auth login on the machine where LordClaw runs to refresh the credentials.
MiniMax Coding Plan Usage
Shows prompt usage (used/total) with a 5-hour rolling reset window. Auto-detects the OAuth token from OpenClaw’s auth-profiles.json.
ZAI (Zhipu) Plan Usage
Shows 5-hour rolling, weekly, and MCP tool usage. Auto-detects the API key from auth-profiles.json. Displays the plan level badge (Lite/Pro/Max).