Investigación de Errores de ACP: Desajuste de Protocolo Provoca el Error 'metadata is missing' con Ollama Local

Error Confirmado en la Integración ACP/OpenClaw

Un desarrollador ha identificado y documentado un error que afecta la integración de ACP (Protocolo de Control de Agente) con OpenClaw al usar modelos locales de Ollama. El problema impide que los comandos acpx spawn funcionen correctamente.

Detalles del Entorno

• OpenClaw: 2026.3.13
• acpx: Última versión (npm -g)
• Ollama: Local (kimi-k2.5:cloud, glm-5:cloud)
• Sistema Operativo: macOS (Apple Silicon)
• Node: v22.19.0

El Error

Comandos que fallan:

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

Mensajes de error recibidos:

Error de ACP (ACP_SESSION_INIT_FAILED): Falta metadatos de ACP para el agente:main:acp:...

Error al analizar el mensaje JSON: [commands] /help /commands /status...
SyntaxError: Token inesperado 'c', "[commands] ..." no es un JSON válido

Lo que Funciona vs. Lo que No

Funciona:

• openclaw acp client --help (el cliente se inicia)
• openclaw acp client (modo independiente)
• acpx config show (la configuración se carga)

No Funciona:

• acpx spawn exec -- "test" (falla con "metadata is missing")
• acpx spawn sessions new --name test (falla al crear sesión)
• Cualquier comando de generación ACP

Análisis de la Causa Raíz

El problema parece ser una incompatibilidad de protocolo:

• acpx genera el comando del agente (openclaw acp client)
• El cliente se inicia y produce texto (mensaje de ayuda, información de sesión)
• acpx espera mensajes JSON a través de la tubería
• El análisis JSON falla → "metadata is missing" → la generación falla

Registro clave que muestra el problema:

[acpx] generando agente: openclaw acp client
[client] inicializar (en ejecución)
Error al analizar el mensaje JSON: [commands] /help /commands...
→ acpx espera JSON, recibe texto

Estado Actual

Solución Temporal: No se ha encontrado ninguna. El problema está a nivel de protocolo entre acpx y openclaw acp client.

Alternativa: Usar runtime: "subagent" en lugar de ACP — funciona perfectamente.

Impacto: No se puede usar ACP para agentes autónomos de larga duración con Ollama local.

Prioridad: Media (subagent funciona, pero ACP sería mejor para flujos de trabajo complejos).

El desarrollador ha solicitado al equipo de OpenClaw que investigue por qué openclaw acp client produce texto en lugar de JSON cuando es generado por acpx, si falta una bandera --json o una opción de configuración, y si este es un problema conocido con configuraciones locales de Ollama.