Skip to content
🧭
Infrastructure Β· System district

Infrastructure Layer

Open this district for the host-versus-container contract, ingress model, and the next route that owns the deeper answer.
Validated Β· Oct 6, 2026The infrastructure proof still matches the current platform stack, the API Reference service-map directory, and the Observability district's OpenObserve-first source-health rule. The infrastructure boundary sends live telemetry and missing-data questions to Observability before Atlas re-explains the platform here.
Current snapshot
  • Host shape: One Mac mini still anchors the whole substrate, with local persistence and a single place to reason about trust, ports, and restart paths.
  • Runtime split: Clawdy now serves as a native OpenClaw host process while most specialist agents still run as Docker workloads with the same shared bridge-network assumptions.
  • Ingress rule: Tailscale remains the normal team path; Funnel only exposes selected public entry points like Bridge, hooks, Oracle, the Linear Agent Gateway, Samwise, and QMD.
  • Boundary: Atlas explains placement, persistence, and shared-service ownership here first, then sends live telemetry and missing-data questions to Observability and uses API Reference only after the service-owning route is clear.
Best first stop

Choose the infrastructure question you arrived with

The district page is the quick sorter. Pick the question closest to yours so Atlas can route you toward the stack, the map, the live-signal lane, or the short contract without teaching every platform detail at once.
Current first move

Start with Platform Stack

Open the street page when the missing answer is host layout, runtime placement, networking, or deployment mechanics in more concrete detail.

Best when

Best when you already know the question is about ports, host-versus-container placement, restart mechanics, or the concrete runtime shape.

You can stop after

Stop once you can name the host surface, the workload placement, and the layer that owns the next operational move.

Current contract

Keep the infrastructure layers separate

Atlas stays trustworthy here when it separates host shape, workload placement, ingress, and shared platform services instead of collapsing them into one vague platform blob.
Single-host by design

Jake's Mac mini remains the physical and virtual anchor for the network, which keeps trust, restart paths, and local persistence legible instead of hiding them behind a distributed platform story.

Host

Atlas documents the simplicity on purpose: one host, one storage surface, and one place where host-native control surfaces and containerized workloads meet.

Mixed runtime fleet

Clawdy now serves directly from a native OpenClaw host process while Scout, Atticus, Meg, Grafton, and Samwise continue to run as containerized workloads with shared bridge-network assumptions.

Placement

The infrastructure story is no longer "everything is a container." The safe mental model is host-level gateway plus specialist containers, with Atlas pointing readers to the live stack detail only when they truly need it.

Private by default, selectively public

Tailscale is still the default access path. Funnel only fronts the small public ingress layer for Bridge, hooks, Oracle, the Linear Agent Gateway, Samwise, and QMD.

Ingress

That boundary keeps Atlas educational: Infrastructure explains which ingress model exists, while Observability and the deeper stack page handle the live questions those surfaces raise.

Shared platform services live at the infrastructure layer

Bridge, Recall/QMD, RAG Sync, Currybox, Kokoro Proxy, Drop, the QMD Public Proxy, and the observability compatibility layer are host-level shared services, not free-floating route owners.

Shared services

Atlas should point readers toward the service-owning route when the question becomes specific. API Reference now carries the older request-shape context only after that split is clear, while Observability owns live-signal interpretation.

Persistence and historical surfaces

Know what persists, and which old observability pieces are only context now

This is where Atlas should keep the storage story honest without drifting into a full host runbook.
Agent workspace

The bind-mounted workspace at /home/node/.openclaw/workspace persists projects, charter state, logs, memory, and shared execution surfaces across restarts.

Legacy observability DB

Historical SQLite context stays on the host filesystem for collector-era request shapes, but current telemetry lands in OpenObserve, and Watchtower interprets it against expected state.

QMD vector store

The host-level embedding store persists across restarts so Recall/QMD and the QMD Public Proxy do not need a full re-index unless the store is intentionally cleared.

Observability compatibility layer

Infrastructure still documents the legacy collector compatibility surface, but Atlas now treats it as background context while current live evidence flows through OpenObserve-first observability routes.

Change mechanics

Use the current restart and deploy rules, not the old all-containers assumption

Infrastructure questions often turn into change questions. This section keeps the shortest truthful answer visible before readers over-rotate into host surgery.
Agent context files update without a rebuild

Editing AGENTS.md, ROADMAP/BLOCKERS/SCRATCHPAD surfaces, or shared skills changes the next cycle's behavior without rebuilding an app image.

OpenClaw gateway restarts are a host control move

Use the gateway restart path when the host-level assistant surface needs a bounce. It is distinct from container redeploys and does not imply a full platform restart.

Currykit service changes publish through GitHub Actions

Shared services stay independent: bump the package, merge to main, let CI publish, then restart the affected host service instead of treating every change like a fleet-wide deploy.

Web app deploys stay route-local

Atlas and sibling web apps still build inside their project repos; the infrastructure district should explain that they are consumers of the platform, not the platform itself.

New ports or containers still need Jake-level host edits

Adding host wiring or new public mappings remains a real owner boundary. Atlas can explain the dependency, but it cannot pretend that a containerized charter owns host-level compose and entrypoint changes.

Explore infrastructure

Platform Stack

Go deeper on host layout, runtime placement, networking, and deployment mechanics.

Open Platform Stack
Observability Layer

Leave for live signal, Watchtower interpretation, and telemetry-path questions.

Open Observability Layer
Knowledge Layer

Use this when the infrastructure question is really about Recall/QMD, RAG Sync, or the QMD Public Proxy boundary.

Open Knowledge Layer
Network map

Zoom out to see how the host, shared services, and agent fleet connect on the wider topology.

Open Network map