{
  "schemaVersion": "1.0",
  "item": {
    "slug": "honcho-memory-mux",
    "name": "Honcho Memory Multiplexer",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/spooktheducks/honcho-memory-mux",
    "canonicalUrl": "https://clawhub.ai/spooktheducks/honcho-memory-mux",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/honcho-memory-mux",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=honcho-memory-mux",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "extension/README.md",
      "extension/dist/index.d.ts",
      "extension/dist/index.js",
      "extension/index.ts",
      "extension/openclaw.plugin.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/honcho-memory-mux"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/honcho-memory-mux",
    "agentPageUrl": "https://openagent3.xyz/skills/honcho-memory-mux/agent",
    "manifestUrl": "https://openagent3.xyz/skills/honcho-memory-mux/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/honcho-memory-mux/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Honcho + Memory Mux Setup",
        "body": "This skill installs and enables:\n\n@honcho-ai/openclaw-honcho (Honcho tools + integration)\n@alloralabs/honcho-memory-mux (multiplexed memory behavior)\n\nThen it migrates legacy memory files, updates agent docs, and validates runtime behavior."
      },
      {
        "title": "What “memory mux” means in practice",
        "body": "After setup, memory behavior should be:\n\nPrimary retrieval: Honcho tools (honcho_context, honcho_search, etc.)\nSecondary retrieval: local memory files (MEMORY.md, memory/*.md) via memory_search / memory_get\nDurability: pre-compaction flush writes significant session learnings to memory/YYYY-MM-DD.md\nFallback safety: if Honcho is unavailable, file-based memory still works\n\nThis is intentionally complementary, not a hard cutover."
      },
      {
        "title": "Step 0: Preflight and safety checks",
        "body": "Before doing anything destructive:\n\nResolve workspace root from:\n\nWORKSPACE_ROOT\n~/.openclaw/openclaw.json (agent.workspace or agents.defaults.workspace)\n~/.openclaw/workspace\n\n\nConfirm directory exists\nInform user this process can upload memory files to Honcho"
      },
      {
        "title": "Step 1: Install + enable Honcho plugin",
        "body": "Use OpenClaw plugin manager (not workspace npm install):\n\nopenclaw plugins install @honcho-ai/openclaw-honcho\nopenclaw plugins enable openclaw-honcho\n\nIf gateway logs show missing SDK deps:\n\ncd ~/.openclaw/extensions/openclaw-honcho\nnpm install\n\nRestart gateway if required."
      },
      {
        "title": "Step 2: Install + enable memory mux extension",
        "body": "Install and enable the memory-mux extension:\n\nopenclaw plugins install @alloralabs/honcho-memory-mux\nopenclaw plugins enable @alloralabs/honcho-memory-mux\n\nIf the extension is local/unpublished, install from path or git URL per your release flow.\n\nAfter enabling:\n\nVerify plugin appears in openclaw plugins list\nVerify gateway boots cleanly (no extension load errors)\nVerify both Honcho tools and memory_search / memory_get are present at runtime"
      },
      {
        "title": "Step 3: Verify Honcho connectivity (self-hosted)",
        "body": "Set HONCHO_BASE_URL (example: http://localhost:8000)\nHONCHO_API_KEY may be optional depending on auth config\n\nIf user needs local Honcho quickly:\n\ngit clone https://github.com/plastic-labs/honcho\ncd honcho\ncp .env.template .env\ncp docker-compose.yml.example docker-compose.yml\ndocker compose up -d\n\nDo not migrate until connection is verified."
      },
      {
        "title": "Step 4: Detect and classify legacy memory files",
        "body": "Scan workspace for:"
      },
      {
        "title": "User/owner memory inputs",
        "body": "USER.md\nIDENTITY.md\nMEMORY.md\nmemory/** (recursive)\ncanvas/** (recursive)"
      },
      {
        "title": "Agent/self memory inputs",
        "body": "SOUL.md\nAGENTS.md (and AGENT.md if present in this workspace)\nTOOLS.md\nBOOTSTRAP.md\nHEARTBEAT.md\n\nPresent a clear preview before upload:\n\ncount files per class\ntotal bytes per class\nany unreadable/skipped files\n\nAsk for explicit confirmation."
      },
      {
        "title": "Step 5: Upload to Honcho using peer-separated sessions",
        "body": "Create/ensure:\n\nworkspace (HONCHO_WORKSPACE_ID or openclaw)\npeer owner\npeer openclaw\nmigration session (e.g. migration-upload-<timestamp>)\n\nAdd both peers to session, then upload files:\n\nuser/owner files → owner\nagent/self files → openclaw\n\nIf any upload fails:\n\nstop\nreport exact file and error\nkeep local files unchanged\n\nReport summary:\n\nuploaded user file count\nuploaded agent file count\nfailed/skipped files"
      },
      {
        "title": "Step 6: Update workspace docs (including AGENT.md compatibility)",
        "body": "Update/create memory instructions in:\n\nAGENTS.md\nSOUL.md\nBOOTSTRAP.md\nAGENT.md (if this workspace uses it)\n\nPreserve custom content; only replace memory-specific sections."
      },
      {
        "title": "Required policy text to add",
        "body": "Memory retrieval order\n\nFirst try honcho_context / honcho_search / honcho_recall\nIf needed, use memory_search + memory_get for local file recall\nUse honcho_session for same-session recall\n\n\n\nMemory write behavior\n\nImportant durable facts can be written via honcho_write\nPre-compaction flush writes concise durable notes to memory/YYYY-MM-DD.md\n\n\n\nFailure handling\n\nIf Honcho unavailable: continue with local memory tools, state degraded mode\nNever claim memory certainty without retrieval evidence\n\n\n\nTransparency\n\nWhen memory influences an answer, be able to explain source class\n(Honcho recall vs local file recall vs current-session context)"
      },
      {
        "title": "Step 7: Add/refresh practical memory operating conventions",
        "body": "Ensure docs reflect these conventions the agent has been using:\n\nDo not preload everything into active reasoning if not needed\nPrefer targeted retrieval over huge static context injection\nTreat disagreement as signal: preserve conflicting observations; do not silently average\nUse pre-compaction flushes to avoid losing high-value context during long sessions\nSeparate memory types conceptually:\n\ndurable facts\nepisodic notes\nscratch/working notes\n\nEven if physical storage is mixed, behavior should preserve this distinction."
      },
      {
        "title": "Step 8: Optional (recommended) no-fork observability add-on",
        "body": "Without modifying OpenClaw gateway source, the memory-mux extension can emit:\n\na small memory load manifest per session start (what memory sources were pulled)\na pre-compaction write report (what was persisted)\n\nStore under:\n\nmemory/manifests/YYYY-MM-DD/<session>.json\n\nThis makes memory behavior debuggable while keeping upstream updates painless."
      },
      {
        "title": "Step 9: Validate end-to-end behavior",
        "body": "Run a quick live test:\n\nAsk agent about a known historical fact only in migrated memory\nConfirm retrieval path works (Honcho first, fallback available)\nTrigger/perform pre-compaction flush\nConfirm new note appears in memory/YYYY-MM-DD.md\nRe-ask fact in a new turn/session to validate durability"
      },
      {
        "title": "Wrap-up report to user",
        "body": "Provide:\n\ninstalled/enabled plugin list\nHoncho connectivity mode (managed vs self-hosted)\nfiles discovered, uploaded, skipped\ndocs updated (AGENTS.md, SOUL.md, BOOTSTRAP.md, AGENT.md if present)\nany follow-up actions\n\nReference docs:\n\nhttps://docs.honcho.dev\nhttps://github.com/plastic-labs/honcho"
      },
      {
        "title": "Guardrails",
        "body": "Never delete user memory files automatically unless user explicitly asks\nNever proceed with migration on failed Honcho connectivity\nNever silently ignore upload errors\nPrefer reversible edits and clear summaries"
      }
    ],
    "body": "Honcho + Memory Mux Setup\n\nThis skill installs and enables:\n\n@honcho-ai/openclaw-honcho (Honcho tools + integration)\n@alloralabs/honcho-memory-mux (multiplexed memory behavior)\n\nThen it migrates legacy memory files, updates agent docs, and validates runtime behavior.\n\nWhat “memory mux” means in practice\n\nAfter setup, memory behavior should be:\n\nPrimary retrieval: Honcho tools (honcho_context, honcho_search, etc.)\nSecondary retrieval: local memory files (MEMORY.md, memory/*.md) via memory_search / memory_get\nDurability: pre-compaction flush writes significant session learnings to memory/YYYY-MM-DD.md\nFallback safety: if Honcho is unavailable, file-based memory still works\n\nThis is intentionally complementary, not a hard cutover.\n\nStep 0: Preflight and safety checks\n\nBefore doing anything destructive:\n\nResolve workspace root from:\nWORKSPACE_ROOT\n~/.openclaw/openclaw.json (agent.workspace or agents.defaults.workspace)\n~/.openclaw/workspace\nConfirm directory exists\nInform user this process can upload memory files to Honcho\nStep 1: Install + enable Honcho plugin\n\nUse OpenClaw plugin manager (not workspace npm install):\n\nopenclaw plugins install @honcho-ai/openclaw-honcho\nopenclaw plugins enable openclaw-honcho\n\n\nIf gateway logs show missing SDK deps:\n\ncd ~/.openclaw/extensions/openclaw-honcho\nnpm install\n\n\nRestart gateway if required.\n\nStep 2: Install + enable memory mux extension\n\nInstall and enable the memory-mux extension:\n\nopenclaw plugins install @alloralabs/honcho-memory-mux\nopenclaw plugins enable @alloralabs/honcho-memory-mux\n\n\nIf the extension is local/unpublished, install from path or git URL per your release flow.\n\nAfter enabling:\n\nVerify plugin appears in openclaw plugins list\nVerify gateway boots cleanly (no extension load errors)\nVerify both Honcho tools and memory_search / memory_get are present at runtime\nStep 3: Verify Honcho connectivity (self-hosted)\nSet HONCHO_BASE_URL (example: http://localhost:8000)\nHONCHO_API_KEY may be optional depending on auth config\n\nIf user needs local Honcho quickly:\n\ngit clone https://github.com/plastic-labs/honcho\ncd honcho\ncp .env.template .env\ncp docker-compose.yml.example docker-compose.yml\ndocker compose up -d\n\n\nDo not migrate until connection is verified.\n\nStep 4: Detect and classify legacy memory files\n\nScan workspace for:\n\nUser/owner memory inputs\nUSER.md\nIDENTITY.md\nMEMORY.md\nmemory/** (recursive)\ncanvas/** (recursive)\nAgent/self memory inputs\nSOUL.md\nAGENTS.md (and AGENT.md if present in this workspace)\nTOOLS.md\nBOOTSTRAP.md\nHEARTBEAT.md\n\nPresent a clear preview before upload:\n\ncount files per class\ntotal bytes per class\nany unreadable/skipped files\n\nAsk for explicit confirmation.\n\nStep 5: Upload to Honcho using peer-separated sessions\n\nCreate/ensure:\n\nworkspace (HONCHO_WORKSPACE_ID or openclaw)\npeer owner\npeer openclaw\nmigration session (e.g. migration-upload-<timestamp>)\n\nAdd both peers to session, then upload files:\n\nuser/owner files → owner\nagent/self files → openclaw\n\nIf any upload fails:\n\nstop\nreport exact file and error\nkeep local files unchanged\n\nReport summary:\n\nuploaded user file count\nuploaded agent file count\nfailed/skipped files\nStep 6: Update workspace docs (including AGENT.md compatibility)\n\nUpdate/create memory instructions in:\n\nAGENTS.md\nSOUL.md\nBOOTSTRAP.md\nAGENT.md (if this workspace uses it)\n\nPreserve custom content; only replace memory-specific sections.\n\nRequired policy text to add\n\nMemory retrieval order\n\nFirst try honcho_context / honcho_search / honcho_recall\nIf needed, use memory_search + memory_get for local file recall\nUse honcho_session for same-session recall\n\nMemory write behavior\n\nImportant durable facts can be written via honcho_write\nPre-compaction flush writes concise durable notes to memory/YYYY-MM-DD.md\n\nFailure handling\n\nIf Honcho unavailable: continue with local memory tools, state degraded mode\nNever claim memory certainty without retrieval evidence\n\nTransparency\n\nWhen memory influences an answer, be able to explain source class (Honcho recall vs local file recall vs current-session context)\nStep 7: Add/refresh practical memory operating conventions\n\nEnsure docs reflect these conventions the agent has been using:\n\nDo not preload everything into active reasoning if not needed\nPrefer targeted retrieval over huge static context injection\nTreat disagreement as signal: preserve conflicting observations; do not silently average\nUse pre-compaction flushes to avoid losing high-value context during long sessions\nSeparate memory types conceptually:\ndurable facts\nepisodic notes\nscratch/working notes\n\nEven if physical storage is mixed, behavior should preserve this distinction.\n\nStep 8: Optional (recommended) no-fork observability add-on\n\nWithout modifying OpenClaw gateway source, the memory-mux extension can emit:\n\na small memory load manifest per session start (what memory sources were pulled)\na pre-compaction write report (what was persisted)\n\nStore under:\n\nmemory/manifests/YYYY-MM-DD/<session>.json\n\nThis makes memory behavior debuggable while keeping upstream updates painless.\n\nStep 9: Validate end-to-end behavior\n\nRun a quick live test:\n\nAsk agent about a known historical fact only in migrated memory\nConfirm retrieval path works (Honcho first, fallback available)\nTrigger/perform pre-compaction flush\nConfirm new note appears in memory/YYYY-MM-DD.md\nRe-ask fact in a new turn/session to validate durability\nWrap-up report to user\n\nProvide:\n\ninstalled/enabled plugin list\nHoncho connectivity mode (managed vs self-hosted)\nfiles discovered, uploaded, skipped\ndocs updated (AGENTS.md, SOUL.md, BOOTSTRAP.md, AGENT.md if present)\nany follow-up actions\n\nReference docs:\n\nhttps://docs.honcho.dev\nhttps://github.com/plastic-labs/honcho\nGuardrails\nNever delete user memory files automatically unless user explicitly asks\nNever proceed with migration on failed Honcho connectivity\nNever silently ignore upload errors\nPrefer reversible edits and clear summaries"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/spooktheducks/honcho-memory-mux",
    "publisherUrl": "https://clawhub.ai/spooktheducks/honcho-memory-mux",
    "owner": "spooktheducks",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/honcho-memory-mux",
    "downloadUrl": "https://openagent3.xyz/downloads/honcho-memory-mux",
    "agentUrl": "https://openagent3.xyz/skills/honcho-memory-mux/agent",
    "manifestUrl": "https://openagent3.xyz/skills/honcho-memory-mux/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/honcho-memory-mux/agent.md"
  }
}