1. Stolpersteine: MCP und Skills sind nicht „zwei Dateien mehr“
(1) Undurchsichtige Ladereihenfolge: Ohne klare Priorität zwischen Workspace-/skills, Benutzerpfaden und gebündelten Skills bearbeiten Sie Dateien, während der Agent weiter eine ältere Version liest.(2) Gateway-Snapshots im RAM: Einige Builds halten Skill-Metadaten im Speicher; ein unvollständiger Neustart lässt das Gespräch unverändert wirken.(3) MCP-Schema-Volumen: Mehrere Server injizieren riesige Tool-Beschreibungen und füllen 16k–32k-Fenster, bevor Nutzertext eintrifft.(4) Daemon-PATH: launchd-Jobs erben minimale Pfade; nvm/fnm-Shims aus der Login-Shell fehlen. Auf einem Remote-Mac 24/7 fällt die Diskrepanz schwerer auf, weil kein Terminal parallel offen ist.
2. Skills-Verzeichnispriorität
Hersteller ändern Pfadnamen zwischen Releases. Die Tabelle beschreibt die übliche Überschreibungslogik—höhere Zeilen sollten tieferliegende übertreffen. Validieren Sie absolute Pfade immer gegen die Dokumentation Ihrer installierten Version und Gateway-Logs.
| Schicht (hoch→niedrig) | Typischer Zweck | Prüfpunkt |
|---|---|---|
Workspace-/skills oder projektintern | Team-Workflows, Repo-spezifisch | Gateway-cwd entspricht dem erwarteten Workspace |
| Benutzer-Skills | Persönliche Experimente | Falsche YAML-Einrückung kann ganze Dateien still ignorieren |
| Gebündelte Defaults | Produktbaseline | Nach Upgrades zuerst Release Notes lesen |
3. MCP: kleinster geschlossener Kreis und Token-Budget
Verbinden Sie zuerst genau einen MCP-Server und verifizieren Sie Auth, Health und einen minimalen Tool-Call. Erst danach skalieren Sie. Messen Sie nach jedem Schritt die serialisierte Länge der Tool-Liste. Nähert sich system+tools der Fenstergrenze, verengen Sie Profile pro Kanal, verlagern Sie Tools in Subagenten oder wechseln Sie das Modell—statt blind weiterzukabeln und „Modellqualität“ zu beschuldigen.
4. Fünf-Schritte-Checkliste
Schritt 1: Workspace-Root und Skills-Scan-Pfade aus Gateway-Logs sichern.Schritt 2: Sichtbare Zeichenkette in genau einer SKILL-Datei ändern, Gateway vollständig neu starten, ob der Agent den Text zitiert.Schritt 3: Alle MCPs deaktivieren, einen aktivieren, Tool-Token-Baseline messen, dann iterativ reaktivieren.Schritt 4: Mit launchctl print oder Äquivalent Daemon-Umgebung und PATH gegen interaktive Shell vergleichen.Schritt 5: OAuth in Staging absichtlich ablaufen lassen und prüfen, ob Fehler laut oder still sind.
5. Symptomtabelle nach Gateway-Restarts
| Symptom | Wahrscheinliche Ursache | Maßnahme |
|---|---|---|
| SKILL-Änderungen unsichtbar | Andere Schicht gewinnt | Suchpfad loggen; eindeutige Markierung per grep suchen |
| Schwankende Toolzahl | MCP-Handshake scheitert leise | Debug-Level erhöhen; Server einzeln aktivieren |
| Tool sporadisch weg | Abgelaufenes OAuth/Refresh im Daemon kaputt | Re-Auth; Refresh im gleichen Umfeld wie Gateway |
| Kontext voll trotz kurzer Nutzereingabe | Gestapelte große Schemas | MCP reduzieren; Sessions splitten; Modell tauschen |
Referenzwerte (Betrieb, keine Herstellerangaben):
- Auf 16k-Klassenmodellen übersteigen ungefilterte MCP-Beschreibungen oft 10k Tokens summiert.
- Für Dauerbetrieb absolute Interpreterpfade in der plist hinterlegen, nicht auf Login-Shells vertrauen.
- Jeder neue öffentliche Kanal (IM, Webhook) erfordert eine erneute Least-Privilege-Prüfung der Tools; protokollieren Sie Zugriffe DSGVO-konform.
6. Tiefe Analyse: Tool-Governance ist Betrieb
MCP macht Integrationen composable, erhöht aber Kontextverbrauch und Autorisierungsfläche. Anders als klassische Microservices kann das LLM Tools jede Runde neu planen—liegen Policy-Filter hinter der Schema-Registrierung zurück, zahlen Sie doppelt: in Tokens und Risiko. Apple-Silicon-Macs eignen sich gut für leise Gateway-Dauerlast, dennoch spürt der einheitliche Speicher Mehrkanal- und Langläufer-Sessions. Das unterscheidet sich vom Öffnen weiterer Chat-Tabs, weil Tooldefinitionen dauerhaft auf der Systemseite des Prompts liegen.
Hohe Änderungsrate auf dem Laptop, produktives Gateway+MCP auf dedizierter Hardware zu trennen, entkoppelt Änderungsfrequenz von Blast-Radius. Notebooks sind ideal zum Experimentieren, koppeln aber Schlafmodus, Privatsoftware und schwankendes Uplink mit Team-SLAs.
Wenn stabiles Uplink, Daemon-Hygiene und 24/7-Betreuung zum Engpass werden, lohnt OpenClaw auf MACGPU-Remote-Macs: gleicher macOS-/Metal-Stack, klarere PATH- und Verfügbarkeitsprofile, stundenweise Abrechnung für Canarys vor Fixkosten. Das ist eine Platzierungsentscheidung für Grafik- und KI-Workflows, kein Marketingargument—dedizierte Remote-Knoten reduzieren Moving Parts gegenüber einem Alltags-Notebook.