Sync from main

.gitignore

@@ -180,6 +180,20 @@ venv.bak/
 # but do not ignore docs/openapi.json
 !docs/openapi.json
 
+# do not ignore apps/ config files
+!apps/**/*.json
+!apps/**/*.html
+!apps/**/*.ts
+!apps/**/*.tsx
+!apps/**/*.js
+!apps/**/*.cjs
+!apps/**/*.css
+!apps/**/*.md
+!apps/**/*.yaml
+!apps/**/*.yml
+!apps/**/*.svg
+!apps/**/*.sh
+
 
 # mypy
 .mypy_cache/

README.md

@@ -42,38 +42,50 @@
     </a>
     <a href="https://github.com/IAAR-Shanghai/Awesome-AI-Memory">
       <img alt="Awesome AI Memory" src="https://img.shields.io/badge/Resources-Awesome--AI--Memory-8A2BE2">
-    </a>  
+    </a>
   </p>
 
 <p align="center">
   <strong>🎯 +43.70% Accuracy vs. OpenAI Memory</strong><br/>
   <strong>🏆 Top-tier long-term memory + personalization</strong><br/>
   <strong>💰 Saves 35.24% memory tokens</strong><br/>
   <sub>LoCoMo 75.80 • LongMemEval +40.43% • PrefEval-10 +2568% • PersonaMem +40.75%</sub>
-  <a href="https://memos.openmem.net/">
+  <!-- <a href="https://memos.openmem.net/">
     <img src="https://statics.memtensor.com.cn/memos/github_api_free_banner.gif" alt="MemOS Free API Banner">
-  </a>
+  </a> -->
 
 </p>
-  
+
 </div>
 
