Runbooks
Tenant Debugging
How to debug issues with a specific tenant container.
Step 1: Check Container Status
make ssh
nomad job status tenant-{slug}Look for:
- Allocation status (
running,pending,dead) - Recent events (OOM kills, restart loops)
- Resource usage
Step 2: Check Logs
nomad alloc logs {alloc-id} # stdout
nomad alloc logs -stderr {alloc-id} # stderrStep 3: Check Data Directory
ls -la /data/tenants/{slug}/
cat /data/tenants/{slug}/openclaw.json # or config.toml for ZeroClawVerify:
- Config file exists and is valid JSON/TOML
- Credentials directory has expected files
- Permissions are correct (owner matches container UID)
Step 4: Health Check
# OpenClaw (needs auth header):
curl -H "Authorization: Bearer {operator-token}" http://localhost:{port}/api/status
# ZeroClaw (public):
curl http://localhost:{port}/healthStep 5: Restart
If the container is stuck:
nomad job restart tenant-{slug}