Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agentbot.raveculture.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Debug API

Run diagnostic commands against a running agent and perform dashboard health checks.

Execute a debug command

POST /api/debug
Runs one of the allowlisted commands and returns the command output.

Request body

FieldTypeRequiredDescription
commandstringYesThe command to execute. Must be one of the allowlisted values listed below.
agentIdstringYesThe agent to run the command against

Allowlisted commands

CommandDescription
gateway.restartRestart the agent gateway process
openclaw.doctorRun a full health diagnostic
openclaw.logs.tailTail the most recent log entries
openclaw.statusShow agent status summary
openclaw.config.showDisplay the current agent configuration
openclaw.memory.statsShow memory store statistics
openclaw.skills.listList installed skills
openclaw.channels.statusShow channel connection status
openclaw.cron.listList scheduled cron jobs
openclaw.versionDisplay version information

Response

{
  "command": "openclaw.status",
  "output": "OpenClaw Agent Status\n━━━━━━━━━━━━━━━━━━━━━━\nVersion:     2026.4.11\nUptime:      3d 14h 22m\nStatus:      ACTIVE\n...",
  "exitCode": 0,
  "duration": 342,
  "timestamp": "2026-03-27T15:30:00.000Z"
}
FieldTypeDescription
commandstringThe command that was executed
outputstringThe command output text
exitCodenumberExit code of the command. 0 indicates success.
durationnumberExecution time in milliseconds
timestampstringISO 8601 timestamp when the command completed

Errors

CodeDescription
400Missing required fields: command, agentId — one or both required fields are missing
400Command "..." is not in the allowlist — the command is not one of the ten allowlisted values
400Invalid request body — the request body is not valid JSON

Example

curl -X POST https://agentbot.sh/api/debug \
  -H "Content-Type: application/json" \
  -d '{
    "command": "openclaw.doctor",
    "agentId": "agent_abc123"
  }'

Dashboard check

GET /api/debug/dashboard-check
No authentication required. Runs connectivity checks against the database and authentication endpoints and returns their status. Use this endpoint to quickly verify that core services are reachable.

Response

{
  "timestamp": "2026-04-04T12:00:00.000Z",
  "status": "ok",
  "checks": {
    "database": "ok",
    "gateway": "unknown",
    "auth": "ok"
  }
}
FieldTypeDescription
timestampstringISO 8601 timestamp of the check
statusstringAlways ok when the endpoint responds
checks.databasestringDatabase connectivity: ok or error
checks.gatewaystringGateway connectivity: ok, error, or unknown
checks.authstringAuth service connectivity: ok or error
CodeDescription
200Check completed (inspect individual check values for service status)

Support diagnostics

GET /api/support/diagnostics
Requires session authentication. Returns a diagnostic report including service health, active trial count, gateway token status, and recent agent errors. When the gateway token is missing, a support alert is automatically sent.

Response

{
  "serviceHealth": [
    { "name": "Agentbot API", "status": "ok", "detail": "ok" },
    { "name": "Tempo Soul", "status": "ok", "detail": "ok" }
  ],
  "trialCount": 12,
  "tokenStatus": "present",
  "recentErrors": [
    {
      "id": "agent_xyz",
      "name": "my-agent",
      "updatedAt": "2026-04-04T11:00:00.000Z",
      "status": "error"
    }
  ],
  "gatewayUrl": "https://openclaw-gw-ui-production.up.railway.app",
  "timestamp": "2026-04-04T12:00:00.000Z"
}
FieldTypeDescription
serviceHealtharrayService connectivity results (same format as dashboard health)
trialCountnumberNumber of users currently on an active free trial
tokenStatusstringGateway token status: present or missing
recentErrorsarrayUp to 5 most recently updated agents in error status
recentErrors[].idstringAgent identifier
recentErrors[].namestringAgent name
recentErrors[].updatedAtstringISO 8601 timestamp of the last status update
recentErrors[].statusstringAgent status (always error in this list)
gatewayUrlstringConfigured gateway URL
timestampstringISO 8601 timestamp of the diagnostic report

Errors

CodeDescription
401Unauthorized — no valid session or email not available
500Diagnostics failed