Bouw een privé AI-agentwerkruimte met Hermes, NAS, GitHub, Obsidian en Telegram

Eva Wong

IceWhale author

Eva Wong is de Technisch Schrijver en en vaste knutselaar bij ZimaSpace. Een levenslange geek met een passie voor homelabs en open-source software, zij is gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva gelooft dat zelf-hosting leuk moet zijn, niet intimiderend. Met haar tutorials stelt ze de community in staat om hardware-setup te ontrafelen, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Build a Private AI Agent Workspace with Hermes, NAS, GitHub, Obsidian, and Telegram - Zima Store Online

Als je AI-agent alleen draait wanneer je laptop open is, is het nog steeds een desktoptool. Een privé AI-agent werkruimte heeft een stabiele plek nodig om te draaien, een geheugensysteem dat het kan lezen en bijwerken, een versiegeschiedenis die je kunt bekijken en een eenvoudige manier om taken van overal te verzenden.

Een praktische stack is: Hermes als agent-runtime, NAS of VM als 24/7 basis, Obsidian als Markdown-geheugen, GitHub als synchronisatie- en beoordelingslaag, Telegram als commandointerface en lokale AI-tools zoals Ollama en Open WebUI wanneer privacy of kosten belangrijk zijn.

Wat deze werkruimte eigenlijk doet

Deze setup verandert verspreid AI-gebruik in een herhaalbare workflow. In plaats van tekst te kopiëren tussen ChatGPT, notities, GitHub en berichtapps, stuur je één commando, laat je Hermes het verwerken, sla je het resultaat op in Obsidian, volg je de wijziging in GitHub en ontvang je de output in Telegram.

Probleem	Werkruimte Fix	Hulpmiddel
Agent vergeet projectcontext	Sla persistente geheugen op in Markdown	Obsidian
Agent-wijzigingen zijn moeilijk te vertrouwen	Volg elke bewerking met versiegeschiedenis	GitHub
Laptop kan geen taken 24/7 uitvoeren	Verplaats runtime naar altijd-aan hardware	NAS / VM
Taken zijn moeilijk op afstand te verzenden	Gebruik een mobiel commandokanaal	Telegram
Routine AI-aanroepen kosten te veel	Voer eenvoudige taken lokaal uit wanneer mogelijk	Ollama / Open WebUI

Gebruik Hermes als de Agent Runtime

Hermes Agent is de runtime-laag. Het ontvangt taken, houdt context bij, werkt met vaardigheden, communiceert via berichtkanalen en kan geplande taken uitvoeren. In deze stack is Hermes de werker; de NAS is waar de werker woont.

Begin niet door Hermes volledige controle over alles te geven. Begin met beperkte taken: een notitie samenvatten, een link opslaan, een dagelijkse briefing maken, een GitHub-repository controleren of een Telegram-antwoord opstellen ter goedkeuring. Voor de Hermes-laag volg de officiële ZIMA handleiding zodat de agent-runtime wordt geïnstalleerd op dezelfde altijd-aan werkruimte die je kluis, logs en automatiseringstaken opslaat.

Beste eerste Hermes-taken

Taak	Invoer	Output
Sla een link op	Telegram-URL	Obsidian-notitie met samenvatting en tags
Dagelijkse projectbriefing	GitHub-wijzigingen + recente notities	Telegram samenvatting
Onderzoeksopname	Tekst, screenshot of spraakmemo	Gestructureerde notitie in `wiki/`
Concept goedkeuring	Prompt of binnenkomend bericht	Concept verzonden naar Telegram vóór actie

Draai de Agent op NAS of VM, niet alleen op desktop

Een desktop is goed voor het bewerken van notities en het bekijken van wijzigingen. Het is slecht voor altijd-aan automatisering. Een NAS of VM is beter voor cron-taken, achtergrondsync, Telegram-bots, logs en langlopende agenttaken.

Hier past ZimaSpace natuurlijk. Een ZimaBoard 2 persoonlijke server is genoeg voor een lichte Hermes-werkruimte met Telegram, GitHub-synchronisatie, cron en Obsidian-bestanden. Een ZimaCube 2 AI NAS is zinvoller wanneer de kluis groot is, bestanden belangrijk zijn, of je Ollama, Open WebUI, RAG en teamopslag op één plek wilt.

Gebruik Obsidian als de agentgeheugenlaag

Obsidian werkt omdat het geheugen leesbaar blijft. Het lokale Markdown-gegevensopslagmodel betekent dat notities als platte bestanden binnen een kluis leven. Mensen kunnen ze bewerken. Agenten kunnen ze lezen en bijwerken.

Houd de kluis gestructureerd. Laat de agent niet overal schrijven waar hij wil.

kluis/
├── AGENTS.md
├── LLMMEMORIES.md
├── SYSTEMPROMPT.md
├── raw/
├── wiki/
└── .obsidian/

