Tablestore:Configure long-term agent memory with Tablestore in OpenClaw

Step 1: Install the plugin

openclaw plugins install @tablestore/openclaw-mem0

OpenClaw unpacks plugins with the Node.js tar module. Large packages such as @tablestore/openclaw-mem0 (roughly 7,000 files) can hit a 120-second timeout. Avoid this by downloading with npm, extracting with the system tar utility, then installing from a local folder.

1. Download the package to /tmp.

   cd /tmp && npm pack @tablestore/openclaw-mem0

2. Extract the tarball with the system tar command. The command resolves the filename dynamically, so version bumps do not require edits.

   mkdir -p /tmp/openclaw-mem0-install && tar xzf /tmp/$(ls /tmp/tablestore-openclaw-mem0-*.tgz | head -1 | xargs basename) -C /tmp/openclaw-mem0-install --strip-components=1

3. Install from the local folder.

   openclaw plugins install /tmp/openclaw-mem0-install

Step 2: Configure the plugin

Edit ~/.openclaw/openclaw.json. Add a config object under plugins.entries.openclaw-mem0.

{
  "plugins": {
    "entries": {
      "openclaw-mem0": {
        "enabled": true,
        "config": {
          "mode": "open-source",
          "oss": {
            "vectorStore": {
              "provider": "tablestore",
              "config": {
                "endpoint": "https://{Instance Name}.{Region}.ots.aliyuncs.com",
                "instanceName": "{Instance Name}",
                "accessKeyId": "{AccessKey ID}",
                "accessKeySecret": "{AccessKey secret}"
              }
            },
            "embedder": {
              "provider": "openai",
              "config": {
                "apiKey": "{Model Studio API Key}",
                "model": "text-embedding-v3",
                "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1"
              }
            },
            "llm": {
              "provider": "openai",
              "config": {
                "apiKey": "{Model Studio API Key}",
                "model": "qwen-plus",
                "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1"
              }
            }
          }
        }
      }
    }
  }
}

"vectorStore": {
  "provider": "tablestore",
  "config": {
    "accessKeyId": "{AccessKey ID}",
    "accessKeySecret": "{AccessKey secret}",
    "regionId": "cn-hangzhou"
  }
}

"vectorStore": {
  "provider": "tablestore",
  "config": {
    "roleName": "{RAM Role Name}",
    "regionId": "cn-hangzhou"
  }
}

Step 3: Restart the gateway

openclaw gateway restart

Step 4: Verify the installation

openclaw mem0 stats

Successful output resembles:

[TablestoreVectorStore] OTS service status: enabled
Mode: open-source
User: default
Total memories: 0
Graph enabled: false
Auto-recall: true, Auto-capture: true

Total memories reports how many memories are stored. It starts at 0 and increases as conversations run.

Automatic extraction and retrieval

After configuration, no extra setup is required. In the TUI or a connected messaging channel, mem0:

• Extracts when it detects durable user information—dietary preferences, coding habits, project background—and writes it to Tablestore.

• Retrieves relevant memories before the next turn and injects them into context, so users avoid repeating the same facts.

Search memory

openclaw mem0 search "Hangzhou"

Returns entries semantically related to the query. Use this command to verify writes or inspect retrieval behavior.