rol-websocket-channel 1.3.8 → 1.4.8

package/{MQTT-API /346/226/260/345/242/236/346/226/207/344/273/266/345/212/237/350/203/275.md" → MQTT-API 5-6.md }

@@ -85,6 +85,71 @@
 
 ---
 
+### openclawUpdate - 升级 OpenClaw
+
+**说明**
+- 固定执行 `openclaw update`。
+- 用于 App 上的“升级 OpenClaw”按钮。
+- 返回 `stdout` / `stderr`，失败时外层 `ok` 为 `false`。
+
+**请求**
+```json
+{
+  "type": "openclawUpdate",
+  "trace_id": "openclaw-update-001",
+  "data": {}
+}
+```
+
+**成功返回 data.result 示例**
+```json
+{
+  "ok": true,
+  "action": "openclawUpdate",
+  "restartRecommended": true,
+  "command": "openclaw",
+  "args": ["update"],
+  "cwd": "/home/user/.openclaw",
+  "stdout": "",
+  "stderr": ""
+}
+```
+
+---
+
+### pluginSelfUpdate - 升级 rol-websocket-channel 插件
+
+**说明**
+- 固定执行 `openclaw plugins install clawhub:rol-websocket-channel`。
+- 用于 App 上的“升级插件”按钮。
+- 命令执行成功后，新的插件代码通常需要 OpenClaw/插件进程重新加载后才会生效。
+
+**请求**
+```json
+{
+  "type": "pluginSelfUpdate",
+  "trace_id": "plugin-self-update-001",
+  "data": {}
+}
+```
+
+**成功返回 data.result 示例**
+```json
+{
+  "ok": true,
+  "action": "pluginSelfUpdate",
+  "plugin": "clawhub:rol-websocket-channel",
+  "restartRecommended": true,
+  "command": "openclaw",
+  "args": ["plugins", "install", "clawhub:rol-websocket-channel"],
+  "cwd": "/home/user/.openclaw",
+  "stdout": "",
+  "stderr": ""
+}
+```
+
+---
+
 ## 代理管理 (Agents)
 
 ### agentsGet - 获取代理配置
@@ -1077,6 +1142,8 @@
 - `systemStop`
 - `systemDoctorFix`
 - `systemLogs`
+- `openclawUpdate`
+- `pluginSelfUpdate`
 - `ping`
 - `status`
 - `echo`
@@ -1639,6 +1706,12 @@ openclaw admin-bridge pair <key> --endpoint https://api.deotaland.ai
 
 如果文件之前已经上传过，则不会重复上传，而是直接复用已有 `fileUrl`。
 
+### Markdown 文件规则
+
+- 第一次扫描时，已有 `.md` 文件会作为基线记录，不会展示在 artifacts 列表里。
+- 后续新生成的 `.md` 文件会进入 artifacts 列表。
+- `MEMORY.md`、`SoUL.md`、`AGENTS.md`、`HEARTBEAT.md`、`IDENTITY.md`、`TooLS.md`、`USER.md` 等记忆/身份文件永远不会展示。
+
 
 
 
@@ -1658,9 +1731,18 @@ MQTT 请求示例：
 
 典型顺序：
 
-1. `artifactsList`
+1. `artifactsList`    
+
+   {
+     "type": "artifactsList",
+     "trace_id": "artifact-list-before-download-001",
+     "data": {}
+   }
+
 2. 用户选择某个文件
+
 3. `artifactsEnsureUploaded`
+
 4. 使用返回的 `downloadUrl`
 
 
@@ -1709,3 +1791,9 @@ MQTT 请求示例：
 3. 直接使用返回的 `data.downloadUrl`
 4. 如果返回 `uploaded: false`，表示这次没有重新上传，而是复用了历史上传结果
 
+展示建议：
+
+- `category === "image"` 时，可以作为图片预览/展示。
+- `category === "document"` 时，可以作为文档展示或下载。
+- `storageStatus === "local_only"` 时，先调 `artifactsEnsureUploaded` 获取可访问的 `downloadUrl`。
+- `storageStatus === "uploaded"` 且 `fileUrl` 存在时，可以直接使用 `fileUrl` 展示或下载。