@openclaw/voice-call 2026.1.29 → 2026.2.1

package/CHANGELOG.md

@@ -1,13 +1,33 @@
 # Changelog
 
+## 2026.2.1
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.1.31
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.1.30
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
 ## 2026.1.29
 
 ### Changes
+
 - Version alignment with core OpenClaw release numbers.
 
 ## 2026.1.26
 
 ### Changes
+
 - Breaking: voice-call TTS now uses core `messages.tts` (plugin TTS config deep‑merges with core).
 - Telephony TTS supports OpenAI + ElevenLabs; Edge TTS is ignored for calls.
 - Removed legacy `tts.model`/`tts.voice`/`tts.instructions` plugin fields.
@@ -16,54 +36,65 @@
 ## 2026.1.23
 
 ### Changes
+
 - Version alignment with core OpenClaw release numbers.
 
 ## 2026.1.22
 
 ### Changes
+
 - Version alignment with core OpenClaw release numbers.
 
 ## 2026.1.21
 
 ### Changes
+
 - Version alignment with core OpenClaw release numbers.
 
 ## 2026.1.20
 
 ### Changes
+
 - Version alignment with core OpenClaw release numbers.
 
 ## 2026.1.17-1
 
 ### Changes
+
 - Version alignment with core OpenClaw release numbers.
 
 ## 2026.1.17
 
 ### Changes
+
 - Version alignment with core OpenClaw release numbers.
 
 ## 2026.1.16
 
 ### Changes
+
 - Version alignment with core OpenClaw release numbers.
 
 ## 2026.1.15
 
 ### Changes
+
 - Version alignment with core OpenClaw release numbers.
 
 ## 2026.1.14
 
 ### Changes
+
 - Version alignment with core OpenClaw release numbers.
 
 ## 0.1.0
 
 ### Highlights
+
 - First public release of the @openclaw/voice-call plugin.
 
 ### Features
+
 - Providers: Twilio (Programmable Voice + Media Streams), Telnyx (Call Control v2), and mock provider for local dev.
 - Call flows: outbound notify vs. conversation modes, configurable auto‑hangup, and multi‑turn continuation.
 - Inbound handling: policy controls (disabled/allowlist/open), allowlist matching, and inbound greeting.

package/README.md

@@ -3,6 +3,7 @@
 Official Voice Call plugin for **OpenClaw**.
 
 Providers:
+
 - **Twilio** (Programmable Voice + Media Streams)
 - **Telnyx** (Call Control v2)
 - **Plivo** (Voice API + XML transfer + GetInput speech)
@@ -41,18 +42,18 @@ Put under `plugins.entries.voice-call.config`:
 
   twilio: {
     accountSid: "ACxxxxxxxx",
-    authToken: "your_token"
+    authToken: "your_token",
   },
 
   plivo: {
     authId: "MAxxxxxxxxxxxxxxxxxxxx",
-    authToken: "your_token"
+    authToken: "your_token",
   },
 
   // Webhook server
   serve: {
     port: 3334,
-    path: "/voice/webhook"
+    path: "/voice/webhook",
   },
 
   // Public exposure (pick one):
@@ -61,17 +62,18 @@ Put under `plugins.entries.voice-call.config`:
   // tailscale: { mode: "funnel", path: "/voice/webhook" }
 
   outbound: {
-    defaultMode: "notify" // or "conversation"
+    defaultMode: "notify", // or "conversation"
   },
 
   streaming: {
     enabled: true,
-    streamPath: "/voice/stream"
-  }
+    streamPath: "/voice/stream",
+  },
 }
 ```
 
 Notes:
+
 - Twilio/Telnyx/Plivo require a **publicly reachable** webhook URL.
 - `mock` is a local dev provider (no network calls).
 - `tunnel.allowNgrokFreeTierLoopbackBypass: true` allows Twilio webhooks with invalid signatures **only** when `tunnel.provider="ngrok"` and `serve.bind` is loopback (ngrok local agent). Use for local dev only.
@@ -87,13 +89,14 @@ same shape — overrides deep-merge with `messages.tts`.
   tts: {
     provider: "openai",
     openai: {
-      voice: "alloy"
-    }
-  }
+      voice: "alloy",
+    },
+  },
 }
 ```
 
 Notes:
+
 - Edge TTS is ignored for voice calls (telephony audio needs PCM; Edge output is unreliable).
 - Core TTS is used when Twilio media streaming is enabled; otherwise calls fall back to provider native voices.
 
