Initial version of the Hermes self learning agent setup of JR IT Services.

2026-04-21 11:53:29 +02:00
commit 7f9b0e6c5f
31 changed files with 1966 additions and 0 deletions
@@ -0,0 +1,44 @@
+# Parallelbetrieb mit OpenClaw
+
+## Empfehlung
+
+Lass OpenClaw in einem **separaten Compose-Projekt** laufen.
+
+Das Repo hier geht davon aus, dass OpenClaw bereits existiert oder separat gepflegt wird. Dadurch bleiben Updates, Logik und Fehlersuche voneinander getrennt.
+
+## Regeln gegen Konflikte
+
+- andere Host-Ports als Hermes verwenden
+- eigenes Volume oder eigener Basisordner fuer OpenClaw
+- eigener Compose-Projektname
+- wenn moeglich kein gemeinsamer Schreibzugriff auf denselben Host-Pfad
+- Shared-Netz nur verwenden, wenn es einen echten Grund gibt
+- fuer Internetzugang idealerweise dasselbe Muster verwenden: **eigenes externes Macvlan-Netz auf `br0` oder bewusst dasselbe externe `br0`-Netz mit eigener IP**
+
+## Sichere Defaults
+
+Hermes expose't nur lokal:
+
+- `127.0.0.1:18642/tcp` fuer API/Health
+- `127.0.0.1:19119/tcp` fuer Dashboard, falls aktiviert
+
+OpenClaw sollte auf einem **anderen** Host-Port laufen, z. B. `127.0.0.1:18080` oder `127.0.0.1:18081`, je nach Image.
+
+## `br0`-Hinweis
+
+Wenn OpenClaw wie Hermes ueber `br0` ins Netz soll, hast du zwei saubere Optionen:
+
+1. **gleiches externes Docker-Netz** verwenden, mit eigener statischer IP je Container
+2. **separates zweites Macvlan-Netz** auf demselben Parent `br0` anlegen
+
+Option 1 ist einfacher. Option 2 ist strenger getrennt.
+
+## Wann das Shared-Netz sinnvoll ist
+
+Nur wenn sich OpenClaw und Hermes wirklich gegenseitig erreichen muessen, z. B. fuer einen lokalen Upstream-Endpoint oder Kontrollpfad. Ansonsten reicht die komplette Trennung.
+
+## Beispiel fuer OpenClaw
+
+Siehe `compose/openclaw.override.example.yaml`.
+
+Das ist bewusst nur eine Vorlage, weil der OpenClaw-Docker-Oekosystem-Stand momentan fragmentiert ist und verschiedene Images unterschiedliche Environment-Variablen erwarten.