OpenClaw 5.28: Plugin Codex Quebrado Após Atualização — Corrigir com Shim de Link Simbólico

Atualizar o OpenClaw de 5.12 para 5.28 pode quebrar silenciosamente o plugin Codex. Após a atualização, todas as chamadas de agente travam em Waiting for agent reply, tarefas cron expiram exatamente em 121 segundos com model-call-started, e a cadeia de fallback não atua rápido o suficiente. O gateway inicia limpo, o OAuth é válido e o Codex aparece como instalado e ativado — mas toda tentativa de execução do binário falha com um ENOENT silencioso.

Causa Raiz: Caminho Incorreto

O plugin Codex 5.28 espera o binário em:

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

Mas o pacote disponibiliza o binário em:

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

O plugin nunca encontra o binário, então cada tentativa de execução trava.

Solução: Criar um Link Simbólico (Shim)

Defina o diretório de extensões do Codex e crie o link simbólico:

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

Após reiniciar, as chamadas de agente devem voltar ao normal.

Observações Importantes

• Reinstalar ou forçar a atualização do plugin Codex limpa o diretório de extensões, então você precisa recriar o link simbólico após cada reinstalação.
• Se o serviço systemd usar um ExecStartPost com chmod no binário do Codex, atualize esse caminho para bin/codex também.

Isso foi reproduzido no Ubuntu 24.04, com npm install e serviço systemd. Espero que isso economize algumas horas de depuração.