openclaw/docs
Peter Steinberger db793644e0
refactor(channels): drop pre-July-2026 Matrix state migrations (#163292)
## What Problem This Solves

Retires Matrix state imports whose last shipped JSON writers predate the July 2026 migration support window.

## User Impact

Upgrades from pre-July-2026 versions are no longer migrated: Matrix `thread-bindings.json` and `startup-verification.json`. Doctor and the affected runtime preserve those files and explain how to upgrade through OpenClaw 2026.9.5: run Doctor, start Matrix once to import them, then install the latest release.

July and newer SQLite bindings, verification cooldowns, device metadata, token-root selection, and schema upgrades remain supported. Public plugin SDK compatibility and other Matrix migrations are unchanged.

## Why This Change Was Made

Both file writers ended in `84a965a1a2` on May 30. The last confirmed stable JSON writer, `v2026.5.28`, was published May 30; `v2026.5.30-beta.1` first shipped SQLite on May 31, followed by stable `v2026.6.1` on June 3. Inspection of `v2026.7.1` confirms the same SQLite namespaces and keys, with no JSON rewrite or restoration path. The 2026.9.5 bridge retains both runtime imports.

Deletes JSON decoding, merging, import-marker stores, cleanup writes, and the obsolete thread-binding JSON root score. The plugin owns the source-preserving refusal; existing Doctor ordering and schema migration ownership stay intact. Net production reduction: 140 lines.

Other channel config aliases remain: supported July config rewrites can still preserve them. Separate owner follow-ups will cover independently proven formats.

## Evidence

- Independent isolated review: no actionable findings through P2.
- Matrix runtime/storage/Doctor boundary tests passed, including July-shaped binding keys and verification cooldowns, unchanged retired-file bytes, and archive exclusion.
- The intact shipped `v2026.7.1` account SQLite fixture upgraded through the actual Doctor CLI; canonical rows and archived database bytes remained intact.
- Doctor state/config migration suites passed. Plugin contracts: **1,132 tests / 48 files passed**.
- `node scripts/check-changed.mjs` passed; both `check-madge-import-cycles.ts` and `check-import-cycles.ts` report **0**.
- Linux single-worker wall measurements (`pnpm test <file> --maxWorkers=1`): Doctor import contract **2.89s**, storage **29.49s**, bindings **15.10s**, startup verification **13.73s**. No new process boot, timer, retry, or weakened assertion was added.

Proof used an isolated AWS checkout pinned to the base and byte-verified candidate patch. Hosted CI will validate the pushed head. Release history and retention decisions were checked separately from test execution.
2026-10-02 01:07:09 -05:00
..
.generated improve(ui): refresh and renew the community invitation (#163109) 2026-10-02 00:31:17 +00:00
.i18n feat: back up to external disks and Cloudflare R2 with storage locations (#161913) 2026-10-01 02:05:44 -07:00
announcements
assets docs: remove stale showcase section (#158575) 2026-09-25 21:11:35 -06:00
automation refactor(compat): retire pre-July skill metadata alias (#163104) 2026-10-01 22:12:52 -07:00
channels refactor(channels): drop pre-July-2026 Matrix state migrations (#163292) 2026-10-02 01:07:09 -05:00
ci ci: pin the OpenClaw Bun fork b368 prerelease (#163251) 2026-10-01 23:53:23 -05:00
cli fix(update): defer subagent recovery until activation (#162998) 2026-10-01 21:36:30 -05:00
concepts feat(agents): allow managed worktrees for hidden subagents (#163124) 2026-10-01 22:25:12 -05:00
diagnostics perf(cli): keep client diagnostics off shared state 2026-09-24 12:56:28 +00:00
gateway refactor(doctor): drop more pre-July-2026 config migrations (#163280) 2026-10-02 05:32:27 +00:00
help fix(plugins): enforce SDK alias scope and captured denial on Bun (#163198) 2026-10-01 23:09:00 -05:00
images
install fix(update): make global-install failures actionable and retry stale dependency caches (#163039) 2026-10-01 18:04:12 -07:00
maturity refactor: remove Tasks and TaskFlow runtime (#159179) 2026-09-27 10:40:29 -07:00
nodes fix(talk): preserve inherited realtime settings on upgrade (#162644) 2026-10-01 16:58:58 +00:00
platforms feat(macos): snooze sessions from the native sidebar (#163241) 2026-10-01 22:34:35 -07:00
plugins fix(storage): join WAL maintenance before database retirement (#162166) 2026-10-02 02:50:33 +00:00
providers docs(comfy): explain Cloud MCP OAuth setup (#163197) 2026-10-02 10:39:10 +07:00
reference fix(test): Gateway e2e connect fails with 1006 when another fixture takes the instance port (#163003) 2026-10-01 23:04:05 -07:00
releases docs: give Agents API its own onboarding guide (#162255) 2026-10-01 02:54:25 +00:00
security fix(gateway): preserve proxy policy in local TLS health probes (#161946) 2026-10-01 00:37:14 +08:00
snippets/plugin-publish chore(deps): refresh dependencies with seven-day cutoff (#158298) 2026-09-26 20:42:53 -07:00
specs
start fix(ui): stop serving a failed Control UI build on the next Gateway start (#161438) 2026-09-30 03:28:17 +00:00
tools refactor(compat): retire pre-July skill metadata alias (#163104) 2026-10-01 22:12:52 -07:00
web refactor(ui): drop pre-July-2026 avatar migration (#163209) 2026-10-01 22:41:56 -05:00
agent-runtime-architecture.md perf(agents): keep file edits from blocking other chats (#158443) 2026-09-26 03:55:55 -05:00
AGENTS.md fix: exclude repository instructions from public docs sync (#158253) 2026-09-25 13:15:24 -06:00
auth-credential-semantics.md fix: preserve shared auth and build receipts across runtimes (#163243) 2026-10-01 23:42:15 -05:00
ci.md fix(ci): prepare runtime for changed E2E execution routes (#163289) 2026-10-01 22:51:03 -07:00
date-time.md
docs.json feat: back up to external disks and Cloudflare R2 with storage locations (#161913) 2026-10-01 02:05:44 -07:00
docs_map.md
index.md docs: remove stale showcase section (#158575) 2026-09-25 21:11:35 -06:00
logging.md fix(agents): stop repeating oversized tool calls (#161082) 2026-09-29 20:41:57 -07:00
network.md
openclaw-agent-runtime.md
prose.md
vps.md
whatsapp-openclaw.jpg