### Changes

- Gateway/startup: skip plugin-backed auth-profile overlays during startup secrets preflight, reducing gateway readiness latency while keeping reload and OAuth recovery paths overlay-capable. (#68327) Thanks @JIRBOY.

- Plugins/diagnostics: make diagnostics OpenTelemetry and Prometheus ClawHub-first installs while keeping npm fallback metadata for release cutovers. Thanks @vincentkoc.

- Plugins/onboarding: carry ClawHub install metadata through channel setup catalogs so missing channel plugins can install from ClawHub before npm/local fallback. Thanks @vincentkoc.

- Plugins/runtime: scope broad runtime preloads to the effective plugin ids derived from config, startup planning, configured channels, slots, and auto-enable rules instead of importing every discoverable plugin.

### Fixes

- Control UI/sessions: bound the default Sessions tab query to recent activity and fewer rows, avoiding expensive full-history loads while keeping filters editable. Fixes #76050. (#76051) Thanks @Neomail2.

- Plugins/doctor: repair missing configured provider and channel plugins from ClawHub before npm fallback, preserving ClawPack metadata in the install record. Thanks @vincentkoc.

- Gateway/channels: cap startup fanout at four channel/account handoffs and recover from Bonjour ciao self-probe races, reducing Windows startup stalls with many Telegram accounts. Fixes #75687.

- Gateway/sessions: keep `sessions.list` polling responsive on large session stores by reusing list-safe session cache/indexes and returning a lightweight compaction checkpoint preview instead of heavyweight summaries. Thanks @rolandrscheel.

- CLI/update: treat inherited Gateway service markers as origin hints and only block package replacement when the managed Gateway is still live, so self-updates can stop the service and continue safely. (#75729) Thanks @hxy91819.

For packaged installs, install the plugin first:

```bash

openclaw plugins install @openclaw/diagnostics-otel

openclaw plugins install clawhub:@openclaw/diagnostics-otel

```

```json5

- You want metrics without running an OpenTelemetry collector

---

OpenClaw can expose diagnostics metrics through the bundled `diagnostics-prometheus` plugin. It listens to trusted internal diagnostics and renders a Prometheus text endpoint at:

OpenClaw can expose diagnostics metrics through the official `diagnostics-prometheus` plugin. It listens to trusted internal diagnostics and renders a Prometheus text endpoint at:

```text

GET /api/diagnostics/prometheus

## Quick start

<Steps>

<Step title="Install the plugin">

```bash

openclaw plugins install clawhub:@openclaw/diagnostics-prometheus

```

</Step>

<Step title="Enable the plugin">

<Tabs>

<Tab title="Config">

./scripts/docker/setup.sh

```

Install the official `@openclaw/diagnostics-otel` plugin in packaged Docker

installs before enabling export. Custom source-built images can still include

the local plugin source with `OPENCLAW_EXTENSIONS=diagnostics-otel`. To enable

export, allow and enable the `diagnostics-otel` plugin in config, then set

Install the official `@openclaw/diagnostics-otel` plugin from ClawHub in

packaged Docker installs before enabling export. Custom source-built images can

still include the local plugin source with

`OPENCLAW_EXTENSIONS=diagnostics-otel`. To enable export, allow and enable the

`diagnostics-otel` plugin in config, then set

`diagnostics.otel.enabled=true` or use the config example in [OpenTelemetry

export](/gateway/opentelemetry). Collector auth headers are configured through

`diagnostics.otel.headers`, not through Docker environment variables.

Prometheus metrics use the already-published Gateway port. Enable the

Prometheus metrics use the already-published Gateway port. Install

`clawhub:@openclaw/diagnostics-prometheus`, enable the

`diagnostics-prometheus` plugin, then scrape:

```text

## Distribution

- Package: `@openclaw/diagnostics-otel`

- Install route: ClawHub + npm

- Install route: ClawHub: `clawhub:@openclaw/diagnostics-otel`; npm

## Surface

## Distribution

- Package: `@openclaw/diagnostics-prometheus`

- Install route: ClawHub + npm

- Install route: ClawHub: `clawhub:@openclaw/diagnostics-prometheus`; npm

## Surface

"./index.ts"

],

"install": {

"clawhubSpec": "clawhub:@openclaw/diagnostics-otel",

"npmSpec": "@openclaw/diagnostics-otel",

"defaultChoice": "npm",

"defaultChoice": "clawhub",

"minHostVersion": ">=2026.4.25"

},

"compat": {

"./index.ts"

],

"install": {

"clawhubSpec": "clawhub:@openclaw/diagnostics-prometheus",

"npmSpec": "@openclaw/diagnostics-prometheus",

"defaultChoice": "npm",

"defaultChoice": "clawhub",

"minHostVersion": ">=2026.4.25"

},

"compat": {