Skip to main content
Purpose: OpenClaw discovery, gateway status/probing, session telemetry, console messaging, cron control, usage telemetry.

Key Endpoint Groups

  • discovery/capabilities: /api/openclaw/discover, /api/openclaw/capabilities
  • gateway: /api/openclaw/gateway/status, /api/openclaw/gateway/test
  • sessions: /api/openclaw/sessions, /api/openclaw/sessions/sync
  • console: /api/openclaw/console/sessions/*, /api/openclaw/console/agent/turn
  • cron: /api/openclaw/cron/*
  • usage: /api/openclaw/usage/*

Discovery + Gateway Probe Example

Console Session Chat Example (session-scoped)

Returns SSE stream with message chunks and done marker.

Console Agent Chat Example (agent-scoped)

Agent Turn Endpoint

POST /api/openclaw/console/agent/turn is governor-gated and requires typed confirmation.

Cron Status + Jobs Example

Usage Summary Example

Error patterns

  • 503 GATEWAY_UNAVAILABLE
  • 404 SESSION_NOT_FOUND in console routes
  • 400 for invalid text/body constraints
  • cron endpoints return structured unavailable responses when CLI/runtime commands fail
  • CLI failures may include code + fixHint metadata

Last updated

2026-02-13