diff --git a/README.md b/README.md
index 4df729e..a9c7d93 100644
--- a/README.md
+++ b/README.md
@@ -40,3 +40,22 @@ Sobald du Änderungen an deiner lokalen `.env` machst, musst du diese neu versch
 ```bash
 age -r <DEIN_AGE_PUBLIC_KEY> -o services/paperclip/.env.age services/paperclip/.env
 ```
+
+## LLM Konfiguration & Onboarding Workaround
+
+Paperclip ist in seiner Benutzeroberfläche bei der Erstinstallation stark auf offizielle **OpenAI**- oder **Anthropic (Claude)**-Accounts fokussiert. Wenn du stattdessen alternative Provider wie **OpenRouter** oder **Mistral** nutzen möchtest, greift ein Workaround im Deployment-Prozess:
+
+1. **API Keys in der `.env` hinterlegen:**
+   Trage deine gewünschten API-Keys in die `services/paperclip/.env` ein (z. B. `OPENROUTER_API_KEY=sk-or-v1-...`).
+
+2. **Automatischer Patch durch das Deploy-Skript:**
+   Das `deploy_script.sh` erkennt automatisch, wenn ein `OPENROUTER_API_KEY` (oder `MISTRAL_API_KEY`) vorhanden ist, aber kein nativer OpenAI/Claude-Key. Es führt dann folgende Schritte aus:
+   * Setzt `OPENAI_API_KEY` auf deinen OpenRouter/Mistral-Key.
+   * Setzt `OPENAI_BASE_URL` auf die entsprechende API-URL (z. B. `https://openrouter.ai/api/v1`).
+   * **WICHTIG:** Das Skript patcht den Paperclip-Container (die Datei `ai-connections.js`) direkt nach dem Start. Dadurch wird sichergestellt, dass die strenge UI-Validierung beim Onboarding deine alternative URL (`OPENAI_BASE_URL`) verwendet und nicht hartcodiert bei OpenAI anfragt.
+
+3. **Das Onboarding in der UI abschließen:**
+   * Sobald du deinen CEO-Account über den Invite-Link erstellst, landest du im Schritt "Connect a model".
+   * Klicke hier auf die Schaltfläche **OpenAI (API)**.
+   * Füge exakt deinen **OpenRouter-** oder **Mistral-Key** in das Textfeld ein und klicke auf "Connect".
+   * Paperclip testet den Key nun erfolgreich gegen deinen Provider und lässt dich ins Dashboard!