记忆存储服务限制与配额：地域、记忆库、Scope、SDK 版本速查 - 表格存储

地域

当前仅在华北 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。

通配符必须按层级使用。一旦某一层级使用 *，后续层级也必须使用 * 或留空。例如 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，或调整插件配置。