openclaw-elys 1.4.7 → 1.5.0

package/README.md

@@ -8,12 +8,9 @@ Elys App 的 OpenClaw 频道插件 — 将本地 OpenClaw 智能体连接到 Ely
 
 ```bash
 # 1. Install the plugin / 安装插件
-openclaw plugins install openclaw-elys
+openclaw plugins install openclaw-elys@latest
 
-# 2. Restart gateway (required after install) / 重启网关（安装后必须）
-openclaw gateway restart
-
-# 3. Register device / 注册设备
+# 2. Register device / 注册设备
 npx openclaw-elys@latest setup <gateway_url> <register_token>
 ```
 

package/dist/src/monitor.js

@@ -65,7 +65,7 @@ export async function monitorElysProvider(opts) {
                                 fullText += payload.text;
                                 seq++;
                                 const done = info.kind === "final";
-                                mqttClient.publishStreamChunk(cmd.id, payload.text, seq, done);
+                                mqttClient.publishStreamChunk(cmd.id, payload.text, seq, done, cmd.reply_to);
                                 if (info.kind === "block") {
                                     log(`[elys] stream chunk #${seq}: ${payload.text.slice(0, 80)}...`);
                                 }
@@ -75,7 +75,7 @@ export async function monitorElysProvider(opts) {
                             }
                             else if (info.kind === "final") {
                                 seq++;
-                                mqttClient.publishStreamChunk(cmd.id, "", seq, true);
+                                mqttClient.publishStreamChunk(cmd.id, "", seq, true, cmd.reply_to);
                                 log(`[elys] final reply delivered (empty)`);
                             }
                         },

package/dist/src/mqtt-client.d.ts

@@ -11,14 +11,14 @@ export declare class ElysDeviceMQTTClient {
     private log;
     private consecutiveFailures;
     private static readonly MAX_FAILURES_BEFORE_REVOKE_WARNING;
+    private commandQueue;
     constructor(credentials: DeviceCredentials, log?: (...args: unknown[]) => void);
     setCommandHandler(handler: CommandHandler): void;
     connect(abortSignal?: AbortSignal): Promise<void>;
     disconnect(): void;
     /** Send a stream chunk (for streaming AI responses) */
-    publishStreamChunk(commandId: string, chunk: string, seq: number, done: boolean): void;
+    publishStreamChunk(commandId: string, chunk: string, seq: number, done: boolean, replyTo?: string): void;
     private handleMessage;
     private publishAck;
-    private publishResult;
     private publish;
 }

package/dist/src/mqtt-client.js

@@ -10,6 +10,7 @@ export class ElysDeviceMQTTClient {
     log;
     consecutiveFailures = 0;
     static MAX_FAILURES_BEFORE_REVOKE_WARNING = 3;
+    commandQueue = Promise.resolve();
     constructor(credentials, log) {
         this.credentials = credentials;
         this.log = log ?? console.log;
@@ -42,7 +43,8 @@ export class ElysDeviceMQTTClient {
             });
         });
         this.client.on("message", (_topic, payload) => {
-            this.handleMessage(payload).catch((err) => {
+            // Serial queue: commands are processed one at a time in arrival order
+            this.commandQueue = this.commandQueue.then(() => this.handleMessage(payload), () => this.handleMessage(payload)).catch((err) => {
                 this.log("[elys] error handling message:", err);
             });
         });
@@ -102,7 +104,7 @@ export class ElysDeviceMQTTClient {
         }
     }
     /** Send a stream chunk (for streaming AI responses) */
-    publishStreamChunk(commandId, chunk, seq, done) {
+    publishStreamChunk(commandId, chunk, seq, done, replyTo) {
         const msg = {
             id: commandId,
             type: "stream",
@@ -111,7 +113,7 @@ export class ElysDeviceMQTTClient {
             seq,
             done,
         };
-        this.publish(msg);
+        this.publish(msg, replyTo);
     }
     async handleMessage(payload) {
         const raw = JSON.parse(payload.toString());
@@ -120,23 +122,25 @@ export class ElysDeviceMQTTClient {
             return;
         }
         this.log(`[elys] received command: ${raw.command} (id: ${raw.id})`);
-        // Send ACK immediately
+        // ACK always goes to shared upstream topic (any gateway instance can process it)
         this.publishAck(raw.id);
+        // Result/stream goes to reply_to if present (routes to the specific gateway instance)
+        const replyTo = raw.reply_to;
         // Execute command
         if (this.commandHandler) {
             try {
                 const result = await this.commandHandler(raw);
-                this.publishResult(result);
+                this.publish(result, replyTo);
             }
             catch (err) {
                 const errMsg = err instanceof Error ? err.message : String(err);
-                this.publishResult({
+                this.publish({
                     id: raw.id,
                     type: "result",
                     timestamp: Date.now() / 1000,
                     status: "error",
                     error: errMsg,
-                });
+                }, replyTo);
             }
         }
     }
@@ -146,15 +150,13 @@ export class ElysDeviceMQTTClient {
             type: "ack",
             timestamp: Math.floor(Date.now() / 1000),
         };
+        // ACK always to default upstream topic (shared subscription)
         this.publish(msg);
     }
-    publishResult(msg) {
-        this.publish(msg);
-    }
-    publish(msg) {
+    publish(msg, replyTo) {
         if (!this.client)
             return;
-        const topic = `elys/up/${this.credentials.deviceId}`;
+        const topic = replyTo || `elys/up/${this.credentials.deviceId}`;
         this.client.publish(topic, JSON.stringify(msg), { qos: 1 }, (err) => {
             if (err) {
                 this.log(`[elys] failed to publish to ${topic}:`, err);

package/dist/src/types.d.ts

@@ -24,6 +24,8 @@ export interface CommandMessage extends MQTTBaseMessage {
     type: "command";
     command: string;
     args?: Record<string, unknown>;
+    /** If set, device should publish result/stream to this topic instead of elys/up/{device_id} */
+    reply_to?: string;
 }
 export interface AckMessage extends MQTTBaseMessage {
     type: "ack";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-elys",
-  "version": "1.4.7",
+  "version": "1.5.0",
   "description": "OpenClaw Elys channel plugin — connects to Elys App",
   "type": "module",
   "main": "dist/index.js",