記憶儲存服務限制與配額：地區、記憶庫、Scope、SDK 版本速查 - Tablestore

地區

當前僅在華北 2（北京）地區提供服務。

建立記憶庫後，索引初始化約需 1 分鐘。索引初始化完成後再執行寫入和檢索操作。

messages 和 text 至少提供其中一個。寫入記憶時 Scope 不允許使用萬用字元 *。

檢索長期記憶時，appId 和 tenantId 必填；agentId 和 runId 可使用萬用字元 *。

專案	限制
`scopes` 數量	必填，最多 20 個
`maxSessions`	`0~100`
`maxMessages`	`0~20000`
`maxMemories`	`0~5000`
`expandedScopeLimit`	`0~1000`
`instructions` 長度	最長 4000 個字元
`actionIds`（`ApplyMemoryDreamActions`）	單次最多 100 個

欄位	取值
`taskType`	`memory`（預設）/ `skill` / `profile`
`applyMode`	`proposal`（預設）/ `safe_auto`，僅 `taskType`=`memory` 支援
`scopeOutputMode`	`preserve_scope`（預設）/ `promote_scope`
`confidenceThresholds` 鍵	`add` / `update` / `merge`，值取值範圍 `0~1`；`DELETE` 不支援自動信賴度閾值
任務狀態（task `status`）	`queued` / `running` / `planning` / `applying` / `completed` / `completed_with_failures` / `failed` / `cancelled`
動作類型（`action`）	`ADD` / `UPDATE` / `DELETE` / `MERGE` / `NOOP` / `EMIT_SKILL` / `EMIT_PROFILE`
動作狀態（action `status`）	`proposed` / `applied` / `skipped` / `failed`

抽取任務狀態（ListMemoryTasks.status / GetMemoryTask 返回的 task.status）取值：queued / running / completed / failed / needs_reconcile。

操作	Scope 要求	是否允許 `*`
寫入記憶	`appId` 必填，其他層級為空白時自動補 `__default__`	否
檢索長期記憶	`appId`、`tenantId` 必填	`agentId`、`runId` 可用
查詢短期記憶	四級 Scope 全部必填	否
擷取單條長期記憶	四級 Scope 全部必填	否
更新單條長期記憶	四級 Scope 全部必填	否
刪除單條長期記憶	四級 Scope 全部必填	否
列出長期記憶	可按層級指定 Scope	是
查詢請求審計	可按層級指定 Scope	是

萬用字元必須按層級使用。一旦某一層級使用 *，後續層級也必須使用 * 或留空。例如 app-001/user-001/*/* 是有效範圍，app-001/*/agent-001/* 不是有效範圍。

AddMemories.sync 預設值為 false，即非同步寫入。非同步寫入的可見度如下：

需要在測試情境寫入後立即查看抽取結果時，將 sync 設定為 true。同步寫入完成後，長期記憶檢索仍存在短暫的索引重新整理延遲。

ListMemoryStoreMessages 用於查詢原始會話訊息，要求 appId、tenantId、agentId 和 runId 四級 Scope 全部填寫，不支援萬用字元。

適用情境：

CLI 的記憶類列表命令僅返回單頁結果，不會自動翻頁。需要繼續讀取下一頁時，使用響應中的 nextToken。

樣本：

tablestore-agent-cli memory list-units \
  --store agent_memory \
  --app-id app-001 \
  --next-token <token>

未配置 ots_endpoint 和 ots_instance_name 時，CLI 在執行 doctor 命令或實際操作時會自動在華北 2（北京）地區建立並複用託管 Tablestore 執行個體。自動建立需要一定時間，建立結果會寫入本地設定檔。

後續手動設定執行個體 Endpoint 和執行個體名稱時，CLI 使用顯式配置的執行個體。

SDK	版本要求
Python SDK	`tablestore >= 6.4.7`（`6.4.5` 起支援基礎記憶介面，`6.4.7` 起支援任務與記憶整理介面）
Node.js SDK	`tablestore >= 5.6.5`
CLI	`tablestore-agent-cli >= 0.1.8`

Hermes 和 OpenClaw 外掛程式在檢索時預設使用當前租戶下的跨 Agent、跨會話範圍，即 agentId=* 、runId=*。如果業務不允許跨 Agent 或跨會話共用記憶，通過 SDK 自行控制檢索 Scope，或調整外掛程式配置。