OpenClaw two-lane capture: RFC 0167 accepted, spawns decisions 0168-0170 + spec 0171

[philcunliffe]

Docs-only change set recording the accepted redesign of OpenClaw capture.

What this records

RFC 0167 (Accepted) replaces the steering-plugin mechanism with two lanes that need nothing installed on the OpenClaw side:

1. Live wire lane: hyp attach --client openclaw writes two models.providers entries (anthropic at the gateway bare origin, openai at origin + /v1, each with a static x-hypaware-upstream header and the mandatory models: []). The existing gateway rung and projector gate work unchanged.
2. Transcript sweep lane: the session-file backfill provider runs on a 5-minute daemon schedule, so every OpenClaw turn on every provider (including the LLP 0146 deferred families) is captured at transcript fidelity. Overlap with the live lane nets to zero writes through settlement + part_id dedupe; a quiesce window skips recently-active files to avoid the settlement race.

All six verify-before-build items were executed against a live install before acceptance and are recorded in the RFC ({#verify-results}), including two falsified assumptions that amended the design: agent models.json caches do not self-heal (detach rewrites them) and a running gateway needs openclaw gateway restart to pick up the override.

Spawned docs

• LLP 0168: the config override replaces plugin steering (supersedes 0152; moots 0145/0148)
• LLP 0169: the attach surface returns - refuse + create-only, json_path revival, cache rewrite on detach, attach-on-join symmetry (supersedes 0143)
• LLP 0170: the scheduled transcript sweep (supersedes 0149; no escaped-traffic ledger)
• LLP 0171: the implementable spec, R1-R12; 0157's R8-R11/R14 remain binding

0143/0145/0148/0149/0152 are marked Superseded with forward-ref blockquotes; 0157/0161/0162 carry Extended-by notes.

Implementation consequences (future PRs, not this one)

• Deletes the ~2,100-line openclaw-steering-plugin/ package and its test wrapper (0171 R9)
• Prerequisite: the OpenClaw backfill projects 0 rows from real session files: message fields are read at the top level but OpenClaw nests them under 'message' #543 envelope fix (0171 R8) - the sweep projects nothing until the reader reads the nested message envelope
• Resolves the OpenClaw half of hyp status shows a permanent 'attach openclaw [pending]', 'not attached', and an inert client_attach_missing repair for probe-less clients #544 (hyp status gets a truthful probe)
• A configured openai upstream drops the x-hypaware-upstream steering rung, so a steered turn routes nowhere #539 verified moot for this design (the /v1-shaped URLs route by path prefix even past a configured upstream)

Checks

• ref-check: these 13 docs contribute zero errors (the corpus's 91 pre-existing errors are untouched, all elsewhere)
• npm test: 3261/3264 pass; the one failure (usage-policy-fold) fails identically on a clean master tree on this machine and is unrelated to this docs-only diff

🤖 Generated with Claude Code