適用於 Openclaw 的 Smart Memory v2

一個為 OpenClaw 設計的持久化認知記憶執行環境，透過 FastAPI 引擎和 Node 適配器提供長期情境和語義儲存。

chenghaifeng08-creator

v2.5.1

Mar 24, 2026

安裝

基本資訊

Skill.md

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。


                  npx clawhub@latest install smart-memory-automaton

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式

~/.openclaw/skills/

工作區

<project>/skills/

優先級：工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。


                  請幫我使用 Clawhub 安裝 smart-memory-automaton。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。

想要直接下載？

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 Smart Memory v2？

Smart Memory v2 是一個先進的長期記憶解決方案，旨在改變 AI Agent 與歷史數據的互動方式。與傳統的向量存儲不同，該執行環境作為 Openclaw Skills 的完整認知記憶系統，使 Agent 能夠維護結構化的情境、語義、信念和目標導向數據。它透過提供處理實體感知檢索、重排序和背景整合的本地 API，彌合了暫時聊天會話與持久智能之間的鴻溝。

透過整合此技能，開發者可以賦予其 Agent 一個在重啟和會話重置後仍能存續的「工作記憶」。它利用 FastAPI 後端進行繁重任務處理（如 embedding 生成和反思），同時提供輕量級 Node 適配器，以便無縫整合到現有的 Openclaw Skills 工作流中。該系統專門針對本地執行進行了優化，確保了數據隱私和對認知洞察的低延遲訪問。

Smart Memory v2 應用場景

在多個聊天會話中持久化儲存使用者偏好、專案決策和長期目標。
自動化會話總結，以捕獲「會話弧線」並在開發任務中保持連續性。
背景反思和衝突解決，保持 Agent 的知識庫一致並及時更新。
為需要在對話中自然呈現待處理見解的複雜 Agent 進行上下文注入。

Smart Memory v2 運作原理

Openclaw Agent 透過提供的工具介面（如 memory_search 或 memory_commit）發起查詢或提交。
對本地 FastAPI 伺服器執行強制健康檢查，以確保認知引擎響應正常。
對於記憶提交，系統會對數據進行序列化以保護 CPU embedding 吞吐量，如果伺服器暫時無法訪問，則將請求排隊。
背景編排器定期執行整合任務（如反思和記憶衰減），以精煉儲存的資訊。
在生成響應期間，活動上下文（包括專案和最關心的問題）會被被動注入到模型的 prompt 中。
在會話結束時，系統提取對話輪次並生成摘要弧線，作為長期情境記憶儲存。

Smart Memory v2 設定指南

Smart Memory v2 需要純 CPU 環境，以確保在 Docker、WSL 和標準筆記型電腦上的相容性。請按照以下步驟初始化 Openclaw Skills 元件：

# Navigate to the skill directory
cd smart-memory

# Set up the Python environment
python3 -m venv .venv
source .venv/bin/activate

# Install CPU-only PyTorch first (Required)
pip install torch --index-url https://download.pytorch.org/whl/cpu

# Install cognitive engine and Node dependencies
pip install -r requirements-cognitive.txt
npm install

Smart Memory v2 資料結構與分類體系

該技能將記憶組織成多層分類體系，以確保在 Openclaw Skills 中進行高相關性檢索：

記憶類型	描述	關鍵元數據
情境 (Episodic)	特定事件和會話弧線	session_id, timestamp, tags
語義 (Semantic)	通用事實和知識	entity_type, importance
信念 (Belief)	Agent 或使用者定義的真相	confidence_score, source
目標 (Goal)	活動目標和任務	status, priority, deadline