-Get Free API: [Try API](https://memos-dashboard.openmem.net/quickstart/?source=github)
+<!-- Get Free API: [Try API](https://memos-dashboard.openmem.net/quickstart/?source=github) -->
 
----
+<!-- --- -->
 
-<br>
+<!-- <br> -->
 
 ## 🦞 Enhanced OpenClaw with MemOS Plugin
+
 ![](https://cdn.memtensor.com.cn/img/1770612303123_mnaisk_compressed.png)
 
-- [**72% lower token usage**](https://x.com/MemOS_dev/status/2020854044583924111) – intelligent memory retrieval instead of loading full chat history
-- [**Multi-agent memory sharing**](https://x.com/MemOS_dev/status/2020538135487062094) – multi-instance agents share memory via same user_id. Automatic context handoff.  
+🦞 Your lobster now has a working memory system — choose **Cloud** or **Local** to get started.
 
-🦞 Your lobster now has a working memory system.
+### ☁️ Cloud Plugin — Hosted Memory Service
+
+- [**72% lower token usage**](https://x.com/MemOS_dev/status/2020854044583924111) — intelligent memory retrieval instead of loading full chat history
+- [**Multi-agent memory sharing**](https://x.com/MemOS_dev/status/2020538135487062094) — multi-instance agents share memory via same user_id, automatic context handoff
 
 Get your API key: [MemOS Dashboard](https://memos-dashboard.openmem.net/cn/login/)  
-Try it: Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin)
+Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin)
+
+### 🧠 Local Plugin — 100% On-Device Memory
+
+- **Zero cloud dependency** — all data stays on your machine, persistent local SQLite storage
+- **Hybrid search + task & skill evolution** — FTS5 + vector search, auto task summarization, reusable skills that self-upgrade
+- **Multi-agent collaboration + Memory Viewer** — memory isolation, skill sharing, full web dashboard with 7 management pages
+
+ 🌐 [Homepage](https://memos-claw.openmem.net) · 
+📖 [Documentation](https://memos-claw.openmem.net/docs/index.html) · 📦 [NPM](https://www.npmjs.com/package/@memtensor/memos-local-openclaw-plugin)
 
 ## 📌 MemOS: Memory Operating System for AI Agents
 
@@ -92,6 +104,9 @@ Try it: Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTe
 
 ### News
 
+- **2026-03-08** · 🦞 **MemOS OpenClaw Plugin — Cloud & Local**  
+  Official OpenClaw memory plugins launched. **Cloud Plugin**: hosted memory service with 72% lower token usage and multi-agent memory sharing ([MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin)). **Local Plugin** (`v1.0.0`): 100% on-device memory with persistent SQLite, hybrid search (FTS5 + vector), task summarization & skill evolution, multi-agent collaboration, and a full Memory Viewer dashboard.
+
 - **2025-12-24** · 🎉 **MemOS v2.0: Stardust (星尘) Release**  
   Comprehensive KB (doc/URL parsing + cross-project sharing), memory feedback & precise deletion, multi-modal memory (images/charts), tool memory for agent planning, Redis Streams scheduling + DB optimizations, streaming/non-streaming chat, MCP upgrade, and lightweight quick/full deployment.
   <details>
@@ -139,7 +154,7 @@ Try it: Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTe
 
   </details>
 
-- **2025-08-07** · 🎉 **MemOS v1.0.0 (MemCube) Release**  
+- **2025-08-07** · 🎉 **MemOS v1.0.0 (MemCube) Release**
   First MemCube release with a word-game demo, LongMemEval evaluation, BochaAISearchRetriever integration, NebulaGraph support, improved search capabilities, and the official Playground launch.
 
   <details>
@@ -177,11 +192,11 @@ Try it: Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTe
 
   </details>
 
-- **2025-07-07** · 🎉 **MemOS v1.0: Stellar (星河) Preview Release**  
+- **2025-07-07** · 🎉 **MemOS v1.0: Stellar (星河) Preview Release**
   A SOTA Memory OS for LLMs is now open-sourced.
-- **2025-07-04** · 🎉 **MemOS Paper Release**  
+- **2025-07-04** · 🎉 **MemOS Paper Release**
   [MemOS: A Memory OS for AI System](https://arxiv.org/abs/2507.03724) is available on arXiv.
-- **2024-07-04** · 🎉 **Memory3 Model Release at WAIC 2024**  
+- **2024-07-04** · 🎉 **Memory3 Model Release at WAIC 2024**
   The Memory3 model, featuring a memory-layered architecture, was unveiled at the 2024 World Artificial Intelligence Conference.
 
 <br>
@@ -194,9 +209,9 @@ Try it: Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTe
 - Go to **API Keys** and copy your key
 
 #### Next Steps
-- [MemOS Cloud Getting Started](https://memos-docs.openmem.net/memos_cloud/quick_start/)  
+- [MemOS Cloud Getting Started](https://memos-docs.openmem.net/memos_cloud/quick_start/)
   Connect to MemOS Cloud and enable memory in minutes.
-- [MemOS Cloud Platform](https://memos.openmem.net/?from=/quickstart/)  
+- [MemOS Cloud Platform](https://memos.openmem.net/?from=/quickstart/)
   Explore the Cloud dashboard, features, and workflows.
 
 ### 🖥️ 2、Self-Hosted (Local/Private)
@@ -234,7 +249,7 @@ Try it: Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTe
     ```python
     import requests
     import json
-    
+
     data = {
         "user_id": "8736b16e-1d20-4163-980b-a5063c3facdc",
         "mem_cube_id": "b32d0977-435d-4828-a86f-4f47f8b55bca",
@@ -250,15 +265,15 @@ Try it: Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTe
         "Content-Type": "application/json"
     }
     url = "http://localhost:8000/product/add"
-    
+
     res = requests.post(url=url, headers=headers, data=json.dumps(data))
     print(f"result: {res.json()}")
     ```
   - Search User Memory
     ```python
     import requests
     import json
-    
+
     data = {
         "query": "What do I like",
         "user_id": "8736b16e-1d20-4163-980b-a5063c3facdc",
@@ -268,7 +283,7 @@ Try it: Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTe
         "Content-Type": "application/json"
     }
     url = "http://localhost:8000/product/search"
-    
+
     res = requests.post(url=url, headers=headers, data=json.dumps(data))
     print(f"result: {res.json()}")
     ```
@@ -277,8 +292,8 @@ Try it: Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTe
 
 ## 📚 Resources
 
-- **Awesome-AI-Memory**   
- This is a curated repository dedicated to resources on memory and memory systems for large language models. It systematically collects relevant research papers, frameworks, tools, and practical insights. The repository aims to organize and present the rapidly evolving research landscape of LLM memory, bridging multiple research directions including natural language processing, information retrieval, agentic systems, and cognitive science.  
+- **Awesome-AI-Memory**
+ This is a curated repository dedicated to resources on memory and memory systems for large language models. It systematically collects relevant research papers, frameworks, tools, and practical insights. The repository aims to organize and present the rapidly evolving research landscape of LLM memory, bridging multiple research directions including natural language processing, information retrieval, agentic systems, and cognitive science.
 - **Get started** 👉 [IAAR-Shanghai/Awesome-AI-Memory](https://github.com/IAAR-Shanghai/Awesome-AI-Memory)
 - **MemOS Cloud OpenClaw Plugin**
   Official OpenClaw lifecycle plugin for MemOS Cloud. It automatically recalls context from MemOS before the agent starts and saves the conversation back to MemOS after the agent finishes.

apps/memos-local-openclaw/.env.example

@@ -0,0 +1,25 @@
+# ─── Embedding API ───
+# Use any OpenAI-compatible embedding service, or leave blank for local offline model (Xenova/all-MiniLM-L6-v2)
+EMBEDDING_PROVIDER=openai_compatible
+EMBEDDING_API_KEY=your-embedding-api-key
+EMBEDDING_ENDPOINT=https://your-embedding-api.com/v1
+EMBEDDING_MODEL=bge-m3
+
+# ─── Summarizer API ───
+# OpenAI-compatible LLM for one-sentence chunk summaries
+# Leave blank to use rule-based fallback (no LLM needed)
+SUMMARIZER_PROVIDER=openai_compatible
+SUMMARIZER_API_KEY=your-summarizer-api-key
+SUMMARIZER_ENDPOINT=https://api.openai.com/v1
+SUMMARIZER_MODEL=gpt-4o-mini
+SUMMARIZER_TEMPERATURE=0
+
+# ─── Memory Viewer ───
+# Port for the web-based Memory Viewer (default: 18799)
+# VIEWER_PORT=18799
+
+# ─── Telemetry (opt-out) ───
+# Anonymous usage analytics to help improve the plugin.
+# No memory content, queries, or personal data is ever sent — only tool names, latencies, and version info.
+# Enabled by default. Set to false to opt-out.
+# TELEMETRY_ENABLED=false

apps/memos-local-openclaw/.gitignore

@@ -0,0 +1,23 @@
+node_modules/
+dist/
+*.tsbuildinfo
+.env
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+
+# Generated / non-essential
+package-lock.json
+www/
+docs/
+ppt/
+
+# Database files
+*.sqlite
+*.sqlite-journal
+*.db