OpenClaw Memory System Skill

完整的記憶系統技能包，支援多模態記憶、細粒度隔離、自然語言修正。

技能資訊

• 名稱: openclaw-memory-system
• 版本: 1.0.0
• 描述: 多模態記憶系統，支援圖片/工具記憶、專案/Agent/使用者隔離、自然語言修正
• 作者: 劉哈娜
• 許可證: MIT

核心功能

P1 - 多模態記憶系統

• 圖片記憶管理（後設資料/描述/檢索）
• 工具呼叫記憶（歷史記錄/統計分析）
• 多模態檢索（統一 API/跨模態關聯）

P2 - 細粒度專案隔離

• 專案記憶名稱空間
• Agent 記憶隔離與繼承
• 使用者記憶與許可權控制

P3 - 自然語言記憶修正

• 反饋意圖解析（修正/補充/刪除/確認）
• 版本控制（歷史/對比/回滾）
• 飛書互動卡片

安裝步驟

方法 1: ClawHub 安裝（推薦）

clawhub install openclaw-memory-system

方法 2: 手動安裝

# 1. 複製技能檔案
cp -r /path/to/openclaw-memory-system/skills/* \
  ~/.openclaw/workspace/skills/

# 2. 複製配置檔案
cp -r /path/to/openclaw-memory-system/configs/* \
  ~/.openclaw/workspace/configs/

# 3. 複製測試檔案（可選）
cp -r /path/to/openclaw-memory-system/tests/* \
  ~/.openclaw/workspace/tests/

# 4. 驗證安裝
node ~/.openclaw/workspace/skills/multimodal-memory/test-multimodal.js

方法 3: Git 安裝

cd ~/.openclaw/workspace/skills
git clone https://github.com/your-repo/openclaw-memory-system.git
mv openclaw-memory-system/skills/* .
mv openclaw-memory-system/configs/* ../configs/

配置說明

1. 多模態配置

檔案：configs/multimodal-config.json

{
  "storage": {
    "baseDir": "memory/multimodal",
    "imagesDir": "images",
    "toolCallsDir": "tool-calls",
    "captionsDir": "captions"
  },
  "limits": {
    "maxStringLength": 5000,
    "maxIndexSize": 1000,
    "cleanupDays": 30
  },
  "validation": {
    "forbiddenDirs": ["/etc", "/root", "/var"],
    "sensitiveKeywords": ["password", "secret", ".ssh"]
  },
  "performance": {
    "cacheSize": 100,
    "cacheTTL": 300000
  }
}

2. 名稱空間配置

檔案：configs/memory-namespaces.json

{
  "version": "1.0",
  "namespaces": {
    "projects": {
      "default": {
        "path": "memory",
        "description": "預設專案",
        "users": ["liumeng"]
      }
    },
    "agents": {
      "liu-hana": {
        "path": "MEMORY.md",
        "inherit": [],
        "shareWith": []
      }
    },
    "users": {
      "liumeng": {
        "path": "users/user_liumeng",
        "permissions": ["read", "write", "delete", "admin"]
      }
    }
  }
}

快速開始

1. 儲存圖片記憶

const { ImageMemory } = require('./skills/multimodal-memory/image-memory');
const imgMem = new ImageMemory();

await imgMem.save({
  path: '/path/to/image.png',
  caption: '測試圖片',
  tags: ['測試'],
  context: { sessionId: 'test' }
});

2. 記錄工具呼叫

const { ToolMemory } = require('./skills/multimodal-memory/tool-memory');
const toolMem = new ToolMemory();

await toolMem.record({
  toolName: 'web_search',
  parameters: { query: '測試' },
  result: { success: true },
  duration: 1000
});

3. 建立專案

const { ProjectMemory } = require('./skills/project-memory-isolation/project-memory');
const projMem = new ProjectMemory();

await projMem.createProject('my-project', {
  description: '我的專案',
  users: ['liumeng']
});

4. 自然語言修正

const { MemoryCorrect } = require('./skills/memory-feedback/memory-correct');
const corrector = new MemoryCorrect();

await corrector.autoCorrect('不對，我其實不喜歡健身，喜歡游泳');

測試

# 安裝依賴
cd ~/.openclaw/workspace
npm install --save-dev jest

# 執行所有測試
npm test

# 執行單個測試
node skills/multimodal-memory/test-multimodal.js
node skills/memory-feedback/feedback-parser.js "不對，我不喜歡健身"

效能指標

安全特性

• ✅ 路徑驗證（禁止訪問系統目錄）
• ✅ 許可權控制（三級許可權）
• ✅ 原子寫入（防止資料損壞）
• ✅ 版本控制（可回滾）
• ✅ 敏感資訊過濾

常見問題

Q: 圖片儲存失敗？

A: 檢查 configs/multimodal-config.json 中的路徑配置，確保目錄存在。

Q: 許可權驗證失敗？

A: 檢查 configs/memory-namespaces.json 中的使用者配置，確保使用者有相應許可權。

Q: 如何啟用飛書通知？

A: 在 memory-correct.js 中配置飛書 webhook URL。

依賴要求

• Node.js >= 14.0.0
• OpenClaw >= 2026.2.26
• Jest（測試用，可選）

更新日誌

v1.0.0 (2026-03-17)

• ✅ P1 多模態記憶系統
• ✅ P2 細粒度專案隔離
• ✅ P3 自然語言記憶修正
• ✅ 13 個問題修復
• ✅ 完整測試覆蓋

貢獻指南

歡迎提交 Issue 和 Pull Request！

許可證

MIT License

聯絡方式

• 作者：劉哈娜
• 郵箱：liuhana@example.com

  小蔥技能7w4.net有完整的技能分類。

這個 Skill 文件齊全、配置規範，看起來功能規劃很完善。但實際使用時會發現缺少關鍵程式碼檔案，只有說明文件和配置檔案，沒有真正的功能實現。對於想直接使用的使用者來說，目前版本還無法正常工作，建議等待開發者補充完整程式碼後再使用。