Tablestore：基於記憶儲存服務實現OpenClaw和Hermes Agent記憶互連

檢查關鍵配置一致性

OpenClaw側配置

執行以下命令安裝@tablestore/openclaw-tablestore-memory外掛程式，詳細說明詳見Tablestore記憶儲存在OpenClaw中的實現。

openclaw plugins install @tablestore/openclaw-tablestore-memory

編輯~/.openclaw/openclaw.json，在plugins.entries中加入tablestore-mem配置塊，並將plugins.slots.memory指向tablestore-mem。

{
  "plugins": {
    "slots": {
      "memory": "tablestore-mem"
    },
    "entries": {
      "tablestore-mem": {
        "enabled": true,
        "config": {
          "endpoint": "https://<your-instance>.cn-beijing.ots.aliyuncs.com",
          "otsInstanceName": "<your-instance>",
          "accessKeyId": "<your-access-key-id>",
          "accessKeySecret": "<your-access-key-secret>",
          "appId": "shared-agents",
          "tenantId": "default-tenant",
          "memoryStoreName": "shared_memory",
          "autoCreateMemoryStore": true,
          "minQueryLength": 0
        },
        "hooks": {
          "allowConversationAccess": true
        }
      }
    }
  }
}

重啟OpenClaw網關使配置生效，並執行診斷命令驗證串連。

openclaw gateway restart
openclaw tablestore-mem doctor

輸出中ok欄位為true、memoryStore.ok為true，即表示OpenClaw側已正確接入Tablestore。

Hermes Agent側配置

執行以下命令安裝hermes-tablestore-memory外掛程式，詳細說明（含SDK依賴安裝與國內網路下的鏡像配置）詳見Tablestore記憶儲存在hermes-agent中的實現。

hermes plugins install --enable https://github.com/aliyun/hermes-tablestore-memory

將AccessKey寫入~/.hermes/.env。

echo 'TABLESTORE_MEMORY_AK=<your-access-key-id>' >> ~/.hermes/.env
echo 'TABLESTORE_MEMORY_SK=<your-access-key-secret>' >> ~/.hermes/.env

將外掛程式參數寫入~/.hermes/tablestore_memory.json，確保app_id、tenant_id、memory_store_name與OpenClaw側完全一致。

{
  "endpoint": "https://<your-instance>.cn-beijing.ots.aliyuncs.com",
  "instance_name": "<your-instance>",
  "memory_store_name": "shared_memory",
  "app_id": "shared-agents",
  "tenant_id": "default-tenant",
  "enable_rerank": true,
  "auto_create_store": true,
  "timeout": 30.0
}

啟用tablestore-mem為記憶Provider，並執行診斷命令驗證串連。

hermes config set memory.provider tablestore-mem
hermes tablestore-mem doctor

輸出中ok欄位為true、checks.initialize.ok、checks.describe_memory_store.ok、checks.list_memories.ok均為true，即表示Hermes Agent側已正確接入Tablestore。

情境1：OpenClaw寫入，Hermes Agent召回

在OpenClaw中寫入專案偏好類記憶。

openclaw tablestore-mem add "我負責訂單服務模組的開發，使用Java、Spring Boot與MySQL技術棧"

切換到Hermes Agent發起新會話，提問與該記憶語義強相關的問題。Hermes Agent會在queue_prefetch()階段自動召回跨Agent的記憶並注入上下文。

hermes -z "我負責什麼模組？技術棧是什嗎？"

預期回複中包含"訂單服務模組"與"Java/Spring Boot/MySQL"等事實，證明Hermes Agent成功召回了OpenClaw寫入的記憶。

情境2：Hermes Agent寫入，OpenClaw召回

在Hermes Agent中寫入團隊事實類記憶。

hermes tablestore-mem add --sync "我們團隊的發布視窗是每周二下午14:00"

切換到OpenClaw發起新會話，提問與該事實相關的問題，OpenClaw會自動召回跨Agent的記憶。

openclaw agent --agent main --message "我們的發布視窗是什麼時候？"

預期回複中包含“每周二”與“14:00”等事實，證明OpenClaw成功召回了Hermes Agent寫入的記憶。

情境3：CLI命令交叉檢索

使用任意一側的CLI命令均可檢索兩側寫入的全部記憶。

openclaw tablestore-mem search "發布視窗"
hermes tablestore-mem search "訂單服務"

返回結果中scope.agentId欄位會顯示原始寫入方（如openclaw、hermes、main等），便於追溯記憶來源。

雙側的app_id、tenant_id或memory_store_name不一致還能互連嗎？

不能。共用檢索基於Scope匹配（app_id + tenant_id + memory_store_name），三項任一不一致即視為不同的記憶範圍，不會被對方召回。

從OpenClaw遷移到Hermes Agent後，OpenClaw還能繼續使用嗎？

可以。hermes claw migrate是複製操作而非剪下，OpenClaw原有的配置與本機資料不受影響，可雙側同時運行。完整遷移流程詳見Hermes Agent官方遷移指南。

安裝Hermes Agent或下載依賴時網路失敗怎麼辦？

國內網路環境下從GitHub或PyPI直連可能不穩定。建議配置阿里雲PyPI鏡像加速依賴下載，詳見Tablestore記憶儲存在hermes-agent中的實現中的“安裝時git clone失敗或PyPI下載緩慢”小節。