ACP 버그 조사: 로컬 Ollama에서 '메타데이터 누락' 오류를 유발하는 프로토콜 불일치

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 오류 (ACP_SESSION_INIT_FAILED): 에이전트:main:acp:...에 대한 ACP 메타데이터가 없습니다.

JSON 메시지 구문 분석 실패: [commands] /help /commands /status...
SyntaxError: 예상치 못한 토큰 'c', "[commands] ..."는 유효한 JSON이 아닙니다

작동하는 것 vs 작동하지 않는 것

작동:

• openclaw acp client --help (클라이언트 시작)
• openclaw acp client (독립 실행 모드)
• acpx config show (설정 로드)

작동하지 않음:

• acpx spawn exec -- "test" ("메타데이터가 없습니다" 오류로 실패)
• acpx spawn sessions new --name test (세션 생성 실패)
• 모든 ACP spawn 명령

근본 원인 분석

문제는 프로토콜 불일치로 보입니다:

• acpx가 에이전트 명령(openclaw acp client)을 생성
• 클라이언트가 시작되어 텍스트(도움말 메시지, 세션 정보)를 출력
• acpx는 파이프를 통해 JSON 메시지를 기대
• JSON 구문 분석 실패 → "메타데이터가 없습니다" → 생성 실패

문제를 보여주는 주요 로그:

[acpx] 에이전트 생성 중: openclaw acp client
[client] 초기화 (실행 중)
JSON 메시지 구문 분석 실패: [commands] /help /commands...
→ acpx는 JSON을 기대하지만 텍스트를 수신

현재 상태

임시 해결책: 발견되지 않음. 문제는 acpx와 openclaw acp client 사이의 프로토콜 수준에 있습니다.

대안: ACP 대신 runtime: "subagent" 사용 — 완벽하게 작동합니다.

영향: 로컬 Ollama와 함께 장기 실행 자율 에이전트에 ACP를 사용할 수 없습니다.

우선순위: 중간 (subagent가 작동하지만, 복잡한 워크플로우에는 ACP가 더 나을 것입니다).

개발자는 OpenClaw 팀에 acpx에 의해 생성될 때 openclaw acp client가 JSON 대신 텍스트를 출력하는 이유, 누락된 --json 플래그나 설정 옵션이 있는지, 그리고 이것이 로컬 Ollama 설정에서 알려진 문제인지 조사해 줄 것을 요청했습니다.