Bestand / Map	Doel	Agentregel
`AGENTS.md`	Werkruimte regels	Lees eerst; bewerk alleen met beoordeling
`LLMMEMORIES.md`	Persistente project- en gebruikerscontext	Lees vaak; werk zorgvuldig bij
`SYSTEMPROMPT.md`	Stijl-, output- en gedragsvoorkeuren	Lees voor het schrijven
`raw/`	Originele bronnen, PDF's, screenshots, transcripties	Alleen-lezen
`wiki/`	Schone notities, samenvattingen, gekoppelde kennis	Hoofd schrijfgebied

Schrijf een duidelijke AGENTS.md vóór automatisering

AGENTS.md is het belangrijkste bestand in de kluis. Het vertelt Hermes hoe te handelen voordat het je notities aanraakt.

# AGENTS.md

Voor het schrijven:
1. Lees LLMMEMORIES.md.
2. Controleer bestaande wiki/-notities voordat je een nieuwe maakt.
3. Bewerk nooit raw/.
4. Schrijf nieuwe gestructureerde notities alleen in wiki/.
5. Gebruik duidelijke titels en interne links.
6. Voeg bronlinks toe bij het samenvatten van extern materiaal.
7. Vraag goedkeuring voordat je AGENTS.md, SYSTEMPROMPT.md of LLMMEMORIES.md bewerkt.
8. Stuur na elke voltooide taak een Telegram-samenvatting.

Dit ene bestand voorkomt de meeste vroege fouten: dubbele notities, rommelige naamgeving, overschreven bronnen en geheugenafwijking van de agent.

Gebruik GitHub als de beoordelingslaag

Door agent geschreven geheugen heeft geschiedenis nodig. GitHub geeft je verschillen, terugdraaien, branches, privé repositories en menselijke beoordeling. Dat is belangrijk omdat een agent het ene moment nuttige notities kan schrijven en het volgende moment je kennisbasis kan vervuilen.

De Obsidian GitHub Sync plugin kan een Obsidian-kluis verbinden met GitHub. Het eigen repository-bestanden- en revisiegeschiedenismodel van GitHub geeft de kluis een gecontroleerde backend in plaats van dat agentbewerkingen onopgemerkt blijven.

Eenvoudige beoordelingsworkflow

Je bewerkt notities in Obsidian.
De kluis synchroniseert met een privé GitHub-repository.
Hermes leest de nieuwste context.
Hermes schrijft alleen naar goedgekeurde mappen.
Wijzigingen worden via GitHub gesynchroniseerd.
Je beoordeelt verschillen voordat je de update als langetermijngeheugen vertrouwt.

Gebruik Telegram als het Controlekanaal

Telegram is de snelste manier om de agent te gebruiken als je niet aan je bureau bent. Stuur een link, spraakbericht, taak, screenshot of commando. Hermes verwerkt het op de NAS en stuurt het resultaat terug.

De Telegram messages.sendMessage API ondersteunt het terugsturen van berichten naar een chat, wat Telegram nuttig maakt voor samenvattingen, herinneringen, goedkeuringsverzoeken en voltooiingsmeldingen.

Nuttige Telegram-commando's

Commando	Agentactie
Sla deze link op	Vat de URL samen en schrijf het naar `wiki/`
Onthoud dit	Voeg een korte vermelding toe aan `LLMMEMORIES.md` na goedkeuring
Geef me een korte briefing	Vat de GitHub-wijzigingen en nieuwe notities van vandaag samen
Stel een antwoord op	Maak een concept en stuur het terug ter goedkeuring
Vind gerelateerde notities	Doorzoek de kluis en geef gekoppelde context terug

Bouw de Eerste Workflow: Telegram naar Obsidian

De beste eerste workflow is vastleggen. Begin niet met volledige automatisering. Begin met het omzetten van Telegram-berichten in schone Obsidian-notities.

Stap	Actie	Output
1	Stuur een Telegram-bericht of URL	Invoer ontvangen door Hermes
2	Hermes classificeert de invoer	Taaktype: link, notitie, herinnering, onderzoek, concept
3	Hermes leest `AGENTS.md`	Juiste map en schrijfregelement geselecteerd
4	Hermes maakt een notitie aan	Markdown-bestand in `wiki/` of inbox
5	GitHub synchroniseert de wijziging	Beoordeelbare versiegeschiedenis
6	Hermes stuurt een Telegram-samenvatting	Je weet wat er is opgeslagen

Voeg Cron Toe Nadat Vastleggen Werkt

Geplande taken moeten komen nadat de basis vastleglus stabiel is. Hermes cron is nuttig wanneer de taak een duidelijke trigger, voorspelbare output en laag risico heeft.

Gebruik de Hermes cron automatiseringsgids voor terugkerende taken zoals dagelijkse briefings, GitHub-monitoring, notitie-opruiming, link-samenvattingen en herinneringsworkflows.

Goede cron-taken voor een privéwerkruimte