@@ -114,6 +117,7 @@ openclaw voicecall expose --mode funnel
 Tool name: `voice_call`
 
 Actions:
+
 - `initiate_call` (message, to?, mode?)
 - `continue_call` (callId, message)
 - `speak_to_user` (callId, message)

package/index.ts

@@ -1,12 +1,12 @@
 import { Type } from "@sinclair/typebox";
 import type { CoreConfig } from "./src/core-bridge.js";
+import { registerVoiceCallCli } from "./src/cli.js";
 import {
   VoiceCallConfigSchema,
   resolveVoiceCallConfig,
   validateProviderConfig,
   type VoiceCallConfig,
 } from "./src/config.js";
-import { registerVoiceCallCli } from "./src/cli.js";
 import { createVoiceCallRuntime, type VoiceCallRuntime } from "./src/runtime.js";
 
 const voiceCallConfigSchema = {
@@ -145,23 +145,17 @@ const voiceCallPlugin = {
   description: "Voice-call plugin with Telnyx/Twilio/Plivo providers",
   configSchema: voiceCallConfigSchema,
   register(api) {
-    const config = resolveVoiceCallConfig(
-      voiceCallConfigSchema.parse(api.pluginConfig),
-    );
+    const config = resolveVoiceCallConfig(voiceCallConfigSchema.parse(api.pluginConfig));
     const validation = validateProviderConfig(config);
 
     if (api.pluginConfig && typeof api.pluginConfig === "object") {
       const raw = api.pluginConfig as Record<string, unknown>;
       const twilio = raw.twilio as Record<string, unknown> | undefined;
       if (raw.provider === "log") {
-        api.logger.warn(
-          "[voice-call] provider \"log\" is deprecated; use \"mock\" instead",
-        );
+        api.logger.warn('[voice-call] provider "log" is deprecated; use "mock" instead');
       }
       if (typeof twilio?.from === "string") {
-        api.logger.warn(
-          "[voice-call] twilio.from is deprecated; use fromNumber instead",
-        );
+        api.logger.warn("[voice-call] twilio.from is deprecated; use fromNumber instead");
       }
     }
 
@@ -175,7 +169,9 @@ const voiceCallPlugin = {
       if (!validation.valid) {
         throw new Error(validation.errors.join("; "));
       }
-      if (runtime) return runtime;
+      if (runtime) {
+        return runtime;
+      }
       if (!runtimePromise) {
         runtimePromise = createVoiceCallRuntime({
           config,
@@ -194,8 +190,7 @@ const voiceCallPlugin = {
 
     api.registerGatewayMethod("voicecall.initiate", async ({ params, respond }) => {
       try {
-        const message =
-          typeof params?.message === "string" ? params.message.trim() : "";
+        const message = typeof params?.message === "string" ? params.message.trim() : "";
         if (!message) {
           respond(false, { error: "message required" });
           return;
@@ -210,9 +205,7 @@ const voiceCallPlugin = {
           return;
         }
         const mode =
-          params?.mode === "notify" || params?.mode === "conversation"
-            ? params.mode
-            : undefined;
+          params?.mode === "notify" || params?.mode === "conversation" ? params.mode : undefined;
         const result = await rt.manager.initiateCall(to, undefined, {
           message,
           mode,
@@ -229,10 +222,8 @@ const voiceCallPlugin = {
 
     api.registerGatewayMethod("voicecall.continue", async ({ params, respond }) => {
       try {
-        const callId =
-          typeof params?.callId === "string" ? params.callId.trim() : "";
-        const message =
-          typeof params?.message === "string" ? params.message.trim() : "";
+        const callId = typeof params?.callId === "string" ? params.callId.trim() : "";
+        const message = typeof params?.message === "string" ? params.message.trim() : "";
         if (!callId || !message) {
           respond(false, { error: "callId and message required" });
           return;
@@ -251,10 +242,8 @@ const voiceCallPlugin = {
 
     api.registerGatewayMethod("voicecall.speak", async ({ params, respond }) => {
       try {
-        const callId =
-          typeof params?.callId === "string" ? params.callId.trim() : "";
-        const message =
-          typeof params?.message === "string" ? params.message.trim() : "";
+        const callId = typeof params?.callId === "string" ? params.callId.trim() : "";
+        const message = typeof params?.message === "string" ? params.message.trim() : "";
         if (!callId || !message) {
           respond(false, { error: "callId and message required" });
           return;
@@ -273,8 +262,7 @@ const voiceCallPlugin = {
 
     api.registerGatewayMethod("voicecall.end", async ({ params, respond }) => {
       try {
-        const callId =
-          typeof params?.callId === "string" ? params.callId.trim() : "";
+        const callId = typeof params?.callId === "string" ? params.callId.trim() : "";
         if (!callId) {
           respond(false, { error: "callId required" });
           return;
@@ -304,8 +292,7 @@ const voiceCallPlugin = {
           return;
         }
         const rt = await ensureRuntime();
-        const call =
-          rt.manager.getCall(raw) || rt.manager.getCallByProviderCallId(raw);
+        const call = rt.manager.getCall(raw) || rt.manager.getCallByProviderCallId(raw);
         if (!call) {
           respond(true, { found: false });
           return;
@@ -319,8 +306,7 @@ const voiceCallPlugin = {
     api.registerGatewayMethod("voicecall.start", async ({ params, respond }) => {
       try {
         const to = typeof params?.to === "string" ? params.to.trim() : "";
-        const message =
-          typeof params?.message === "string" ? params.message.trim() : "";
+        const message = typeof params?.message === "string" ? params.message.trim() : "";
         if (!to) {
           respond(false, { error: "to required" });
           return;
@@ -342,14 +328,11 @@ const voiceCallPlugin = {
     api.registerTool({
       name: "voice_call",
       label: "Voice Call",
-      description:
-        "Make phone calls and have voice conversations via the voice-call plugin.",
+      description: "Make phone calls and have voice conversations via the voice-call plugin.",
       parameters: VoiceCallToolSchema,
       async execute(_toolCallId, params) {
         const json = (payload: unknown) => ({
-          content: [
-            { type: "text", text: JSON.stringify(payload, null, 2) },
-          ],
+          content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
           details: payload,
         });
 
@@ -360,12 +343,16 @@ const voiceCallPlugin = {
             switch (params.action) {
               case "initiate_call": {
                 const message = String(params.message || "").trim();
-                if (!message) throw new Error("message required");
+                if (!message) {
+                  throw new Error("message required");
+                }
                 const to =
                   typeof params.to === "string" && params.to.trim()
                     ? params.to.trim()
                     : rt.config.toNumber;
-                if (!to) throw new Error("to required");
+                if (!to) {
+                  throw new Error("to required");
+                }
                 const result = await rt.manager.initiateCall(to, undefined, {
                   message,
                   mode:
@@ -404,7 +391,9 @@ const voiceCallPlugin = {
               }
               case "end_call": {
                 const callId = String(params.callId || "").trim();
-                if (!callId) throw new Error("callId required");
+                if (!callId) {
+                  throw new Error("callId required");
+                }
                 const result = await rt.manager.endCall(callId);
                 if (!result.success) {
                   throw new Error(result.error || "end failed");
@@ -413,10 +402,11 @@ const voiceCallPlugin = {
               }
               case "get_status": {
                 const callId = String(params.callId || "").trim();
-                if (!callId) throw new Error("callId required");
+                if (!callId) {
+                  throw new Error("callId required");
+                }
                 const call =
-                  rt.manager.getCall(callId) ||
-                  rt.manager.getCallByProviderCallId(callId);
+                  rt.manager.getCall(callId) || rt.manager.getCallByProviderCallId(callId);
                 return json(call ? { found: true, call } : { found: false });
               }
             }
@@ -424,11 +414,11 @@ const voiceCallPlugin = {
 
           const mode = params?.mode ?? "call";
           if (mode === "status") {
-            const sid =
-              typeof params.sid === "string" ? params.sid.trim() : "";
-            if (!sid) throw new Error("sid required for status");
-            const call =
-              rt.manager.getCall(sid) || rt.manager.getCallByProviderCallId(sid);
+            const sid = typeof params.sid === "string" ? params.sid.trim() : "";
+            if (!sid) {
+              throw new Error("sid required for status");
+            }
+            const call = rt.manager.getCall(sid) || rt.manager.getCallByProviderCallId(sid);
             return json(call ? { found: true, call } : { found: false });
           }
 
@@ -436,7 +426,9 @@ const voiceCallPlugin = {
             typeof params.to === "string" && params.to.trim()
               ? params.to.trim()
               : rt.config.toNumber;
-          if (!to) throw new Error("to required for call");
+          if (!to) {
+            throw new Error("to required for call");
+          }
           const result = await rt.manager.initiateCall(to, undefined, {
             message:
               typeof params.message === "string" && params.message.trim()
@@ -469,7 +461,9 @@ const voiceCallPlugin = {
     api.registerService({
       id: "voicecall",
       start: async () => {
-        if (!config.enabled) return;
+        if (!config.enabled) {
+          return;
+        }
         try {
           await ensureRuntime();
         } catch (err) {
@@ -481,7 +475,9 @@ const voiceCallPlugin = {
         }
       },
       stop: async () => {
-        if (!runtimePromise) return;
+        if (!runtimePromise) {
+          return;
+        }
         try {
           const rt = await runtimePromise;
           await rt.stop();

package/openclaw.plugin.json

@@ -168,12 +168,7 @@
       },
       "provider": {
         "type": "string",
-        "enum": [
-          "telnyx",
-          "twilio",
-          "plivo",
-          "mock"
-        ]
+        "enum": ["telnyx", "twilio", "plivo", "mock"]
       },
       "telnyx": {
         "type": "object",
@@ -224,12 +219,7 @@
       },
       "inboundPolicy": {
         "type": "string",
-        "enum": [
-          "disabled",
-          "allowlist",
-          "pairing",
-          "open"
-        ]
+        "enum": ["disabled", "allowlist", "pairing", "open"]
       },
       "allowFrom": {
         "type": "array",
@@ -247,10 +237,7 @@
         "properties": {
           "defaultMode": {
             "type": "string",
-            "enum": [
-              "notify",
-              "conversation"
-            ]
+            "enum": ["notify", "conversation"]
           },
           "notifyHangupDelaySec": {
             "type": "integer",
@@ -300,11 +287,7 @@
         "properties": {
           "mode": {
             "type": "string",
-            "enum": [
-              "off",
-              "serve",
-              "funnel"
-            ]
+            "enum": ["off", "serve", "funnel"]
           },
           "path": {
             "type": "string"
@@ -317,12 +300,7 @@
         "properties": {
           "provider": {
             "type": "string",
-            "enum": [
-              "none",
-              "ngrok",
-              "tailscale-serve",
-              "tailscale-funnel"
-            ]
+            "enum": ["none", "ngrok", "tailscale-serve", "tailscale-funnel"]
           },
           "ngrokAuthToken": {
             "type": "string"
@@ -344,9 +322,7 @@
           },
           "sttProvider": {
             "type": "string",
-            "enum": [
-              "openai-realtime"
-            ]
+            "enum": ["openai-realtime"]
           },
           "openaiApiKey": {
             "type": "string"
@@ -380,9 +356,7 @@
         "properties": {
           "provider": {
             "type": "string",
-            "enum": [
-              "openai"
-            ]
+            "enum": ["openai"]
           },
           "model": {
             "type": "string"
@@ -395,30 +369,18 @@
         "properties": {
           "auto": {
             "type": "string",
-            "enum": [
-              "off",
-              "always",
-              "inbound",
-              "tagged"
-            ]
+            "enum": ["off", "always", "inbound", "tagged"]
           },
           "enabled": {
             "type": "boolean"
           },
           "mode": {
             "type": "string",
-            "enum": [
-              "final",
-              "all"
-            ]
+            "enum": ["final", "all"]
           },
           "provider": {
             "type": "string",
-            "enum": [
-              "openai",
-              "elevenlabs",
-              "edge"
-            ]
+            "enum": ["openai", "elevenlabs", "edge"]
           },
           "summaryModel": {
             "type": "string"
@@ -476,11 +438,7 @@
               },
               "applyTextNormalization": {
                 "type": "string",
-                "enum": [
-                  "auto",
-                  "on",
-                  "off"
-                ]
+                "enum": ["auto", "on", "off"]
               },
               "languageCode": {
                 "type": "string"

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@openclaw/voice-call",
-  "version": "2026.1.29",
-  "type": "module",
+  "version": "2026.2.1",
   "description": "OpenClaw voice-call plugin",
+  "type": "module",
   "dependencies": {
-    "@sinclair/typebox": "0.34.47",
+    "@sinclair/typebox": "0.34.48",
     "ws": "^8.19.0",
     "zod": "^4.3.6"
   },
+  "devDependencies": {
+    "openclaw": "workspace:*"
+  },
   "openclaw": {
     "extensions": [
       "./index.ts"