How openclaw/openclaw-enterprise works
OpenClaw Enterprise is a vendor-neutral control plane for deploying and managing agents. The user workflow is to configure an installation, use the browser console or API to create an agent, and have the control plane provision it through compute and other drivers; operators can also reuse settings through presets. The graph preserves the documented runtime, persistence, authentication, and CLI capabilities. Source excerpts are partial, so some subsystem connections are documented at the product level rather than traced through every runtime call.
Main entry points: compute Compute Drivers · server.mjs API Server · installation-config.ts Installation Configuration · worker.ts Reconciliation Worker
Components 23
User Interfaces
- Browser Console
apps/controller/src/console - HTTP API
apps/controller/src/http - OCC CLI
internal/occcli
Control Plane
- API Server
apps/controller/src/server.mjs - Human Authentication
apps/controller/src/auth/index.ts - Installation Configuration
apps/controller/src/composition/installation-config.ts
Agent Lifecycle
- Resource Contracts
packages/contracts/src/api/resources.ts - API Route Schemas
packages/contracts/src/api/routes.ts - Identity and Authorization
packages/iam/src/index.ts - Resource Lifecycle
packages/occ/src - Reconciliation Worker
apps/controller/src/worker.ts - Work Queue
packages/occ/src/state/postgres-work-queue.ts - Agent Presets
packages/contracts/src/presets.ts
Drivers and Integrations
- Compute Drivers
apps/controller/src/drivers/compute - Kubernetes Runtime
apps/controller/src/drivers/compute/kubernetes/runtime-entrypoints.ts - OpenShell Sandbox
apps/controller/src/drivers/sandbox/openshell.ts - GitHub Repository Driver
apps/controller/src/drivers/repo/github/driver.ts - Slack Channel Driver
apps/controller/src/drivers/channel/slack.ts - Model Backends
apps/controller/src/backends
Platform Services
- Persistent State
packages/occ/src/state/postgres-state.ts - Repository Sessions
packages/occ/src/ports/repository-sessions.ts - Metrics
apps/controller/src/metrics/index.ts
Other components
- Operator
Connections 23
- Operator → Browser Console: manages agents
README.md - Operator → OCC CLI: operates platform
README.md - Browser Console → HTTP API: uses API
- HTTP API → API Server: served by
- API Server → Human Authentication: configures
apps/controller/src/server.mjs - API Server → Installation Configuration: loads configuration
apps/controller/src/server.mjs - API Server → Metrics: creates metrics
apps/controller/src/server.mjs - Installation Configuration → Compute Drivers: loads drivers
apps/controller/src/composition/installation-config.ts - HTTP API → API Route Schemas: implements routes
- API Route Schemas → Resource Contracts: uses schemas
packages/contracts/src/api/routes.ts - Reconciliation Worker → Resource Lifecycle: reconciles work
apps/controller/src/worker.ts - Reconciliation Worker → Work Queue: processes queued work
- Resource Lifecycle → Persistent State: persists lifecycle
- Persistent State → Work Queue: stores work
- Repository Sessions → Persistent State: persisted in
- Reconciliation Worker → Compute Drivers: provisions agents
apps/controller/src/worker.ts - Compute Drivers → Kubernetes Runtime: includes runtime
apps/controller/src/drivers/compute/kubernetes/repository-material.ts - Compute Drivers → OpenShell Sandbox: supports sandbox
- Compute Drivers → GitHub Repository Driver: uses repository driver
- Installation Configuration → Slack Channel Driver: loads channel driver
apps/controller/src/composition/installation-config.ts - Installation Configuration → Model Backends: configures backends
apps/controller/src/composition/installation-config.ts - Operator → Agent Presets: reuses settings
README.md - Agent Presets → Browser Console: fills draft
README.md