Cron-taak	Wordt uitgevoerd wanneer	Schrijft naar
Dagelijkse briefing	Elke ochtend	`wiki/dagelijks/` en Telegram
GitHub wijzigingssamenvatting	Eens per dag	Projectnotitie
Inbox opruimen	Elke avond	Gekoppelde wiki-pagina's
Samenvatting leeswachtrij	Twee keer per week	Onderzoeksnotitie

Voeg Lokale AI Alleen Toe Waar Het Helpt

Lokale AI is handig voor routinematig werk: notities samenvatten, inhoud taggen, actiepunten extraheren, transcripties opschonen en antwoorden geven vanuit een privécontext. Cloud AI is nog steeds beter voor moeilijke redeneringen, uitgebreid onderzoek en complexe codering.

Een Ollama en Open WebUI zelfhostinggids is een goede referentie voor de lokale modellagen. In deze architectuur beheert Ollama lokale modellen, biedt Open WebUI een zelfgehoste interface en bepaalt Hermes hoe het werk moet verlopen.

Taak	Lokaal model	Cloudmodel
Korte notities samenvatten	Goede match	Optioneel
Obsidian-pagina's taggen	Goede match	Meestal onnodig
Telegram-berichten classificeren	Goede match	Meestal onnodig
Complexe codeertaak	Afhankelijk van model	Vaak beter
Diep onderzoeksrapport	Nuttig voor voorbewerking	Vaak beter voor eindredenering

Houd automatisering veilig

Begin met lezen, samenvatten, opslaan en melden. Stel risicovolle acties uit totdat de workflow bewezen is.

Actie	Aanbevolen Regel
Lezen `raw/`	Toegestaan
Schrijven naar `wiki/`	Toegestaan nadat regels zijn getest
Bewerken `LLMMEMORIES.md`	Vereist beoordeling
Bewerken `AGENTS.md`	Vereist beoordeling
Externe berichten verzenden	Vereist Telegram-goedkeuring
Bestanden verwijderen	Standaard blokkeren
Code pushen	Vereist branch- en menselijke beoordeling

Aanbevolen Starter Architectuur

Telegram
   ↓
Hermes Agent
   ↓
NAS / VM
   ├── Obsidian Vault
   │   ├── AGENTS.md
   │   ├── LLMMEMORIES.md
   │   ├── SYSTEMPROMPT.md
   │   ├── raw/
   │   └── wiki/
   ├── GitHub Sync
   ├── Cron Jobs
   ├── Logs
   └── Optionele Lokale AI
       ├── Ollama
       └── Open WebUI

Bouw het in deze volgorde: eerst de kluis, dan GitHub-synchronisatie, dan Telegram-captatie, dan Hermes-workflow, dan cron, dan lokale AI. Dit voorkomt de veelgemaakte fout om veel tools te installeren voordat de geheugenstructuur klaar is.

Belangrijkste conclusie

Hermes geeft de agent een runtime. Obsidian geeft het geheugen. GitHub geeft jou controle over wijzigingen. Telegram geeft een externe interface. NAS geeft het hele systeem een stabiele plek om te draaien.

Daarom past dit onderwerp bij ZimaSpace. Een NAS is niet langer alleen voor back-up of mediabewaring. Voor AI-agentgebruikers wordt het de privé-infrastructuurlaag voor geheugen, automatisering en 24/7 persoonlijke workflows.

FAQ

Kan Hermes Obsidian gebruiken als langetermijngeheugen?

Ja. Hermes kan een Obsidian-kluis gebruiken als langetermijngeheugen zolang de kluis is gestructureerd met duidelijke regels, leesbare Markdown-bestanden en veilige schrijfrechten.

Waarom GitHub gebruiken met Obsidian voor AI-agents?

GitHub maakt agentbewerkingen controleerbaar. Als Hermes een slechte notitie schrijft of het geheugen verkeerd wijzigt, kun je het verschil inspecteren, het bestand terugdraaien of de regels aanscherpen in AGENTS.md.

Kan Telegram een AI-agent op een NAS aansturen?

Ja. Telegram kan opdrachten, links, notities en goedkeuringsbeslissingen naar de agent sturen. De agent kan samenvattingen, concepten, herinneringen en voltooiingsberichten terugsturen naar Telegram.

Heb ik lokale AI-modellen nodig voor deze werkruimte?

Nee. Je kunt beginnen met cloudmodellen. Lokale modellen worden nuttig wanneer je lagere kosten wilt voor routinetaken, betere privacy voor interne notities, of een zelfgehoste AI-interface.

Welk ZimaSpace-apparaat past bij deze workflow?

ZimaBoard 2 past bij een lichte Hermes-werkruimte met Telegram, cron, GitHub-synchronisatie en Obsidian. ZimaCube 2 past bij een grotere AI NAS-werkruimte met meer bestanden, RAG, Open WebUI, Ollama en teamopslag.