chore: remove Matrix references; quickstart shows room-UI flow#345
Merged
Conversation
Standardize on the new usage pattern: Mycelium is driven through the native room UI. Agents are provisioned via the agent primitive (mycelium agent add/create), auto-wired through the mycelium-room channel, and coordinate in the room's live message stream — no separate chat platform to set up. Remove the now-superseded Matrix-the-protocol material; OpenClaw stays a first-class adapter. Remove all Matrix-the-protocol references (keep the CI build-matrix and CHANGELOG history): - delete before-and-after-matrix skill and docs/openclaw-matrix-setup.md - reframe home-channel docs/plugin/skill to the Mycelium room UI (Discord/Slack as external examples) - drop MATRIX_USER_ID fallback in plugin resolveHandle - de-Matrix telemetry parser examples + test fixtures - reset-local-dev-environment.md retitled, Synapse section + dead link removed Rewrite the quickstart (quickstart.md + index.html) to lead with the new flow: mycelium ui open -> create room -> add agents -> coordinate in the room stream / PLAN tab -> share memory.
juliarvalenti
force-pushed
the
chore/remove-matrix-references
branch
from
687b1da to
175fcab
Compare
Follow-up to the Matrix removal: the prior pass swapped "matrix" for "discord"/"slack" as the example channel. The expected behavior is the mycelium-room channel, so lead with it and use generic "external channel" wording where the concept is still needed — don't name a third-party brand as the default. - telemetry parser/docs (traces.py, metrics.md): mycelium-room + "external channels" - plugin skill/hooks/comments (SKILL.md, handler.js, HOOK.md, notify-home.ts, route.ts): home channel = the Mycelium room - hub-and-spoke guide: drop the Discord/Slack brand list - adapters.html: home-channel examples genericized - test fixtures: channel="discord" -> "external" Pre-existing "without Discord/Slack" contrast framing (README, index.html Problem section) left intact — it reinforces that mycelium-room replaces third-party chat.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Standardizing on the new usage pattern: Mycelium is driven through the native room UI. Agents are provisioned via the agent primitive (
mycelium agent add/create), auto-wired through themycelium-roomchannel, and coordinate in the room's live message stream — no separate chat platform to set up.This removes the now-superseded Matrix-the-protocol material and reframes docs/UX around the room-UI flow. OpenClaw stays a first-class adapter.
What changed
Removed
before-and-after-matrixskill (the non-Matrixbefore-and-afterskill using the mycelium-room channel remains)docs/openclaw-matrix-setup.mdReframed (Matrix → the Mycelium room UI as home channel; Discord/Slack as external examples)
hub-and-spoke.md,metrics.md,troubleshooting.md,reset-local-dev-environment.md(retitled, Synapse section + dead link removed)MATRIX_USER_IDfallback inresolveHandle; reframed comments innotify-home.ts,return-address.ts,route.ts, pluginSKILL.md,handler.js,HOOK.md(return-trip mechanism kept working)traces.py/collector.pyexamples →mycelium-room/discord; test fixturesmatrix→discord; backend room namee2e-matrix-xyz→e2e-room-xyzadapters.html;index.html/reference.htmlregenerated from sourcesKept intentionally: CI build-matrix in
release.yml, the historicalCHANGELOG.mdentry.Quickstart rewrite
quickstart.md+ the hand-styledindex.htmlsection now lead with the new flow:mycelium ui open→ create a room → add agents (agent create/add, auto-wires mycelium-room) → coordinate (chat box +@-mention in the stream, oragent invoke; consensus → PLAN tab) → share memory. The old two-terminalsession join/awaitflow is demoted to a footnote pointer.Verification
ruff check/ruff format --check/ty checkclean on changed Pythontest_agent_onboardexecs a realopenclawbinary not installed in this env; file untouched here)test_metrics.py11 passed; collector/metrics tests 47 passedNote for reviewer
reset-local-dev-environment.mdnow links to the hub-and-spoke guide via a cross-package relative path (../mycelium-cli/.../guides/hub-and-spoke.md) — correct but crosses package boundaries; happy to repoint if you prefer.