From a0fc6fe23684c1f289af4490e25c537aa4d684c0 Mon Sep 17 00:00:00 2001
From: OpenClaw <openclaw@example.com>
Date: Fri, 6 Mar 2026 23:49:32 +0000
Subject: [PATCH] fix(#18): Dokumentation der reproduzierbaren
 Runner-Konfiguration

---
 docs/runner-config.md | 47 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 docs/runner-config.md

diff --git a/docs/runner-config.md b/docs/runner-config.md
new file mode 100644
index 0000000..f1d84ae
--- /dev/null
+++ b/docs/runner-config.md
@@ -0,0 +1,47 @@
+# Codex-Bridge Runner-Konfiguration
+
+## Ziel
+
+Diese Dokumentation beschreibt eine reproduzierbare Konfiguration für den Codex-Bridge Runner, um wiederholte Blocker durch unterschiedliche Pfade und Read-only-Verhältnisse zu vermeiden.
+
+## Soll-Pfadmapping
+
+Das Pfadmapping zwischen dem Host-System und dem Runner-Container ist wie folgt definiert:
+
+- Host: `/home/openclaw/.openclaw/workspace/helpyourneighbour`
+- Container: `/Users/openclaw/workspace/helpyourneighbour`
+
+## Erforderliche Runner-Rechte
+
+Der Runner benötigt folgende Rechte:
+- Schreibzugriff auf das Repository
+- Berechtigung zum Pushen in den `main`-Branch
+
+## Preflight-Check
+
+Bevor ein Codex-Run gestartet wird, muss ein Smoke-Check durchgeführt werden:
+
+1. Prüfen, ob das Repository existiert.
+2. Prüfen, ob der Runner Schreibrechte hat.
+3. Testdatei erstellen und löschen (`touch test && rm test`).
+
+## Beispiel-Smoke-Check
+
+```bash
+#!/bin/bash
+set -e
+
+# Prüfe, ob das Repo existiert
+if [ ! -d ".git" ]; then
+  echo "Fehler: Kein Git-Repo gefunden."
+  exit 1
+fi
+
+# Prüfe Schreibrechte
+touch test && rm test || {
+  echo "Fehler: Keine Schreibrechte im Repository."
+  exit 1
+}
+
+echo "Preflight-Check erfolgreich"
+```