triple-memory-baidu-embedding

---

name: triple-memory-baidu-embedding version: 1.0.0 description: Complete memory system combining Baidu Embedding auto-recall, Git-Notes structured memory, and file-based workspace search. Use when setting up comprehensive agent memory with local privacy, when you need persistent context across sessions, or when managing decisions/preferences/tasks with multiple memory backends working together. metadata: clawdbot: emoji: "🧠" requires: skills: - git-notes-memory - memory-baidu-embedding-db

---

Triple Memory System with Baidu Embedding

A comprehensive memory architecture combining three complementary systems for maximum context retention across sessions, with full privacy protection using Baidu Embedding technology.

📋 Original Source & Modifications

Original Source: Triple Memory (by Clawdbot Team) Modified By: [Your Clawdbot Instance] Modifications: Replaced LanceDB with Baidu Embedding DB for enhanced privacy and Chinese language support

Original Triple Memory SKILL.md was adapted to create this version that:

Replaces OpenAI-dependent LanceDB with Baidu Embedding DB

Maintains the same three-tier architecture

Preserves Git-Notes integration

Adds privacy-focused local storage

🏗️ Architecture Overview

User Message
     ↓
[Baidu Embedding auto-recall] → injects relevant conversation memories
     ↓
Agent responds (using all 3 systems)
     ↓
[Baidu Embedding auto-capture] → stores preferences/decisions automatically
     ↓
[Git-Notes] → structured decisions with entity extraction
     ↓
[File updates] → persistent workspace docs

The Three Systems

1. Baidu Embedding (Conversation Memory)

Auto-recall: Relevant memories injected before each response using Baidu Embedding-V1 (requires API credentials)

Auto-capture: Preferences/decisions/facts stored automatically with local vector storage (requires API credentials)

Privacy Focused: All embeddings processed via Baidu API with local storage

Chinese Optimized: Better understanding of Chinese language semantics

Tools: baidu_memory_recall, baidu_memory_store, baidu_memory_forget (require API credentials)

Triggers: "remember", "prefer", "my X is", "I like/hate/want"

Note: When API credentials are not provided, this layer is unavailable and the system operates in degraded mode.

2. Git-Notes Memory (Structured, Local)

Branch-aware: Memories isolated per git branch

Entity extraction: Auto-extracts topics, names, concepts

Importance levels: critical, high, normal, low

No external API calls

3. File Search (Workspace)

Searches: MEMORY.md, memory/*.md, any workspace file

Script: scripts/file-search.sh

🛠️ Setup

Install Dependencies

clawdhub install git-notes-memory
clawdhub install memory-baidu-embedding-db

Configure Baidu API

Set environment variables:

export BAIDU_API_STRING='your_bce_v3_api_string'
export BAIDU_SECRET_KEY='your_secret_key'

Create File Search Script

Copy scripts/file-search.sh to your workspace.

📖 Usage

Session Start (Always)

python3 skills/git-notes-memory/memory.py -p $WORKSPACE sync --start

Store Important Decisions

python3 skills/git-notes-memory/memory.py -p $WORKSPACE remember \
  '{"decision": "Use PostgreSQL", "reason": "Team expertise"}' \
  -t architecture,database -i h

Search Workspace Files

./scripts/file-search.sh "database config" 5

Baidu Embedding Memory (Automatic)

Baidu Embedding handles this automatically when API credentials are available. Manual tools:

baidu_memory_recall "query" - search conversation memory using Baidu vectors (requires API credentials)

baidu_memory_store "text" - manually store something with Baidu embedding (requires API credentials)

baidu_memory_forget - delete memories (GDPR, requires API credentials)

In Degraded Mode (without API credentials):

System operates using only Git-Notes and File System layers

Manual tools are unavailable

Auto-recall and auto-capture are disabled

🎯 Importance Levels

| Flag | Level | When to Use | |------|-------|-------------| | -i c | Critical | "always remember", explicit preferences | | -i h | High | Decisions, corrections, preferences | | -i n | Normal | General information | | -i l | Low | Temporary notes |

📋 When to Use Each System

| System | Use For | |--------|---------| | Baidu Embedding | Conversation context, auto-retrieval with privacy | | Git-Notes | Structured decisions, searchable by entity/tag | | File Search | Workspace docs, daily logs, MEMORY.md |

📁 File Structure

workspace/
├── MEMORY.md              # Long-term curated memory
├── memory/
│   ├── active-context.md  # Current session state
│   └── YYYY-MM-DD.md      # Daily logs
├── scripts/
│   └── file-search.sh     # Workspace search
└── skills/
    ├── triple-memory-baidu-embedding/  # Enhanced memory system
    ├── git-notes-memory/  # Structured memory
    └── memory-baidu-embedding-db/  # Vector storage

🔧 Hook Integration

This skill can be integrated with Clawdbot's startup hooks for automatic initialization:

Memory Boot Hook Integration

To ensure the Triple Memory Baidu system starts automatically when the gateway starts:

1. The memory-boot-loader hook can be configured to run /root/clawd/session-init-triple-baidu.sh 2. This ensures all three memory layers are initialized on startup 3. Provides immediate access to Git-Notes, Baidu Embedding, and file-based memory

Configuration

The system can be integrated with the gateway startup sequence to ensure:

Git-Notes synchronization on startup

Baidu Embedding connection check

File-based memory initialization

Ready-to-use memory system from the start

🤫 Silent Operation

Never announce memory operations to users. Just do it:

❌ "I'll remember this"

❌ "Saving to memory"

✅ (silently store and continue)

🔄 Migration from Original Triple Memory

1. Install this skill in your skills/ directory 2. Configure your Baidu API credentials 3. Disable original triple-memory if desired 4. Update your bot configuration to use this memory system 5. Verify data integrity and performance

📈 Performance Benefits

Enhanced Privacy: All vector storage local with Baidu API

Better Chinese Support: Baidu Embedding optimized for Chinese

Reduced Costs: Potentially lower API costs compared to OpenAI

Same Architecture: Maintains proven three-tier design

🤝 Contributing

Based on original Triple Memory system by Clawdbot Team. Contributions welcome to enhance the Baidu Embedding integration.

📄 License

Original license applies with modifications noted above. Credit given to original authors.

The system can be integrated with the gateway startup sequence to ensure:

Git-Notes synchronization on startup

Baidu Embedding connection check

File-based memory initialization

Ready-to-use memory system from the start