rol-websocket-channel 1.5.8 → 1.6.0

package/MQTT-API System.md

@@ -88,7 +88,8 @@
 ### openclawUpdate - 升级 OpenClaw
 
 **说明**
-- 固定执行 `openclaw update`。
+- 固定执行 `npm install -g @openclaw/core@2026.5.6`。
+- 安装后依次执行 `openclaw --version` 和 `openclaw doctor --deep` 做校验。
 - 用于 App 上的“升级 OpenClaw”按钮。
 - 返回 `stdout` / `stderr`，失败时外层 `ok` 为 `false`。
 
@@ -106,12 +107,35 @@
 {
   "ok": true,
   "action": "openclawUpdate",
+  "targetPackage": "@openclaw/core",
+  "targetVersion": "2026.5.6",
   "restartRecommended": true,
-  "command": "openclaw",
-  "args": ["update"],
-  "cwd": "/home/user/.openclaw",
-  "stdout": "",
-  "stderr": ""
+  "steps": [
+    {
+      "name": "installCore",
+      "command": "npm",
+      "args": ["install", "-g", "@openclaw/core@2026.5.6"],
+      "cwd": "/home/user/.openclaw",
+      "stdout": "",
+      "stderr": ""
+    },
+    {
+      "name": "version",
+      "command": "openclaw",
+      "args": ["--version"],
+      "cwd": "/home/user/.openclaw",
+      "stdout": "OpenClaw 2026.5.6 ...",
+      "stderr": ""
+    },
+    {
+      "name": "doctorDeep",
+      "command": "openclaw",
+      "args": ["doctor", "--deep"],
+      "cwd": "/home/user/.openclaw",
+      "stdout": "",
+      "stderr": ""
+    }
+  ]
 }
 ```
 
@@ -120,7 +144,7 @@
 ### pluginSelfUpdate - 升级 rol-websocket-channel 插件
 
 **说明**
-- 固定执行 `openclaw plugins install clawhub:rol-websocket-channel`。
+- 固定执行 `openclaw plugins update clawhub:rol-websocket-channel`。
 - 用于 App 上的“升级插件”按钮。
 - 命令执行成功后，新的插件代码通常需要 OpenClaw/插件进程重新加载后才会生效。
 
@@ -133,6 +157,24 @@
 }
 ```
 
+---
+
+### systemCurrentVersion - 查询当前版本
+
+**说明**
+- 仅查询本机 OpenClaw 与当前 `rol-websocket-channel` 插件的版本信息。
+- check-only：不安装、不写配置、不创建定时任务、不重启网关。
+- 用于 App 上的“当前版本”展示或升级前后版本对比。
+
+**请求**
+```json
+{
+  "type": "systemCurrentVersion",
+  "trace_id": "system-current-version-001",
+  "data": {}
+}
+```
+
 **成功返回 data.result 示例**
 ```json
 {
@@ -1144,6 +1186,7 @@
 - `systemLogs`
 - `openclawUpdate`
 - `pluginSelfUpdate`
+- `systemCurrentVersion`
 - `ping`
 - `status`
 - `echo`
@@ -1811,7 +1854,9 @@ MQTT 请求示例：
 实际执行命令：
 
 ```bash
-openclaw update
+npm install -g @openclaw/core@2026.5.6
+openclaw --version
+openclaw doctor --deep
 ```
 
 MQTT 请求示例：
@@ -1835,12 +1880,35 @@ MQTT 请求示例：
   "data": {
     "ok": true,
     "action": "openclawUpdate",
+    "targetPackage": "@openclaw/core",
+    "targetVersion": "2026.5.6",
     "restartRecommended": true,
-    "command": "openclaw",
-    "args": ["update"],
-    "cwd": "/home/woowonjae/.openclaw",
-    "stdout": "...",
-    "stderr": ""
+    "steps": [
+      {
+        "name": "installCore",
+        "command": "npm",
+        "args": ["install", "-g", "@openclaw/core@2026.5.6"],
+        "cwd": "/home/woowonjae/.openclaw",
+        "stdout": "...",
+        "stderr": ""
+      },
+      {
+        "name": "version",
+        "command": "openclaw",
+        "args": ["--version"],
+        "cwd": "/home/woowonjae/.openclaw",
+        "stdout": "OpenClaw 2026.5.6 ...",
+        "stderr": ""
+      },
+      {
+        "name": "doctorDeep",
+        "command": "openclaw",
+        "args": ["doctor", "--deep"],
+        "cwd": "/home/woowonjae/.openclaw",
+        "stdout": "...",
+        "stderr": ""
+      }
+    ]
   }
 }
 ```
