Gateway: add healthz/readyz probe endpoints for container checks (#31272)

* Gateway: add HTTP liveness/readiness probe routes

* Gateway tests: cover probe route auth bypass and methods

* Docker Compose: add gateway /healthz healthcheck

* Docs: document Docker probe endpoints

* Dockerfile: note built-in probe endpoints

* Gateway: make probe routes fallback-only to avoid shadowing

* Gateway tests: verify probe paths do not shadow plugin routes

* Changelog: note gateway container probe endpoints
This commit is contained in:
Vincent Koc
2026-03-01 20:36:58 -08:00
committed by GitHub
parent 0a1eac6b0b
commit eeb72097ba
6 changed files with 199 additions and 4 deletions

View File

@@ -92,7 +92,8 @@ USER node
# - Use --network host, OR
# - Override --bind to "lan" (0.0.0.0) and set auth credentials
#
# For container platforms requiring external health checks:
# 1. Set OPENCLAW_GATEWAY_TOKEN or OPENCLAW_GATEWAY_PASSWORD env var
# 2. Override CMD: ["node","openclaw.mjs","gateway","--allow-unconfigured","--bind","lan"]
# Built-in probe endpoints for container health checks:
# - GET /healthz (liveness) and GET /readyz (readiness)
# - aliases: /health and /ready
# For external access from host/ingress, override bind to "lan" and set auth.
CMD ["node", "openclaw.mjs", "gateway", "--allow-unconfigured"]