Summary

This OpenClaw plugin integrates with MemOS Cloud to provide AI agents with persistent long-term memory. It enhances agent continuity by recalling relevant context before execution and saving conversation history afterward, benefiting developers building stateful AI applications.

How It Works

The plugin acts as a minimal OpenClaw lifecycle hook. During before_agent_start, it queries MemOS Cloud's /search/memory API to retrieve relevant past interactions based on the current prompt. These memories are injected into the agent's context. Upon agent_end, new messages are sent to MemOS Cloud's /add/message API for storage. A key feature is optional, model-based filtering of recalled memories before injection, ensuring only pertinent context is used.

Quick Start & Requirements

Installation is recommended via NPM: openclaw plugins install @memtensor/memos-cloud-openclaw-plugin@latest followed by openclaw gateway restart. A manual installation workaround is provided for Windows users encountering Error: spawn EINVAL. Configuration requires setting the MEMOS_API_KEY environment variable, obtainable from https://memos-dashboard.openmem.net. Optional configurations include MEMOS_BASE_URL and parameters for recall filtering.

Highlighted Details

• Multi-Agent Support: Native integration allows for isolated memory and message histories per agent via multiAgentMode and agentId configuration.
• Recall Filtering: Enables advanced context retrieval by using an external LLM (e.g., OpenAI-compatible) to filter recalled memories based on relevance.
• Extensive Configuration: Offers granular control over conversation management, memory types (tool, preference), recall scope (recallGlobal), and data capture strategies.
• Token Authentication: Secures API communication using a provided token.

Maintenance & Community

This is an official plugin maintained by MemTensor. A contributor, @anatolykoptev, is acknowledged. No specific community channels or roadmap links are provided in the README.

Licensing & Compatibility

The README does not specify a software license. Compatibility is primarily with the OpenClaw framework. Commercial use implications are undetermined without a license.

Limitations & Caveats

A known issue exists with the NPM plugin installer on Windows (Error: spawn EINVAL), necessitating manual installation. The plugin's core functionality is contingent on a valid MEMOS_API_KEY. The README notes a future consideration to bind directly to OpenClaw's sessionId.