MemOS Cloud OpenClaw Plugin

Official MemOS Cloud integration for Hermes Agent.

🚀 Quick Install

# From NPM (when published)
hermes plugins install @wbwj/memos-cloud-hermes-plugin@latest

# Or from local file
hermes plugins install ./memos-cloud-hermes-plugin-1.0.0.tgz

⚙️ Configuration

Add to ~/.hermes/.env:

MEMOS_API_KEY=your_api_key
MEMOS_BASE_URL=https://memos.memtensor.cn/api/openmem/v1  # optional
MEMOS_USER_ID=openclaw-user  # optional

Get API key from: https://memos-dashboard.openmem.net/cn/apikeys/

🔧 Tools Provided

• memos_search_memory - Search memories
• memos_add_message - Store messages
• memos_delete_memory - Delete memories
• memos_list_memories - List memories

🧠 Auto Memory Workflow

Pair with memos-cloud-native skill for automatic:

• Pre-conversation recall (inject relevant memories)
• Post-conversation archiving (store preferences & facts)

hermes skills install memos-cloud-native

🛠 Development

# Install dependencies
pip install requests

# Test plugin
npm test

📦 Package Structure

This NPM package contains:

• plugin.yaml - Hermes plugin manifest
• __init__.py - Python tool implementations
• Configurable via ~/.hermes/.env

🐛 Troubleshooting

Plugin not loading?

hermes plugins list
# Should show: memos-cloud v1.0.0

Tools not available?

hermes gateway restart

API errors?

• Verify MEMOS_API_KEY is set
• Test connectivity: python3 -c "import requests; requests.post('...')"

📄 License

MIT - see LICENSE file