---
title: Architecture - Service Topology
area: infrastructure
tags: [infrastructure, architecture, diagrams, services]
created: 2026-04-16
updated: 2026-05-19
status: active
related: [[Infrastructure/Architecture]], [[Infrastructure/Architecture - Overview]], [[Infrastructure/Architecture - Automation Flow]], [[Infrastructure/Services/Docker Services]]
---

# Architecture - Service Topology

Runtime-focused view showing how the assistant core depends on local services, storage, and cluster targets.

```mermaid
flowchart TB
    Sessions[User sessions<br/>webchat, Discord, Telegram]

    subgraph RuntimeLayer[OpenClaw VM]
        direction TB
        Runtime[OpenClaw runtime]
        Memory[Memory search<br/>sqlite + retrieval]
        Cron[OpenClaw cron]
        Scripts[Workspace scripts]
    end

    subgraph HostServices[Host service layer]
        direction LR
        Search[SearXNG<br/>18803]
        BraveMCP[Brave MCP<br/>18802]
        Embeddings[Ollama embeddings<br/>18807]
        LocalLLM[llama.cpp Gemma<br/>18806]
        Workflow[n8n-agent<br/>18808]
        STT[whisper.cpp<br/>18801]
        Voice[Kokoro TTS<br/>18805]
        ObsidianAPI[Obsidian API<br/>27123]
    end

    subgraph Persistence[Persistence and targets]
        direction LR
        MinIO[MinIO bucket<br/>zap]
        Gitea[Gitea repo<br/>will/swarm-zap.git]
        Swarm[Pi cluster<br/>namespace: swarm]
    end

    Sessions --> Runtime
    Runtime --> Memory
    Runtime --> Cron
    Runtime --> Scripts

    Runtime --> Search
    Runtime --> BraveMCP
    Memory --> Embeddings
    Runtime --> LocalLLM
    Runtime --> Workflow
    Runtime --> STT
    Runtime --> Voice
    Runtime --> ObsidianAPI

    Scripts --> MinIO
    Scripts --> Gitea
    Runtime --> Swarm

    classDef edge fill:#dcecff,stroke:#4a78b8,color:#17365d;
    classDef core fill:#e8f5e9,stroke:#4f8a5b,color:#1f4d2d;
    classDef svc fill:#eef3ff,stroke:#6a7fb8,color:#25324a;
    classDef store fill:#f7e8ff,stroke:#8b62b3,color:#44235e;

    class Sessions edge;
    class Runtime,Memory,Cron,Scripts core;
    class Search,BraveMCP,Embeddings,LocalLLM,Workflow,STT,Voice,ObsidianAPI svc;
    class MinIO,Gitea,Swarm store;
```
