An automated setup utility to integrate Honcho cloud memory with local file fallbacks for OpenClaw agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install honcho-memory-mux
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install honcho-memory-mux using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Honcho Memory Mux Setup?
This skill facilitates the deployment of a sophisticated memory architecture for AI agents by installing and configuring the Honcho and memory-mux extensions. It bridges the gap between high-performance cloud retrieval and reliable local file storage, ensuring that Openclaw Skills maintain context across long-running sessions. By implementing multiplexed retrieval, agents can prioritize fast, searchable cloud data while retaining the ability to fall back to local markdown files if network connectivity is interrupted.
Beyond simple installation, the skill handles the heavy lifting of data migration. it intelligently scans your workspace for legacy files such as MEMORY.md and USER.md, classifying them by ownership before uploading them to a centralized Honcho instance. This creates a durable, scalable foundation for agentic memory that evolves alongside your projects.
Honcho Memory Mux Setup Use Cases
- Transitioning from static file-based memory to a dynamic, searchable cloud memory system.
- Migrating legacy user identity and agent soul files to a structured Honcho workspace.
- Implementing redundant memory storage for AI agents to prevent context loss during API outages.
- Automating the update of agent instructions across multiple configuration files in a workspace.
How Honcho Memory Mux Setup Works
- Resolves the workspace root and confirms existing environment configurations for HONCHO_API_KEY and base URLs.
- Uses the plugin manager to install and enable @honcho-ai/openclaw-honcho and @alloralabs/honcho-memory-mux.
- Verifies connectivity to the Honcho service, supporting both managed cloud and self-hosted Docker environments.
- Scans the workspace for legacy memory inputs, classifying them as either owner-generated or agent-generated.
- Executes a secure migration to Honcho, using peer-separated sessions to maintain data integrity.
- Rewrites local agent documentation and bootstrap files to prioritize the new multiplexed memory retrieval logic.
- Performs a live end-to-end validation test to confirm successful data recall and durability.
Honcho Memory Mux Setup Setup
First, ensure you have Node and NPM installed. Then, execute the following commands to install the necessary Openclaw Skills extensions:
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw plugins enable openclaw-honcho
openclaw plugins install @alloralabs/honcho-memory-mux
openclaw plugins enable @alloralabs/honcho-memory-mux
If running a local Honcho instance, set your environment variables accordingly:
export HONCHO_BASE_URL="http://localhost:8000"
export HONCHO_WORKSPACE_ID="openclaw"
Honcho Memory Mux Setup Data Schema & Taxonomy
The skill categorizes and migrates data based on the following taxonomy:
| Data Category | File Patterns | Honcho Destination |
|---|---|---|
| User/Owner | USER.md, IDENTITY.md, MEMORY.md, memory/* | owner peer |
| Agent/Self | SOUL.md, AGENTS.md, TOOLS.md, BOOTSTRAP.md | openclaw peer |
| Observability | memory/manifests/YYYY-MM-DD/*.json | local storage |
All session learnings are flished to local disk in memory/YYYY-MM-DD.md before compaction to ensure local durability.
Honcho Memory Mux Setup Advanced Features
- Multiplexed retrieval logic that intelligently checks Honcho first and local files as a secondary source.
- Peer-separated session management to prevent context pollution between user inputs and agent reflections.
- Pre-compaction flush writes that automatically persist critical session learnings to disk.
- Automated no-fork observability through session manifests, enabling deep debugging of memory retrieval paths.
- Legacy file classification engine that prevents data loss during complex workspace migrations.
SKILL.md
Loading
Related Openclaw Skills
Windows Control
A comprehensive Windows desktop automation skill for controlling mouse, keyboard, and UI elements programmatically.
Zapper
Query and aggregate DeFi portfolio data across 50+ blockchain networks through a single GraphQL interface.
Clanker
Automate the deployment of ERC20 tokens on the Base network with integrated Uniswap V4 liquidity pools.
Base Blockchain Interface
A lightweight interface for querying live onchain data from the Base blockchain without requiring an API key.
AI Displacement Monitor
A sophisticated risk monitor designed to track early-warning signals of AI-led white-collar labor substitution and its downstream financial impacts.
Bazi Analysis
A professional-grade Bazi and Four Pillars consultation skill for deep birth date and time analysis.
Featured*
