diff --git a/docs/plugins/architecture.md b/docs/plugins/architecture.md
index 1783fb6bfa7..4de8c088eef 100644
--- a/docs/plugins/architecture.md
+++ b/docs/plugins/architecture.md
@@ -228,7 +228,7 @@ Core now defers shared poll parsing until after plugin poll dispatch declines
 the action, so plugin-owned poll handlers can accept channel-specific poll
 fields without being blocked by the generic poll parser first.
 
-See [Load pipeline](#load-pipeline) for the full startup sequence.
+See [Plugin architecture internals](/plugins/architecture-internals) for the full startup sequence.
 
 ## Capability ownership model
 
diff --git a/docs/reference/credits.md b/docs/reference/credits.md
index 12b461eeafa..4fcf4a2d3ad 100644
--- a/docs/reference/credits.md
+++ b/docs/reference/credits.md
@@ -32,4 +32,4 @@ MIT - Free as a lobster in the ocean.
 ## Related
 
 - [Token use and costs](/reference/token-use)
-- [Release policy](/reference/release-policy)
+- [Release policy](/reference/RELEASING)
diff --git a/docs/reference/rich-output-protocol.md b/docs/reference/rich-output-protocol.md
index 99c0350019d..be790e9defe 100644
--- a/docs/reference/rich-output-protocol.md
+++ b/docs/reference/rich-output-protocol.md
@@ -57,5 +57,5 @@ Stored/rendered rich blocks use this `canvas` shape directly. `present_view` is
 
 ## Related
 
-- [RPC adapters](/reference/rpc-adapters)
+- [RPC adapters](/reference/rpc)
 - [Typebox](/concepts/typebox)
diff --git a/docs/reference/rpc.md b/docs/reference/rpc.md
index b3581549577..3382c443d10 100644
--- a/docs/reference/rpc.md
+++ b/docs/reference/rpc.md
@@ -42,5 +42,4 @@ See [iMessage](/channels/imessage) for legacy setup and addressing (`chat_id` pr
 
 ## Related
 
-- [RPC adapters](/reference/rpc-adapters)
 - [Gateway protocol](/gateway/protocol)
diff --git a/docs/tools/acp-agents.md b/docs/tools/acp-agents.md
index 3b6feaaa349..9f3e52c1205 100644
--- a/docs/tools/acp-agents.md
+++ b/docs/tools/acp-agents.md
@@ -530,7 +530,7 @@ plugin-tools and OpenClaw-tools MCP bridges, and ACP permission modes, see
 | `Sandboxed sessions cannot spawn ACP sessions ...`                          | ACP runtime is host-side; requester session is sandboxed.                       | Use `runtime="subagent"` from sandboxed sessions, or run ACP spawn from a non-sandboxed session.                                                                  |
 | `sessions_spawn sandbox="require" is unsupported for runtime="acp" ...`     | `sandbox="require"` requested for ACP runtime.                                  | Use `runtime="subagent"` for required sandboxing, or use ACP with `sandbox="inherit"` from a non-sandboxed session.                                               |
 | Missing ACP metadata for bound session                                      | Stale/deleted ACP session metadata.                                             | Recreate with `/acp spawn`, then rebind/focus thread.                                                                                                             |
-| `AcpRuntimeError: Permission prompt unavailable in non-interactive mode`    | `permissionMode` blocks writes/exec in non-interactive ACP session.             | Set `plugins.entries.acpx.config.permissionMode` to `approve-all` and restart gateway. See [Permission configuration](#permission-configuration).                 |
+| `AcpRuntimeError: Permission prompt unavailable in non-interactive mode`    | `permissionMode` blocks writes/exec in non-interactive ACP session.             | Set `plugins.entries.acpx.config.permissionMode` to `approve-all` and restart gateway. See [ACP agents setup](/tools/acp-agents-setup).                           |
 | ACP session fails early with little output                                  | Permission prompts are blocked by `permissionMode`/`nonInteractivePermissions`. | Check gateway logs for `AcpRuntimeError`. For full permissions, set `permissionMode=approve-all`; for graceful degradation, set `nonInteractivePermissions=deny`. |
 | ACP session stalls indefinitely after completing work                       | Harness process finished but ACP session did not report completion.             | Monitor with `ps aux \| grep acpx`; kill stale processes manually.                                                                                                |