@vauxr/openclaw 2026.5.24-2 → 2026.5.31

package/dist/index.js

@@ -28,15 +28,20 @@ const entry = defineChannelPluginEntry({
         }
         const client = new VauxrAPIClient(httpBase, config.token ?? "");
         registerTools(api, client);
-        // WS bridge to vauxr — guard against double-registration.
-        // OpenClaw invokes registerFull from multiple subsystems in the same
-        // process; without this flag, both bridges would contend for the
-        // single active channel slot in vauxr and flap continuously.
+        // Construct the WS bridge but DO NOT start it here. `registerFull` is
+        // invoked from introspection paths too (e.g. `openclaw doctor`), and
+        // starting the bridge here would open a live WebSocket to vauxr during
+        // diagnostics. The bridge is started later by `gateway.startAccount`
+        // (see channel.ts), which only fires when the gateway is actually
+        // bringing the channel up for runtime use. The globalThis stash bridges
+        // the two scopes because `startAccount` doesn't have access to `api`.
+        //
+        // The single-bridge guard remains here so multiple `registerFull`
+        // invocations in the same process don't reconstruct the bridge — they'd
+        // contend for the single active channel slot in vauxr otherwise.
         const g = globalThis;
-        if (!g.__vauxrBridgeStarted) {
-            g.__vauxrBridgeStarted = true;
-            const bridge = new VauxrBridge(api, config);
-            bridge.start();
+        if (!g.__vauxrBridge) {
+            g.__vauxrBridge = new VauxrBridge(api, config);
         }
         // Voice system prompt injection for vauxr sessions. Match both the bare
         // form (`vauxr:<deviceId>`) used by the old subagent.run path and the

package/dist/src/bridge.js

@@ -8,6 +8,7 @@ export class VauxrBridge {
     reconnectMs = INITIAL_RECONNECT_MS;
     reconnectTimer = null;
     unsubscribeEvents = null;
+    started = false;
     // Inflight turns keyed by deviceId. channel.turn.run doesn't surface an SDK
     // runId to the caller (unlike the old subagent.run path), so dispatch-time
     // bookkeeping is keyed by deviceId; we then latch onto the SDK runId on the
@@ -33,10 +34,16 @@ export class VauxrBridge {
         this.wsUrl = base.replace(/^http/, "ws") + "/channel";
     }
     start() {
+        if (this.started)
+            return;
+        this.started = true;
         this.connect();
         this.subscribeAgentEvents();
     }
     stop() {
+        if (!this.started)
+            return;
+        this.started = false;
         if (this.reconnectTimer) {
             clearTimeout(this.reconnectTimer);
             this.reconnectTimer = null;
@@ -49,13 +56,18 @@ export class VauxrBridge {
             this.ws.close();
             this.ws = null;
         }
+        // Reset the backoff so a subsequent stop/start cycle (e.g. channel
+        // aborts then restarts) begins reconnecting at INITIAL_RECONNECT_MS
+        // instead of inheriting whatever escalated delay the previous run
+        // had accumulated.
+        this.reconnectMs = INITIAL_RECONNECT_MS;
     }
     connect() {
-        this.api.logger.info(`[vauxr-bridge] Connecting to vauxr: ${this.wsUrl}`);
+        this.api.logger.debug?.(`[vauxr-bridge] Connecting to vauxr: ${this.wsUrl}`);
         const ws = new WebSocket(this.wsUrl);
         this.ws = ws;
         ws.on("open", () => {
-            this.api.logger.info("[vauxr-bridge] Connected to vauxr");
+            this.api.logger.debug?.("[vauxr-bridge] Connected to vauxr");
             this.reconnectMs = INITIAL_RECONNECT_MS;
             // Authenticate with channel token
             if (this.config.token) {
@@ -72,9 +84,17 @@ export class VauxrBridge {
             }
         });
         ws.on("close", () => {
-            this.api.logger.info("[vauxr-bridge] Disconnected from vauxr");
+            this.api.logger.debug?.("[vauxr-bridge] Disconnected from vauxr");
+            // Identity check: a stop() during the close-event async delay can be
+            // followed by another start() that opens a fresh ws. If we cleared
+            // `this.ws` blindly here we'd wipe the new socket's reference and
+            // also fire a duplicate reconnect. Only act if we're still the
+            // bridge's current ws.
+            if (this.ws !== ws)
+                return;
             this.ws = null;
-            this.scheduleReconnect();
+            if (this.started)
+                this.scheduleReconnect();
         });
         ws.on("error", (err) => {
             this.api.logger.warn(`[vauxr-bridge] WS error: ${String(err)}`);
@@ -84,7 +104,7 @@ export class VauxrBridge {
     scheduleReconnect() {
         if (this.reconnectTimer)
             return;
-        this.api.logger.info(`[vauxr-bridge] Reconnecting in ${this.reconnectMs}ms`);
+        this.api.logger.debug?.(`[vauxr-bridge] Reconnecting in ${this.reconnectMs}ms`);
         this.reconnectTimer = setTimeout(() => {
             this.reconnectTimer = null;
             this.connect();
@@ -102,7 +122,7 @@ export class VauxrBridge {
                 this.api.logger.info(`[vauxr-bridge] Device ${frame.deviceId ?? "unknown"}: ${frame.state ?? "unknown"}`);
                 break;
             case "channel.ready":
-                this.api.logger.info("[vauxr-bridge] Channel authenticated");
+                this.api.logger.debug?.("[vauxr-bridge] Channel authenticated");
                 break;
             case "error":
                 this.api.logger.warn(`[vauxr-bridge] Error from vauxr: ${frame.code ?? "UNKNOWN"} — ${frame.message ?? "no details"}`);
@@ -144,7 +164,13 @@ export class VauxrBridge {
             Timestamp: Date.now(),
         };
         try {
-            await this.api.runtime.channel.turn.run({
+            // OpenClaw 2026.5.28 renamed `runtime.channel.turn` to
+            // `runtime.channel.inbound` (pure rename — same signature, same
+            // ChannelInboundEventRunnerParams shape as the prior
+            // RunChannelTurnParams). Earlier vauxr-openclaw releases that
+            // referenced `.turn.run` will throw `Cannot read properties of
+            // undefined (reading 'run')` on gateways 2026.5.28+.
+            await this.api.runtime.channel.inbound.run({
                 channel: "vauxr",
                 raw: { deviceId, text },
                 adapter: {

package/dist/src/channel.js

@@ -7,7 +7,7 @@ import { createTopLevelChannelConfigBase } from "openclaw/plugin-sdk/channel-con
 export const vauxrPlugin = createChatChannelPlugin({
     base: createChannelPluginBase({
         id: "vauxr",
-        meta: { label: "Vauxr" },
+        meta: { label: "Vauxr", selectionLabel: "Vauxr (voice devices)", docsPath: "/channels/vauxr", blurb: "Speak through and control Vauxr voice devices on your LAN." },
         capabilities: {
             chatTypes: ["direct"],
         },
@@ -75,9 +75,30 @@ vauxrPlugin.config.isConfigured = (_account, cfg) => {
 };
 vauxrPlugin.gateway = {
     startAccount: async (ctx) => {
-        await new Promise((resolve) => {
-            ctx.abortSignal.addEventListener("abort", () => resolve(), { once: true });
-        });
+        // If the channel was aborted before startAccount even ran, there's no
+        // bridge to start and nothing to clean up — short-circuit.
+        if (ctx.abortSignal.aborted)
+            return;
+        const g = globalThis;
+        g.__vauxrBridge?.start();
+        try {
+            await new Promise((resolve) => {
+                // Guard against the race where the signal aborts between the
+                // top-of-function check and the listener attach below. In that
+                // window `addEventListener("abort", ...)` would never fire,
+                // hanging startAccount forever.
+                if (ctx.abortSignal.aborted) {
+                    resolve();
+                    return;
+                }
+                ctx.abortSignal.addEventListener("abort", () => resolve(), { once: true });
+            });
+        }
+        finally {
+            // Always stop the bridge on the way out — covers normal abort,
+            // already-aborted-after-attach, and any thrown error in between.
+            g.__vauxrBridge?.stop();
+        }
     },
 };
 function resolveSection(cfg) {

package/openclaw.plugin.json

@@ -4,6 +4,7 @@
   "channels": ["vauxr"],
   "name": "Vauxr",
   "description": "Vauxr voice device channel plugin for OpenClaw",
+  "contracts": { "tools": ["vauxr_devices", "vauxr_announce", "vauxr_control"] },
   "channelConfigs": {
     "vauxr": {
       "label": "Vauxr",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vauxr/openclaw",
-  "version": "2026.5.24-2",
+  "version": "2026.5.31",
   "type": "module",
   "main": "./dist/index.js",
   "files": [
@@ -16,12 +16,12 @@
       "./dist/setup-entry.js"
     ],
     "compat": {
-      "pluginApi": ">=2026.5.12",
-      "minGatewayVersion": "2026.5.12"
+      "pluginApi": ">=2026.5.28",
+      "minGatewayVersion": "2026.5.28"
     },
     "build": {
-      "openclawVersion": "2026.5.12",
-      "pluginSdkVersion": "2026.5.12"
+      "openclawVersion": "2026.5.28",
+      "pluginSdkVersion": "2026.5.28"
     }
   },
   "dependencies": {
@@ -30,7 +30,7 @@
   },
   "devDependencies": {
     "@types/ws": "^8.5.0",
-    "openclaw": "^2026.5.12",
+    "openclaw": "^2026.5.28",
     "typescript": "^5.0.0"
   },
   "description": "An OpenClaw plugin that gives your agents the ability to speak through and control Vauxr voice assistant devices.",