feat: release v1.0.0

openclaw.plugin.json

@@ -7,17 +7,32 @@
     "onStartup": true
   },
   "contracts": {
-    "tools": ["tdai_memory_search", "tdai_conversation_search"]
+    "tools": ["tdai_memory_search", "tdai_conversation_search", "tdai_read_cos"]
   },
   "configSchema": {
     "type": "object",
     "additionalProperties": true,
     "properties": {
+      "mode": {
+        "type": "string",
+        "enum": ["local", "function", "client", "gateway", "remote"],
+        "default": "local",
+        "description": "OpenClaw 接入模式：local/function（默认，本地进程内运行，使用 OpenClaw function/host LLM runner）或 client/gateway/remote（轻量客户端模式，连接外部 Memory Gateway）"
+      },
       "storeBackend": {
         "type": "string",
         "enum": ["sqlite", "tcvdb"],
         "default": "sqlite",
-        "description": "存储后端：sqlite（本地 SQLite + sqlite-vec）或 tcvdb（腾讯云向量数据库）"
+        "description": "存储后端：sqlite（本地 SQLite + sqlite-vec）或 tcvdb（腾讯云向量数据库）。仅 local/function 模式生效"
+      },
+      "server": {
+        "type": "object",
+        "description": "client/gateway/remote 模式下的外部 Memory Gateway 连接配置",
+        "properties": {
+          "url": { "type": "string", "default": "http://127.0.0.1:8420", "description": "Memory Gateway URL" },
+          "apiKey": { "type": "string", "default": "local", "description": "API Key for Gateway authentication" },
+          "instanceId": { "type": "string", "default": "default", "description": "Memory instance id（HTTP header x-tdai-service-id）" }
+        }
       },
       "capture": {
         "type": "object",
@@ -140,23 +155,27 @@
       },
       "offload": {
         "type": "object",
-        "description": "Context Offload 设置 — 多层上下文压缩系统（独立开关，默认关闭）",
+        "description": "Context Offload 设置 — 多层上下文压缩系统（独立开关，默认关闭）。支持 local（本地 LLM 处理）和 client（复用 server.url 远端服务）两种模式",
         "properties": {
           "enabled": { "type": "boolean", "default": false, "description": "是否启用 Context Offload（默认关闭，不影响 Memory 功能）" },
-          "model": { "type": "string", "description": "Offload 使用的 LLM 模型（格式: provider/model），未填写时使用 openclaw 默认模型" },
-          "temperature": { "type": "number", "default": 0.2, "description": "LLM 温度参数" },
-          "forceTriggerThreshold": { "type": "number", "default": 4, "description": "累积多少个 tool pair 后强制触发 L1" },
-          "dataDir": { "type": "string", "description": "自定义数据目录（绝对路径），默认 ~/.openclaw/context-offload" },
+          "mode": { "type": "string", "enum": ["local", "backend", "client", "collect"], "description": "Offload 运行模式：local（本地 LLM 处理）、backend（走 backendUrl 远端 v1 服务）、client（复用 server.url 远端 offload v2 服务）、collect（仅数据采集，不压缩）。未设置时自动推导：有 backendUrl → backend，有 server.url → client，否则 → local" },
+          "model": { "type": "string", "description": "【local 模式】Offload 使用的 LLM 模型（格式: provider/model），未填写时使用 openclaw 默认模型" },
+          "temperature": { "type": "number", "default": 0.2, "description": "【local 模式】LLM 温度参数" },
+          "forceTriggerThreshold": { "type": "number", "default": 4, "description": "【local 模式】累积多少个 tool pair 后强制触发 L1" },
+          "dataDir": { "type": "string", "description": "【local 模式】自定义数据目录（绝对路径），默认 ~/.openclaw/context-offload" },
           "defaultContextWindow": { "type": "number", "default": 200000, "description": "默认上下文窗口大小" },
-          "maxPairsPerBatch": { "type": "number", "default": 20, "description": "L1 每批最大 tool pair 数" },
-          "l2NullThreshold": { "type": "number", "default": 4, "description": "offload.jsonl 中 node_id=null 数量达到此阈值时触发 L2" },
-          "l2TimeoutSeconds": { "type": "number", "default": 300, "description": "距上次 L2 超过此秒数时触发 L2" },
+          "maxPairsPerBatch": { "type": "number", "default": 20, "description": "【local 模式】L1 每批最大 tool pair 数" },
+          "l2NullThreshold": { "type": "number", "default": 4, "description": "【local 模式】offload.jsonl 中 node_id=null 数量达到此阈值时触发 L2" },
+          "l2TimeoutSeconds": { "type": "number", "default": 300, "description": "【local 模式】距上次 L2 超过此秒数时触发 L2" },
           "mildOffloadRatio": { "type": "number", "default": 0.5, "description": "温和压缩触发比例（占 context window）" },
           "aggressiveCompressRatio": { "type": "number", "default": 0.85, "description": "激进压缩触发比例" },
-          "mmdMaxTokenRatio": { "type": "number", "default": 0.2, "description": "MMD 注入 token 预算比例" },
-          "backendUrl": { "type": "string", "description": "后端服务 URL（如 https://offload-api.example.com），配置后 L1/L1.5/L2/L4 走后端" },
-          "backendApiKey": { "type": "string", "description": "后端 API 认证 token" },
-          "backendTimeoutMs": { "type": "number", "default": 10000, "description": "后端调用超时（毫秒）" }
+          "mmdMaxTokenRatio": { "type": "number", "default": 0.2, "description": "【local 模式】MMD 注入 token 预算比例" },
+          "compactionRatio": { "type": "number", "default": 0.5, "description": "【client 模式】上下文占比超过此阈值时触发压缩（0-1），复用 server.url 作为后端地址" },
+          "ingestTimeoutMs": { "type": "number", "default": 5000, "description": "【client 模式】Ingest 请求超时（毫秒）" },
+          "compactionTimeoutMs": { "type": "number", "default": 30000, "description": "【client 模式】Compaction 请求超时（毫秒）" },
+          "backendUrl": { "type": "string", "description": "【已废弃，请使用 mode=client】后端服务 URL，配置后 L1/L1.5/L2/L4 走后端" },
+          "backendApiKey": { "type": "string", "description": "【已废弃，请使用 mode=client】后端 API 认证 token" },
+          "backendTimeoutMs": { "type": "number", "default": 10000, "description": "【已废弃，请使用 mode=client】后端调用超时（毫秒）" }
         }
       }
     }