Enquête sur le bogue ACP : une incompatibilité de protocole provoque l'erreur 'metadata is missing' avec Ollama local

Bug Confirmé dans l'Intégration ACP/OpenClaw

Un développeur a identifié et documenté un bug affectant l'intégration ACP (Agent Control Protocol) avec OpenClaw lors de l'utilisation de modèles Ollama locaux. Le problème empêche les commandes acpx spawn de fonctionner correctement.

Détails de l'Environnement

• OpenClaw : 2026.3.13
• acpx : Dernière version (npm -g)
• Ollama : Local (kimi-k2.5:cloud, glm-5:cloud)
• Système d'exploitation : macOS (Apple Silicon)
• Node : v22.19.0

Le Bug

Commandes qui échouent :

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

Messages d'erreur reçus :

Erreur ACP (ACP_SESSION_INIT_FAILED) : Les métadonnées ACP sont manquantes pour l'agent : main:acp:...

Échec de l'analyse du message JSON : [commands] /help /commands /status...
SyntaxError : Token inattendu 'c', "[commands] ..." n'est pas un JSON valide

Ce qui Fonctionne vs Ce qui ne Fonctionne Pas

Fonctionnel :

• openclaw acp client --help (le client démarre)
• openclaw acp client (mode autonome)
• acpx config show (la configuration se charge)

Non Fonctionnel :

• acpx spawn exec -- "test" (échoue avec "les métadonnées sont manquantes")
• acpx spawn sessions new --name test (échoue à créer une session)
• Toute commande ACP spawn

Analyse de la Cause Racine

Le problème semble être une incompatibilité de protocole :

• acpx lance la commande de l'agent (openclaw acp client)
• Le client démarre et produit du texte (message d'aide, informations de session)
• acpx attend des messages JSON via le pipe
• L'analyse JSON échoue → "les métadonnées sont manquantes" → le lancement échoue

Log clé montrant le problème :

[acpx] lancement de l'agent : openclaw acp client
[client] initialisation (en cours d'exécution)
Échec de l'analyse du message JSON : [commands] /help /commands...
→ acpx attend du JSON, reçoit du texte

Statut Actuel

Solution de contournement : Aucune trouvée. Le problème est au niveau du protocole entre acpx et openclaw acp client.

Alternative : Utiliser runtime: "subagent" au lieu d'ACP — fonctionne parfaitement.

Impact : Impossible d'utiliser ACP pour les agents autonomes de longue durée avec Ollama local.

Priorité : Moyenne (subagent fonctionne, mais ACP serait meilleur pour les workflows complexes).

Le développeur a demandé à l'équipe OpenClaw d'enquêter sur pourquoi openclaw acp client produit du texte au lieu du JSON lorsqu'il est lancé par acpx, s'il manque un drapeau --json ou une option de configuration, et si c'est un problème connu avec les configurations Ollama locales.