Deployment & Operations
Deploy ClawQL with Helm (charts/clawql-mcp) for the full IDP stack, or run clawql-mcp locally for a minimal MCP surface.
Operations guide: Deployment & Operations Guide — shipped Helm paths, health checks, day-2 ops. Planned Operator / CRD model: Operator target architecture (#255).
Shipped paths (use today)
| Goal | Start here |
|---|---|
| Full local IDP stack (Docker Desktop) | make local-k8s-up → Kubernetes · Helm |
| Tier 1 Docker Compose | examples/clawql-local-docker-compose — Compose README |
| Minimal MCP | Quickstart |
| Seven-vendor document pipeline | IDP Platform · Document pipeline learn page · IDP hub (repo) |
| Dashboard + Agent Chat | Dashboard on Kubernetes |
| Managed VM tiers (AWS/GCP/CF) | Golden host images — Packer bake + Pulumi provision |
| Secrets & upgrades | Operations guide · Helm |
Platform operations
- Streamable HTTP & Cloud Run — HTTP transport, gRPC, Docker image
- OpenClaw + ClawQL — gateway integration
- Security overview — golden image pipeline and Kyverno
- Docker Desktop: Istio & observability — lab mTLS + LGTMP
- Tailscale & Headscale — private tailnet MCP access
Planned (design only)
The full three-tier Operator vision beyond the 7.0 scaffold, and the broader four-stack Docker Compose layout (#251), remain design references. Tier 1 Compose and the opt-in ClawQLInstance scaffold already ship — see Operator target architecture.
All deployment topics
Operations guide
Day-2 ops, health, secrets, and Helm paths.
Kubernetes & Helm
Docker Desktop local cluster, chart, Kustomize.
Helm chart reference
charts/clawql-mcp values, Ingress, GHCR images.
Istio & observability lab
Prometheus, Grafana, Tempo, Kiali, OTel on Desktop.
Private tailnet access
Tailscale / Headscale for remote MCP without public ingress.
Dashboard on Kubernetes
Bundled dashboard UI, Vault sync, and Helm wiring.
OpenClaw + ClawQL
Register clawql-mcp in OpenClaw — HTTP/stdio and smoke path.