OpenClaw 5.28: Codex Plugin Broken After Upgrade — Fix with Symlink Shim
Upgrading OpenClaw from 5.12 to 5.28 can silently break the Codex plugin. After the upgrade, all agent calls hang at Waiting for agent reply, cron jobs time out at exactly 121 seconds with model-call-started, and the fallback chain doesn't kick in fast enough. The gateway starts clean, OAuth is valid, and Codex shows as installed and enabled — but every binary spawn attempt fails with a silent ENOENT.
Root Cause: Path Mismatch
The 5.28 Codex plugin harness expects the binary at:
vendor/x86_64-unknown-linux-musl/codex/codexBut the package ships the binary at:
vendor/x86_64-unknown-linux-musl/bin/codexThe plugin never finds the binary, so every spawn attempt hangs.
Fix: Create a Symlink Shim
Set the Codex extension directory and symlink the binary:
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 openclawAfter restart, agent calls should resume normally.
Important Caveats
- Reinstall or force-update of the Codex plugin wipes the extensions directory, so you must recreate the symlink after each reinstall.
- If your systemd service uses an
ExecStartPostchmod on the Codex binary, update that path tobin/codexas well.
This was reproduced on Ubuntu 24.04, npm install, systemd service. Hopefully this saves you a few hours of debugging.
📖 Read the full source: r/openclaw
👀 See Also
Practical Multi-Agent System Architecture Advice from Experience
A developer shares five specific patterns for building multi-agent AI systems based on experience running a 7-agent daily system: start with one agent, use an orchestrator pattern, implement shared memory with JSON files, route models by task, and add confirmation loops.
CLAUDE.md Constitution: Building a Personal AI Agent — Part II File Walkthrough
A CEO shares the annotated CLAUDE.md file — 16 sections covering identity, proactive initiative, memory, deadlines, and hard rules — built over 6 weeks for a 50-person company.
Configuring OpenClaw for Smooth Agent-to-Agent Communication
A Reddit user shares specific configuration settings for OpenClaw that reduce timeouts in agent-to-agent communication, including tool visibility settings, memory directives, and workarounds for the ANNOUNCE_SKIP limitation.
Optimizing AutoResearch on RTX 5090: What Failed and What Worked
A developer shares specific configuration details for running AutoResearch on an RTX 5090/Blackwell setup, including failed approaches that appeared functional but performed poorly, and the working configuration that achieved stable results with TOTAL_BATCH_SIZE=2**17 and TIME_BUDGET=1200.