ACP-Fehleruntersuchung: Protokollkonflikt verursacht 'Metadaten fehlen'-Fehler mit lokalem Ollama

Fehler in der ACP/OpenClaw-Integration bestätigt

Ein Entwickler hat einen Fehler identifiziert und dokumentiert, der die ACP (Agent Control Protocol)-Integration mit OpenClaw bei der Verwendung lokaler Ollama-Modelle betrifft. Das Problem verhindert, dass acpx spawn-Befehle ordnungsgemäß funktionieren.

Umgebungsdetails

• OpenClaw: 2026.3.13
• acpx: Neueste Version (npm -g)
• Ollama: Lokal (kimi-k2.5:cloud, glm-5:cloud)
• OS: macOS (Apple Silicon)
• Node: v22.19.0

Der Fehler

Befehle, die fehlschlagen:

acpx spawn exec -- "test"
# oder
acpx spawn sessions new --name test

Erhaltene Fehlermeldungen:

ACP-Fehler (ACP_SESSION_INIT_FAILED): ACP-Metadaten fehlen für Agent:main:acp:...

Fehler beim Parsen der JSON-Nachricht: [commands] /help /commands /status...
SyntaxError: Unerwartetes Token 'c', "[commands] ..." ist kein gültiges JSON

Was funktioniert vs. was nicht

Funktioniert:

• openclaw acp client --help (Client startet)
• openclaw acp client (Standalone-Modus)
• acpx config show (Konfiguration lädt)

Funktioniert nicht:

• acpx spawn exec -- "test" (scheitert mit "Metadaten fehlen")
• acpx spawn sessions new --name test (kann keine Sitzung erstellen)
• Jeder ACP spawn-Befehl

Ursachenanalyse

Das Problem scheint ein Protokollkonflikt zu sein:

• acpx startet den Agenten-Befehl (openclaw acp client)
• Der Client startet und gibt Text aus (Hilfemeldung, Sitzungsinformationen)
• acpx erwartet JSON-Nachrichten über die Pipe
• JSON-Parsing scheitert → "Metadaten fehlen" → spawn scheitert

Wichtiges Protokoll, das das Problem zeigt:

[acpx] startet Agenten: openclaw acp client
[client] initialisiert (läuft)
Fehler beim Parsen der JSON-Nachricht: [commands] /help /commands...
→ acpx erwartet JSON, erhält Text

Aktueller Status

Workaround: Kein Workaround gefunden. Das Problem liegt auf Protokollebene zwischen acpx und openclaw acp client.

Alternative: runtime: "subagent" anstelle von ACP verwenden – funktioniert einwandfrei.

Auswirkung: ACP kann nicht für langlebige autonome Agenten mit lokalem Ollama verwendet werden.

Priorität: Mittel (subagent funktioniert, aber ACP wäre für komplexe Workflows besser).

Der Entwickler hat das OpenClaw-Team gebeten zu untersuchen, warum openclaw acp client Text statt JSON ausgibt, wenn er von acpx gestartet wird, ob ein fehlendes --json-Flag oder eine Konfigurationsoption vorliegt und ob dies ein bekanntes Problem bei lokalen Ollama-Setups ist.