# Runbooks Index

> Operational runbooks for diagnosing and recovering ClawAI. Start with the
> **symptom → runbook** table, then drill into the categorized list.

## Symptom → runbook

| Symptom                                      | Start here                                                                                                                            |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| A service won't start / crash-loops          | [runbook-service-crash.md](runbook-service-crash.md) → check Docker logs, DB reachability, migrations                                 |
| Requests are slow / timing out               | [runbook-high-latency.md](runbook-high-latency.md)                                                                                    |
| A database is corrupt / needs restore        | [runbook-database-recovery.md](runbook-database-recovery.md)                                                                          |
| Routing picks the "wrong" model              | [runbook-routing-misclassification.md](runbook-routing-misclassification.md)                                                          |
| `ollama pull` / model download fails         | [runbook-model-pull-failure.md](runbook-model-pull-failure.md)                                                                        |
| TLS / cert / `Hostname doesn't match` errors | [troubleshoot-tls.md](troubleshoot-tls.md)                                                                                            |
| Local frontier (llama.cpp) issues            | [frontier-troubleshooting.md](frontier-troubleshooting.md) · [frontier-first-time-walkthrough.md](frontier-first-time-walkthrough.md) |
| Workspace connector sync failing             | [runbook-workspace-automation.md](runbook-workspace-automation.md)                                                                    |
| Anything else                                | [troubleshooting.md](troubleshooting.md) · [operational-runbooks.md](operational-runbooks.md)                                         |

> **Before any runbook**, do the standard triage from
> [../../skills/04-debug-toolkit.md](../../skills/04-debug-toolkit.md): Docker
> logs → DB query → API curl → RabbitMQ → nginx. Most incidents are diagnosed in
> that order. For build/compile failures, see
> [../08-runtime-devops/build-system.md §7](../08-runtime-devops/build-system.md#7-gotchas--troubleshooting).

## By category

### Core operations

- [operational-runbooks.md](operational-runbooks.md) — day-to-day ops
- [troubleshooting.md](troubleshooting.md) — general troubleshooting
- [runbook-service-crash.md](runbook-service-crash.md)
- [runbook-high-latency.md](runbook-high-latency.md)
- [runbook-database-recovery.md](runbook-database-recovery.md)
- [troubleshoot-tls.md](troubleshoot-tls.md)

### Routing & models

- [runbook-routing-misclassification.md](runbook-routing-misclassification.md)
- [runbook-model-pull-failure.md](runbook-model-pull-failure.md)

### Local frontier (llama.cpp)

- [frontier-first-time-walkthrough.md](frontier-first-time-walkthrough.md)
- [frontier-troubleshooting.md](frontier-troubleshooting.md)

### Desktop agent & capability framework

- [runbook-capability-framework.md](runbook-capability-framework.md)
- [runbook-filesystem-capability.md](runbook-filesystem-capability.md)
- [runbook-process-capability.md](runbook-process-capability.md)
- [runbook-browser-capability.md](runbook-browser-capability.md)
- [runbook-screen-capability.md](runbook-screen-capability.md)
- [runbook-application-capability.md](runbook-application-capability.md)
- [runbook-audio-capability.md](runbook-audio-capability.md)
- [runbook-clipboard-notification.md](runbook-clipboard-notification.md)
- [runbook-recipe-engine.md](runbook-recipe-engine.md)
- [runbook-activity-memory.md](runbook-activity-memory.md)
- [runbook-cross-os-evidence.md](runbook-cross-os-evidence.md)
- [runbook-desktop-agent-security.md](runbook-desktop-agent-security.md)
- [runbook-desktop-agent-qa-release-gate.md](runbook-desktop-agent-qa-release-gate.md)
- [runbook-desktop-agent-release-channels.md](runbook-desktop-agent-release-channels.md)
- [runbook-tauri-shell-release.md](runbook-tauri-shell-release.md)
- [runbook-marketplace.md](runbook-marketplace.md)

### Fleet & enterprise

- [runbook-fleet.md](runbook-fleet.md)
- [runbook-fleet-enterprise-sso.md](runbook-fleet-enterprise-sso.md)
- [runbook-saml-sso-production-tenant.md](runbook-saml-sso-production-tenant.md)

### Workspace

- [runbook-workspace-automation.md](runbook-workspace-automation.md)
