ACPバグ調査：ローカルOllamaでの「metadata is missing」エラーはプロトコル不一致が原因

ACP/OpenClaw統合におけるバグが確認されました

開発者が、ローカルのOllamaモデルを使用する際のACP（エージェント制御プロトコル）とOpenClawの統合に影響を与えるバグを特定し、文書化しました。この問題により、acpx spawnコマンドが正常に機能しなくなっています。

環境詳細

• OpenClaw: 2026.3.13
• acpx: 最新版（npm -g）
• Ollama: ローカル（kimi-k2.5:cloud, glm-5:cloud）
• OS: macOS（Apple Silicon）
• Node: v22.19.0

バグの詳細

失敗するコマンド:

acpx spawn exec -- "test"
# または
acpx spawn sessions new --name test

受信したエラーメッセージ:

ACP error (ACP_SESSION_INIT_FAILED): ACP metadata is missing for agent:main:acp:...

Failed to parse JSON message: [commands] /help /commands /status...
SyntaxError: Unexpected token 'c', "[commands] ..." is not valid JSON

動作するものとしないもの

動作するもの:

• openclaw acp client --help（クライアントが起動）
• openclaw acp client（スタンドアロンモード）
• acpx config show（設定が読み込まれる）

動作しないもの:

• acpx spawn exec -- "test"（"metadata is missing"で失敗）
• acpx spawn sessions new --name test（セッション作成に失敗）
• ACP spawnコマンド全般

根本原因の分析

問題はプロトコルの不一致にあるようです:

• acpxがエージェントコマンド（openclaw acp client）を起動
• クライアントが起動し、テキスト（ヘルプメッセージ、セッション情報）を出力
• acpxはパイプ経由でJSONメッセージを期待
• JSONの解析に失敗 → "metadata is missing" → 起動に失敗

問題を示す重要なログ:

[acpx] spawning agent: openclaw acp client
[client] initialize (running)
Failed to parse JSON message: [commands] /help /commands...
→ acpxはJSONを期待するが、テキストを受信

現在の状況

回避策: 見つかっていません。問題はacpxとopenclaw acp client間のプロトコルレベルにあります。

代替手段: ACPの代わりにruntime: "subagent"を使用する — 完全に動作します。

影響: ローカルのOllamaを使用した長時間実行される自律エージェントにACPを使用できません。

優先度: 中程度（subagentは動作しますが、複雑なワークフローにはACPの方が優れています）。

開発者は、OpenClawチームに対し、なぜopenclaw acp clientがacpxによって起動された際にJSONではなくテキストを出力するのか、--jsonフラグや設定オプションが不足していないか、そしてこれがローカルのOllama設定における既知の問題であるかどうかを調査するよう要請しました。