OpenClaw 5.28: アップグレード後にCodexプラグインが破損 – シンボリックリンクシムで修正

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サービスで再現されました。これで数時間のデバッグが不要になれば幸いです。