@@ -2008,3 +2076,120 @@ MQTT 请求示例：
 - 如果没有先调用 `configSetApiCoreBot`，发布时可能返回 `apiCoreBot.baseUrl is not configured`。
 - `authToken` 在返回值中会脱敏显示，实际写入 `openclaw.json` 的值是 `123` 或前端传入的值。
 - 生成文件本身仍然在 `.openclaw/workspace` 下，上传只在发布/下载链路触发时执行。
+---
+
+## Version Management
+
+查询本机版本并与期望版本比对，告知前端哪些组件需要升级。
+
+### systemCurrentVersion
+
+**说明**
+- 查询本机 OpenClaw 版本和 channel 插件版本，与期望版本比对。
+- openclaw 期望版本：插件内硬编码常量（当前 `2026.5.6`）。
+- channel 期望版本：`npm view rol-websocket-channel --json` 从 npm registry 获取最新发布版本。
+- `npm view` 失败时回退到硬编码 `1.5.9`，不阻塞接口。
+- `currentVersion !== latestVersion` → `status: "outdated"`，相等 → `status: "current"`。
+- 前端只需看 `targets` 里的 `status`，哪个 `"outdated"` 就调对应的升级接口。
+
+**前端升级流程**
+1. 调 `systemCurrentVersion`
+2. `channel` 是 `outdated` → 调 `pluginSelfUpdate`
+3. `openclaw` 是 `outdated` → 调 `openclawUpdate`
+4. 升完重启
+
+**请求**
+```json
+{
+  "type": "systemCurrentVersion",
+  "trace_id": "system-current-version-001",
+  "data": {}
+}
+```
+
+**成功返回示例（需要升级）**
+```json
+{
+  "type": "receiver",
+  "trace_id": "system-current-version-001",
+  "source": "system",
+  "success": true,
+  "data": {
+    "ok": true,
+    "action": "currentVersion",
+    "checkOnly": true,
+    "targets": [
+      {
+        "name": "openclaw",
+        "packageName": "openclaw",
+        "currentVersion": "2026.5.5",
+        "latestVersion": "2026.5.6",
+        "status": "outdated"
+      },
+      {
+        "name": "channel",
+        "packageName": "rol-websocket-channel",
+        "currentVersion": "1.4.8",
+        "latestVersion": "1.5.9",
+        "status": "outdated"
+      }
+    ],
+    "upgradeOrder": ["openclaw", "channel"],
+    "restartRecommended": true
+  }
+}
+```
+
+**成功返回示例（全部最新）**
+```json
+{
+  "type": "receiver",
+  "trace_id": "system-current-version-001",
+  "source": "system",
+  "success": true,
+  "data": {
+    "ok": true,
+    "action": "currentVersion",
+    "checkOnly": true,
+    "targets": [
+      {
+        "name": "openclaw",
+        "packageName": "openclaw",
+        "currentVersion": "2026.5.6",
+        "latestVersion": "2026.5.6",
+        "status": "current"
+      },
+      {
+        "name": "channel",
+        "packageName": "rol-websocket-channel",
+        "currentVersion": "1.5.9",
+        "latestVersion": "1.5.9",
+        "status": "current"
+      }
+    ],
+    "upgradeOrder": [],
+    "restartRecommended": false
+  }
+}
+```
+
+**失败返回**
+```json
+{
+  "type": "receiver",
+  "trace_id": "system-current-version-001",
+  "source": "system",
+  "success": false,
+  "error": {
+    "message": "OpenClaw system command failed: spawn openclaw ENOENT",
+    "action": "currentVersion.openclaw",
+    "command": "openclaw",
+    "args": ["--version"],
+    "cwd": "/home/woowonjae/.openclaw",
+    "stdout": "",
+    "stderr": ""
+  }
+}
+```
+
+JSON-RPC method name: `system.currentVersion`