openclaw-musubi

Musubi memory plane for OpenClaw agents. Episodic capture, curated knowledge recall, and presence-to-presence thought delivery — all routed through a Musubi core so your agents share one memory across every modality they live in.

Status: early scaffold. The repository structure, documentation, and plugin contract are being established first. Implementation slices follow. See docs/ for the in-progress architecture.

What it does

OpenClaw agents run in many places — CLI sessions, Discord, LiveKit voice, browser extensions. Each modality has its own short-term memory, but nothing knows what the others saw. Musubi is designed to be the shared memory plane that spans them. openclaw-musubi is the plugin that plugs OpenClaw into it.

The plugin sits sidecar to OpenClaw's native memory engine — it does not replace it. Instead it:

• Mirrors OpenClaw memory writes into Musubi's episodic plane so every capture lands in the cross-modality pool automatically.
• Supplements the memory prompt with Musubi's curated knowledge and synthesized concepts, labeled with provenance so the model weighs authoritative sources higher than raw episodic chatter.
• Exposes the canonical agent-tools surface — musubi_recent, musubi_search, musubi_get, musubi_remember, musubi_think — the same five tools every Musubi adapter exposes (MCP, LiveKit, OpenClaw) per ADR 0032. Plus musubi_recall as a one-release deprecation alias for musubi_search.
• Streams thoughts inbound over Server-Sent Events so a thought sent by your Claude Code session surfaces in your Discord-facing agent within seconds, not polling-intervals.

This "sidecar-with-authority" model is a deliberate architectural choice documented in docs/decisions/0001-sidecar-with-authority.md.

Requirements

• OpenClaw >= 2026.4.10
• Node.js >= 22
• pnpm (recommended) or npm
• A reachable Musubi core (v2) with at minimum the HTTP API shipped. The /thoughts/stream SSE endpoint is required for real-time thought delivery; without it, thought support degrades gracefully to polling.

Install

Not yet published — the package will be available on ClawHub and npm once the first implementation slice lands.

# Future install command
openclaw plugins install openclaw-musubi

Configure

A minimal configuration in your openclaw.json:

{
  "plugins": {
    "entries": {
      "musubi": {
        "config": {
          "core": {
            "baseUrl": "https://musubi.your-domain.internal",
            "token": "${MUSUBI_TOKEN}"
          },
          "presence": {
            "defaultId": "you/openclaw"
          }
        }
      }
    }
  }
}

See openclaw.plugin.json for the full config schema, and docs/api-contract.md for the consumer-side behavior expected of any client (this plugin, but also third-party reimplementations).

Documentation

• Architecture overview
• Presence model
• Transport: HTTP + SSE
• API consumer contract
• Architecture decisions

Contributing

This is an OSS project built in the open. Read CONTRIBUTING.md for slice-based workflow, commit conventions, and what makes a PR mergeable. Report security issues via the process in SECURITY.md.

License

MIT — see LICENSE.

Related projects

• Musubi — the memory core this plugin talks to.
• OpenClaw — the agent platform this plugin extends.