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.

Configure OpenClaw Channels

Connect Telegram or Slack through XO Setup and restart the OpenClaw Gateway.

Agent Troubleshooting

Find the currently documented agent-specific fixes for OpenClaw.