Tablestore:エージェントエコシステム連携

インストール

openclaw plugins install @tablestore/openclaw-tablestore-memory

設定

最小構成は次のとおりです：

{
  "plugins": {
    "slots": {
      "memory": "tablestore-mem"
    },
    "entries": {
      "tablestore-mem": {
        "enabled": true,
        "config": {
          "endpoint": "https://<instance>.cn-beijing.ots.aliyuncs.com",
          "otsInstanceName": "<instance-name>",
          "accessKeyId": "<AccessKey ID>",
          "accessKeySecret": "<AccessKey Secret>"
        }
      }
    }
  }
}

オプション設定

スコープマッピング

OpenClaw プラグインは、書き込み操作に現在のランタイムのアイデンティティを使用します：

{
  "appId": "openclaw",
  "tenantId": "<current-user>",
  "agentId": "<runtime-agent>",
  "runId": "<runtime-session>"
}

検索操作では、テナント内のエージェントおよびセッションにまたがるスコープを使用します。agentId と runId パラメータは、ワイルドカード文字 * に設定されます：

{
  "appId": "openclaw",
  "tenantId": "<current-user>",
  "agentId": "*",
  "runId": "*"
}

ランタイムの動作

• before_prompt_build フェーズで関連する長期記憶を取得します。

• 取得したメモリは、可視のセッション履歴に直接書き込むのではなく、非表示のコンテキストに挿入します。

• agent_end フェーズで、現在のターンのユーザーメッセージとアシスタントメッセージを収集します。

• デフォルトでは、メモリストアに書き戻すために AddMemories を非同期に呼び出します。

CLI およびスラッシュコマンド

OpenClaw プラグインは、次のデバッグコマンドを提供します：

openclaw tablestore-mem add "Alice likes jasmine tea" --uid alice
openclaw tablestore-mem search "what does Alice like" --uid alice

OpenClaw のセッション内では、次のコマンドを使用できます：

/tablestore-mem-add Alice likes jasmine tea
/tablestore-mem-search jasmine tea

インストール

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

hermes memory setup の実行時に、tablestore-mem を選択します。

このプラグインには tablestore>=6.4.5 が必要です。Hermes で使用する Python 環境にこの依存関係がインストールされていない場合は、その環境に SDK をインストールする必要があります。

シークレットキーの設定

シークレットキーは ~/.hermes/.env に書き込むことを推奨します：

TABLESTORE_MEMORY_AK=<AccessKey ID>
TABLESTORE_MEMORY_SK=<AccessKey Secret>

メモリサービスの設定

機密性のない設定は $HERMES_HOME/tablestore_memory.json に記述します：

{
  "endpoint": "https://<instance>.cn-beijing.ots.aliyuncs.com",
  "instance_name": "<instance-name>",
  "memory_store_name": "hermes_mem",
  "description": "",
  "app_id": "hermes",
  "tenant_id": "",
  "enable_rerank": true,
  "auto_create_store": true,
  "timeout": 30
}

デフォルト値

スコープマッピング

Hermes プラグインは、次のルールに従って 4 パートのスコープを設定します：

書き込み操作では、現在のセッションの厳密なスコープを使用します。検索操作では、エージェントおよびセッションにまたがるテナントレベルのスコープを使用し、agentId と runId を "" に設定します。

ツール

また、このプラグインは、各会話ターンの後にユーザーとアシスタントのメッセージを自動的に同期し、次のターンが始まる前に関連するメモリをプリフェッチします。

Hermes CLI コマンド

memory.provider を tablestore-mem に設定した後、次のコマンドを使用できます：

hermes tablestore-mem add "User prefers concise answers"
hermes tablestore-mem add "User likes Rust" --metadata source=manual --metadata topic=preferences
hermes tablestore-mem add "Write this memory synchronously" --sync
hermes tablestore-mem search "concise answers"
hermes tablestore-mem search "Rust" --top-k 10