Troubleshooting
Start with the symptom, service, or exact error you are seeing.
Start with the part of XO that is failing. The most complete agent-specific coverage currently focuses on OpenClaw; the other links take you to the relevant setup or workspace checks.
OpenClaw errors
Fix gateway-token errors, unresponsive agents, failed startups, 502s, and model-provider problems.
Workspace or IDE access
Check machine state, service readiness, browser IDE access, and restart controls.
Model authentication
Review OAuth and API-key setup, then use the path supported by your selected agent.
Messaging channels
Check agent compatibility, credentials, save state, gateway restart, and connection status.
Launchpad deployment
Diagnose build, port, and 502 problems in the deployment-method guides.