OpenClaw 5.28: 업그레이드 후 Codex 플러그인 손상 — 심볼릭 링크 심(Symlink Shim)으로 해결

OpenClaw를 5.12에서 5.28로 업그레이드하면 Codex 플러그인이 조용히 깨질 수 있습니다. 업그레이드 후 모든 에이전트 호출이 Waiting for agent reply에서 멈추고, cron 작업은 정확히 121초 후 model-call-started 오류와 함께 타임아웃되며, 대체 체인이 충분히 빨리 작동하지 않습니다. 게이트웨이는 정상적으로 시작되고, OAuth는 유효하며, Codex는 설치 및 활성화된 것으로 표시되지만, 모든 바이너리 실행 시도가 조용히 ENOENT 오류로 실패합니다.

근본 원인: 경로 불일치

5.28 Codex 플러그인은 다음 경로에서 바이너리를 찾습니다:

vendor/x86_64-unknown-linux-musl/codex/codex

하지만 패키지는 실제 바이너리를 다음 경로에 제공합니다:

vendor/x86_64-unknown-linux-musl/bin/codex

플러그인이 바이너리를 찾지 못해 모든 실행 시도가 중단됩니다.

해결 방법: 심볼릭 링크 생성

Codex 확장 디렉토리를 설정하고 바이너리에 대한 심볼릭 링크를 만듭니다:

CODEX_DIR="/home/clawbot/.openclaw/extensions/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl"
sudo mkdir -p "$CODEX_DIR/codex"
sudo ln -sf "$CODEX_DIR/bin/codex" "$CODEX_DIR/codex/codex"
sudo chown -h clawbot:clawbot "$CODEX_DIR/codex/codex"
sudo systemctl restart openclaw

재시작 후 에이전트 호출이 정상적으로 작동합니다.

중요 참고사항

• Codex 플러그인을 재설치하거나 강제 업데이트하면 확장 디렉토리가 초기화되므로 재설치 후 심볼릭 링크를 다시 생성해야 합니다.
• systemd 서비스가 Codex 바이너리에 대해 ExecStartPost chmod를 사용하는 경우 해당 경로도 bin/codex로 업데이트하세요.

이 문제는 Ubuntu 24.04, npm 설치, systemd 서비스에서 재현되었습니다. 이 내용이 디버깅 시간을 절약하는 데 도움이 되길 바랍니다.