docs: document native Codex hook relay recovery · openclaw/openclaw@da1a343
steipete
·
2026-05-28
·
via Recent Commits to openclaw:main
| Original file line number | Diff line number | Diff line change |
|---|
@@ -734,14 +734,21 @@ that any custom `appServer.command`, `url`, `authToken`, or headers are valid.
|
734 | 734 | headers, and that the remote app-server speaks the same Codex app-server |
735 | 735 | protocol version. |
736 | 736 | |
| 737 | +**Native shell or patch tools are blocked with `Native hook relay unavailable`:** |
| 738 | +the Codex thread is still trying to use a native hook relay id that OpenClaw no |
| 739 | +longer has registered. This is a native Codex hook transport problem, not an ACP |
| 740 | +backend, provider, GitHub, or shell-command failure. Start a fresh session in |
| 741 | +the affected chat with `/new` or `/reset`, then retry a harmless command. If the |
| 742 | +same fresh session still fails, restart the Codex app-server or OpenClaw Gateway |
| 743 | +so native hook registrations are recreated. |
| 744 | + |
737 | 745 | **A non-Codex model uses the built-in harness:** that is expected unless |
738 | 746 | provider or model runtime policy routes it to another harness. Plain non-OpenAI |
739 | 747 | provider refs stay on their normal provider path in `auto` mode. |
740 | 748 | |
741 | 749 | **Computer Use is installed but tools do not run:** check |
742 | 750 | `/codex computer-use status` from a fresh session. If a tool reports |
743 | | -`Native hook relay unavailable`, use `/new` or `/reset`; if it persists, restart |
744 | | -the gateway to clear stale native hook registrations. See |
| 751 | +`Native hook relay unavailable`, use the native hook relay recovery above. See |
745 | 752 | [Codex Computer Use](/plugins/codex-computer-use#troubleshooting). |
746 | 753 | |
747 | 754 | ## Related |
|
| Original file line number | Diff line number | Diff line change |
|---|
@@ -834,6 +834,13 @@ permission modes, see
|
834 | 834 | | ACP session stalls indefinitely after completing work | Harness process finished but ACP session did not report completion. | Update OpenClaw; current acpx cleanup reaps OpenClaw-owned stale wrapper and adapter processes on close and Gateway startup. | |
835 | 835 | | Harness sees `<<<BEGIN_OPENCLAW_INTERNAL_CONTEXT>>>` | Internal event envelope leaked across the ACP boundary. | Update OpenClaw and rerun the completion flow; external harnesses should receive plain completion prompts only. | |
836 | 836 | |
| 837 | +<Note> |
| 838 | +`Command blocked by PreToolUse hook: Native hook relay unavailable` belongs to |
| 839 | +the native Codex hook relay, not ACP/acpx. In a bound Codex chat, start a fresh |
| 840 | +session with `/new` or `/reset`; if it persists, restart the Codex app-server or |
| 841 | +OpenClaw Gateway. See [Codex harness troubleshooting](/plugins/codex-harness#troubleshooting). |
| 842 | +</Note> |
| 843 | + |
837 | 844 | ## Related |
838 | 845 | |
839 | 846 | - [ACP agents - setup](/tools/acp-agents-setup) |
|
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。
