2026 OpenClaw auf physischem Fern-Mac: MCP mit stdio & Streamable HTTP—reproduzierbares Runbook (spawn ENOENT, Protokoll-Version, Tool-Timeouts + CLI + FAQ)

2. stdio vs. Streamable HTTP: welcher Transport wann?

Wählen Sie den Transport mit den wenigsten beweglichen Teilen auf demselben Host; wechseln Sie zu HTTP, wenn Sie einen Server teilen oder Auth am Proxy terminieren müssen.

3. Siebenschrittiges reproduzierbares Rollout

1. Identität erfassen — Benutzer, dem OpenClaw gehört, LaunchAgent-Label und cwd aus launchctl print bzw. Service-Unit notieren.
2. stdio ohne Gateway replayen — Als dieser User /bin/bash -lc 'which node; node -v' und exakt den MCP-Befehl mit gleicher env-Datei ausführen.
3. stdio-Config härten — Absolute Pfade für command, explizites args, optionales cwd und explizites env (siehe JSON unten).
4. Optionaler HTTP-Pfad — MCP-HTTP an 127.0.0.1 binden, TLS auf nginx/Caddy terminieren, mit curl -v die erwartete Accept-Aushandlung prüfen.
5. Versionen pinnen — MCP-SDK/Server-Paket auf dieselbe major.minor wie die Client-Bibliothek in OpenClaw; beides im Changelog festhalten.
6. Timeout-Budget — tools/call-P95 mit realistischen Inputs messen; Client-Wartezeit ≥ P95×1,5 mit harter Obergrenze.
7. Log-Vertrag — Pro initialize, tools/list und tools/call eine JSON-Zeile mit gemeinsamer Korrelations-ID.

Für dauerhafte Agenten-Flows nach Neustarts sollten Sie dieses Runbook mit Backup-, Log- und Scheduler-Mustern aus dem OpenClaw-Gateway-Runbook zu Cron, Backup und JSONL abstimmen.

4. CLI-Konfigurationsfragmente (illustratives JSON)

Passe die Schlüssel an Ihr OpenClaw- oder Host-Schema an; entscheidend sind absolute Pfade und explizite Umgebungsblöcke.

{
  "mcpServers": {
    "repo-tools": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/usr/local/lib/mcp-servers/repo-tools/dist/main.js"],
      "cwd": "/Users/shared/mcp/repo-tools",
      "env": {
        "PATH": "/opt/homebrew/bin:/usr/bin:/bin",
        "NODE_ENV": "production"
      }
    }
  }
}

{
  "mcpServers": {
    "legacy-npx": {
      "command": "/bin/bash",
      "args": ["-lc", "exec npx --yes @example/[email protected]"],
      "env": { "HOME": "/Users/shared" }
    }
  }
}

{
  "mcpServers": {
    "http-shared": {
      "url": "https://mcp.internal.example.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${MCP_EDGE_TOKEN}"
      }
    }
  }
}

5. Symptom-Runbooks

5.1 spawn ENOENT (stdio)

5.2 Protokollversion / 406 (Streamable HTTP)

Server- und Client-Handshake-Logs nebeneinander legen. Erwartet der Server text/event-stream, der Proxy injiziert aber gzip ohne Flush, hängen Clients mit „Versionskonflikt“, obwohl Semver passend wirkt.

5.3 Tool-Timeouts

Drei Timer charten: (A) Modell/Tool-Router-Wartezeit, (B) Gateway-Upstream-Frist, (C) interne Job-Frist im MCP-Server. Zuerst die engste Schicht anpassen, benachbarte nur erweitern, wenn Traces Warteschlangen belegen.

6. Zahlen für SLO-Dokumente

• ca. 4 W — Leerlaufverbrauch Apple-Silicon-Mac mini mit SSH und leichten Gateways—nützlich für TCO gegenüber x86-Türmen mit höherem Idle.
• 25 s — Faustregel-Obergrenze für „schnelle“ tools/call-P95 auf geteilten Knoten; darüber Tools splitten oder Teilergebnisse streamen statt Timeouts endlos zu erhöhen.
• 600 s — Lang laufende Wartung (große Repo-Scans) gehört in asynchrone Jobs mit Polling, nicht in einen blockierenden MCP-Call—analog zu langen Git/npm-Läufen in CI-Spiegeln. Dazu passen Artefakt- und Runner-Entscheidungen aus dem GitHub-Actions-Leitfaden: selbst gehosteter macOS-Runner vs. ephemeres Mac.

7. FAQ