openclaw - 💡(How to fix) Fix Feature request: native Sentry DSN support for gateway + agents [1 participants]

Problem

Operators running OpenClaw in production (Docker, VPS, WSL) have no visibility into crashes of the openclaw binary / openclaw-gateway process. When the gateway segfaults or throws an unhandled exception, the container restarts (docker --restart=always) but the stack trace is lost with the previous container's ephemeral logs.

Today the only signal we have is "the gateway PID changed" — we can detect downtime gaps from watchdog state, but cannot see why it crashed.

Proposal

Add optional Sentry DSN configuration to the gateway and agent runtimes:

// ~/.openclaw/clawdbot.json or ~/.openclaw/config.json
{
  "observability": {
    "sentry": {
      "dsn": "https://[email protected]/NNNN",
      "environment": "production",
      "serverName": "my-openclaw",
      "tracesSampleRate": 0,
      "release": "${OPENCLAW_VERSION}"
    }
  }
}

Also support OPENCLAW_SENTRY_DSN env var as an alternative.

When configured:

• Initialize Sentry at gateway/agent startup (before any other init)
• Capture uncaughtException + unhandledRejection
• Tag events with openclaw version + gateway/agent role
• Zero-cost when DSN is unset (no SDK loaded)

Why

• Production observability parity with every other Node service
• Lets operators ship gateway crashes to their existing Sentry org
• Releases (via release tag) cleanly associate crashes with specific openclaw versions — super useful for upgrade regressions
• Opt-in: no SDK overhead unless DSN is set

Workaround today

I currently run:

• A separate crash-capture.sh cron inside the container that detects PID restarts and logs gaps to a host-mounted volume
• Process-level Sentry only on the dashboards around the gateway, not the gateway itself

These tell me when the gateway crashed but not why.

Happy to contribute

If this direction sounds good, I'd happily PR the @sentry/node wiring behind a feature-flag. Would want to confirm where the ideal init point lives in the gateway bootstrap.