> Error resolution matrix and dewee doctor diagnostics

# Troubleshooting & Diagnostics

Run system diagnostics:

```bash
dewee doctor
```

## Common Issues & Fixes

* **502 Bad Gateway:** Verify gateway service is running on port 18790 (`systemctl status dewee`).
* **Database Connection Refused:** Check PostgreSQL 18 service status and pgvector extension.
* **Provider Save Failure:** Verify encryption key `GOCLAW_ENCRYPTION_KEY` is set in `.env.local`.