wrok Bot troubleshooting
Diagnose startup, connectivity, models, work states and recovery.
Common symptoms
| Symptom | Check |
|---|---|
| Server fails to start | Database, schema, keys, dependencies and logs |
| UI loads but work is unavailable | Matching backend, identity and readiness |
| Empty/failed model catalog | Account, connections and read state |
| Disabled gateway/account button | Availability in this version |
| Accepted input not executing | Foreground state, held input, authority and budget |
| Completion refused | Active run or pending input |
| External result after Stop | Original terminal state and prior side effects |
| Remote business routes return 503 | TLS proxy, public URL, secret and forwarded headers |
| Recovery refused | Release identity, artifact, keys and recovery admission |
Report a problem
Record version, platform, entry point, non-secret errors, task ID and minimal steps. Do not upload credentials, databases or private specifications. Use the repository.
Keep UI previews and fixtures distinct from real hosts. A simulated model pass is not real-provider acceptance, and missing release packaging is not proof of a source-test failure.