Tools

Session Manager

Name: Session Manager
Rating: 3.5 (1 reviews)
Author: NeXT-Scene

By NeXT-Scene 👁 2 views ▲ 0 votes

Session Manager Plugin for OpenClaw — organize, rename, group, archive, and bulk-delete sessions with a Vue 3 dashboard UI

Homepage GitHub

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