Tools
Session Manager
Session Manager Plugin for OpenClaw — organize, rename, group, archive, and bulk-delete sessions with a Vue 3 dashboard UI
Configuration Example
{
"plugins": {
"entries": {
"session-manager": {
"enabled": true
}
}
}
}
README
# Session Manager — OpenClaw Plugin
A powerful session management plugin for [OpenClaw](https://openclaw.ai) that provides an elegant Vue 3 dashboard UI for organizing, renaming, grouping, archiving, and bulk-deleting sessions.
## Features
- 🗂️ **Session List** — Sortable, searchable table with per-session metadata
- ✏️ **Rename** — Give sessions friendly names
- 📁 **Groups** — Organize sessions into custom groups
- 🏷️ **Labels** — Tag sessions with multiple labels
- 📌 **Pin** — Pin important sessions to the top
- 📦 **Archive** — Archive sessions you want to keep but not see in active lists
- 🗑️ **Bulk Delete** — Multi-select and delete multiple sessions at once
- 🤖 **AI Auto-Organize** — Analyze sessions and suggest intelligent group assignments
- 🌙 **Dark/Light Theme** — Matches OpenClaw Dashboard design tokens exactly
## Architecture
```
session-manager/
├── manifest.json # OpenClaw plugin manifest
├── panel_server.py # Python HTTP API server
├── panel/
│ ├── index.html # Standalone HTML panel (legacy)
│ └── dist/ # Built Vue 3 UI (served by panel_server.py)
├── scripts/
│ └── session_meta.py # CLI metadata operations
└── SKILL.md # OpenClaw skill definition
```
## Quick Start
### 1. Start the Panel Server
```bash
cd session-manager/panel
python panel_server.py
```
The server runs on **http://localhost:18790** by default.
### 2. Open in Browser
Navigate to **http://localhost:18790**
### 3. Install as OpenClaw Plugin (optional)
Add to your OpenClaw config:
```json
{
"plugins": {
"entries": {
"session-manager": {
"enabled": true
}
}
}
}
```
## API Endpoints
| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/all` | Get all sessions + metadata |
| GET | `/api/ping` | Health check |
| POST | `/api/rename` | Rename a session |
| POST | `/api/meta` | Update session metadata (group, labels, pin) |
| POST | `/api/archive` | Archive/unarchive a session |
| POST | `/api/delete` | Delete a session |
| POST | `/api/bulk-delete` | Bulk delete sessions |
| POST | `/api/switch` | Switch to a session |
| POST | `/api/ai-suggest` | Get AI-organized suggestions |
| POST | `/api/ai-apply` | Apply AI suggestions |
## Configuration
Environment variables:
| Variable | Default | Description |
|----------|---------|-------------|
| `SESSION_PANEL_PORT` | `18790` | Server port |
| `OPENCLAW_SESSION_META_PATH` | `~/.openclaw/session-meta.json` | Metadata storage path |
## License
MIT — NeXT-Scene
tools
Comments
Sign in to leave a comment