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

# Architecture - Overview

High-level map of the assistant environment, external touchpoints, and core infrastructure.

```mermaid
flowchart TB
    Will([Will])
    Discord[Discord]
    Telegram[Telegram]
    Google[Google Workspace]
    Internet[Internet services]
    Tail[Tailscale]

    subgraph Edge[Will laptop / homelab edge]
        direction TB

        subgraph VM[OpenClaw VM]
            direction TB
            OC[OpenClaw runtime]
            WS[Workspace memory<br/>scripts and notes]
        end

        subgraph Host[Host services<br/>192.168.153.130]
            direction LR
            Search[SearXNG<br/>18803]
            Brave[Brave MCP<br/>18802]
            N8N[n8n-agent<br/>18808]
            Whisper[whisper.cpp<br/>18801]
            TTS[Kokoro TTS<br/>18805]
            Embed[Ollama embeddings<br/>18807]
            LLM[llama.cpp Gemma<br/>18806]
            VaultAPI[Obsidian API<br/>27123]
        end
    end

    MinIO[MinIO backup target<br/>192.168.153.253:9000]
    Gitea[Gitea repo host]
    K8s[Pi Kubernetes cluster<br/>namespace: swarm]
    Vault[Shared Obsidian vault]

    Will --> Discord
    Will --> Telegram
    Will --> Vault

    Discord --> OC
    Telegram --> OC

    OC --> WS
    OC --> Search
    OC --> Brave
    OC --> N8N
    OC --> Whisper
    OC --> TTS
    OC --> Embed
    OC --> LLM
    OC --> VaultAPI
    OC --> Google
    OC --> Internet
    OC --> Tail
    Tail --> Gitea
    OC --> K8s
    WS --> MinIO
    VaultAPI --> Vault

    classDef person fill:#fdf6b2,stroke:#8a6d1d,color:#3b2f00;
    classDef comms 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;
    classDef infra fill:#f3f3f3,stroke:#7a7a7a,color:#333333;

    class Will person;
    class Discord,Telegram,Google,Internet comms;
    class OC,WS core;
    class Search,Brave,N8N,Whisper,TTS,Embed,LLM,VaultAPI svc;
    class MinIO,Gitea,Vault store;
    class Tail,K8s infra;
```
