Plugin Session Status

Name: Plugin Session Status
Rating: 3.5 (1 reviews)
Author: oc-xiaoju

By oc-xiaoju 👁 4 views ▲ 0 votes

OpenClaw plugin — HTTP API exposing session concurrency status for external tools

GitHub

Configuration Example

{
  "ok": true,
  "timestamp": "2026-04-13T01:10:00.000Z",
  "sessions": {
    "running": 2,
    "idle": 5,
    "total": 7,
    "maxConcurrent": 8,
    "available": 6,
    "details": [
      { "key": "agent:main:main", "status": "running", "agent": "main", "kind": "main", "updatedAt": 1713000000000 }
    ]
  }
}

README

# openclaw-plugin-session-status

OpenClaw plugin — HTTP API exposing session concurrency status for external tools.

## What it does

Registers a read-only HTTP endpoint that returns OC's current session concurrency status. Any external tool (task dispatchers, monitoring dashboards, automation scripts) can check whether OC is busy or idle.

## Endpoint

```
GET /plugins/session-status/status
Authorization: Bearer <secret>
```

Response:
```json
{
  "ok": true,
  "timestamp": "2026-04-13T01:10:00.000Z",
  "sessions": {
    "running": 2,
    "idle": 5,
    "total": 7,
    "maxConcurrent": 8,
    "available": 6,
    "details": [
      { "key": "agent:main:main", "status": "running", "agent": "main", "kind": "main", "updatedAt": 1713000000000 }
    ]
  }
}
```

## Install

```bash
# Load via config — add to openclaw.json:
# "plugins": { "load": { "paths": ["/path/to/openclaw-plugin-session-status"] } }
```

## Configure

In `openclaw.json`:
```json
{
  "plugins": {
    "allow": ["session-status"],
    "entries": {
      "session-status": {
        "secret": "your-secret-token"
      }
    }
  }
}
```

## How it works

Scans OC's session `.jsonl` files to determine activity:
- A session is **running** if its file was modified within the last 30 seconds
- A session is **idle** otherwise
- `available` = `maxConcurrent` (default 8) - `running`
- `details` includes only sessions active in the last 5 minutes

## License

MIT

integration