Investigação de Bug do ACP: Incompatibilidade de Protocolo Causa Erro 'metadata is missing' com Ollama Local

Bug Confirmado na Integração ACP/OpenClaw

Um desenvolvedor identificou e documentou um bug que afeta a integração do ACP (Protocolo de Controle de Agente) com o OpenClaw ao usar modelos locais do Ollama. O problema impede que os comandos acpx spawn funcionem corretamente.

Detalhes do Ambiente

• OpenClaw: 2026.3.13
• acpx: Mais recente (npm -g)
• Ollama: Local (kimi-k2.5:cloud, glm-5:cloud)
• Sistema Operacional: macOS (Apple Silicon)
• Node: v22.19.0

O Bug

Comandos que falham:

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

Mensagens de erro recebidas:

Erro ACP (ACP_SESSION_INIT_FAILED): Metadados ACP estão ausentes para o agente:main:acp:...

Falha ao analisar mensagem JSON: [commands] /help /commands /status...
SyntaxError: Token inesperado 'c', "[commands] ..." não é um JSON válido

O que Funciona vs. O que Não Funciona

Funcionando:

• openclaw acp client --help (cliente inicia)
• openclaw acp client (modo autônomo)
• acpx config show (configuração carrega)

Não Funcionando:

• acpx spawn exec -- "test" (falha com "metadados ausentes")
• acpx spawn sessions new --name test (falha ao criar sessão)
• Qualquer comando de spawn do ACP

Análise da Causa Raiz

O problema parece ser uma incompatibilidade de protocolo:

• acpx inicia o comando do agente (openclaw acp client)
• O cliente inicia e emite texto (mensagem de ajuda, informações da sessão)
• acpx espera mensagens JSON através do pipe
• A análise do JSON falha → "metadados ausentes" → spawn falha

Registro chave mostrando o problema:

[acpx] iniciando agente: openclaw acp client
[client] inicializando (executando)
Falha ao analisar mensagem JSON: [commands] /help /commands...
→ acpx espera JSON, recebe texto

Status Atual

Solução Alternativa: Nenhuma encontrada. O problema está no nível do protocolo entre acpx e openclaw acp client.

Alternativa: Usar runtime: "subagent" em vez de ACP — funciona perfeitamente.

Impacto: Não é possível usar o ACP para agentes autônomos de longa duração com Ollama local.

Prioridade: Média (subagent funciona, mas o ACP seria melhor para fluxos de trabalho complexos).

O desenvolvedor solicitou que a equipe do OpenClaw investigue por que openclaw acp client emite texto em vez de JSON quando iniciado pelo acpx, se há uma flag --json ou opção de configuração ausente, e se este é um problema conhecido em configurações locais do Ollama.