rol-websocket-channel 1.5.6 → 1.5.8

package/MQTT-API System.md

@@ -1908,3 +1908,103 @@ MQTT 请求示例：
   }
 }
 ```
+
+---
+
+## apiCoreBot 配置与 Artifact 发布（新增 configSetApiCoreBot；上传链接可返回会话）
+
+### configSetApiCoreBot
+
+作用：前端在需要开启文件上传/下载链接能力时主动调用，写入当前插件的 `apiCoreBot` 配置。这个配置不是配对时写入，只有收到该 MQTT 消息后才会更新 `openclaw.json`。
+
+写入位置：
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "rol-websocket-channel": {
+        "config": {
+          "apiCoreBot": {
+            "baseUrl": "http://192.168.1.23:9092",
+            "authToken": "123"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+默认值：
+
+- `baseUrl`: `http://192.168.1.23:9092`
+- `authToken`: `123`
+
+MQTT 请求示例：
+
+```json
+{
+  "type": "configSetApiCoreBot",
+  "trace_id": "config-api-core-bot-001",
+  "data": {}
+}
+```
+
+如果前端需要覆盖默认值，也可以显式传入：
+
+```json
+{
+  "type": "configSetApiCoreBot",
+  "trace_id": "config-api-core-bot-002",
+  "data": {
+    "baseUrl": "http://192.168.1.23:9092",
+    "authToken": "123"
+  }
+}
+```
+
+成功返回示例：
+
+```json
+{
+  "type": "receiver",
+  "trace_id": "config-api-core-bot-001",
+  "source": "system",
+  "success": true,
+  "data": {
+    "ok": true,
+    "configFile": "/home/woowonjae/.openclaw/openclaw.json",
+    "updated": [
+      "plugins.entries.rol-websocket-channel.config.apiCoreBot.baseUrl",
+      "plugins.entries.rol-websocket-channel.config.apiCoreBot.authToken"
+    ],
+    "apiCoreBot": {
+      "baseUrl": "http://192.168.1.23:9092",
+      "authToken": "********"
+    }
+  }
+}
+```
+
+### Artifact 发布链路
+
+`configSetApiCoreBot` 写入成功后，Artifact 发布方法会从 `openclaw.json` 读取 `apiCoreBot.baseUrl` 和 `apiCoreBot.authToken`，再调用上传接口。小龙虾会话如果调用插件工具 `rol_artifacts_publish`，成功后会拿到可返回给用户的下载链接。
+
+成功返回中的核心字段：
+
+```json
+{
+  "ok": true,
+  "uploaded": true,
+  "artifactId": "art_91f6d03e144c",
+  "objectKey": "uploads/91a78677-5e79-4259-a28d-fa01f24d4848.svg",
+  "downloadUrl": "https://draft-user.s3.us-east-2.amazonaws.com/uploads/91a78677-5e79-4259-a28d-fa01f24d4848.svg"
+}
+```
+
+注意：
+
+- 如果没有先调用 `configSetApiCoreBot`，发布时可能返回 `apiCoreBot.baseUrl is not configured`。
+- `authToken` 在返回值中会脱敏显示，实际写入 `openclaw.json` 的值是 `123` 或前端传入的值。
+- 生成文件本身仍然在 `.openclaw/workspace` 下，上传只在发布/下载链路触发时执行。