@openclaw/voice-call 2026.3.13 → 2026.5.2-beta.1

package/openclaw.plugin.json

@@ -1,5 +1,27 @@
 {
   "id": "voice-call",
+  "commandAliases": [{ "name": "voicecall" }],
+  "activation": {
+    "onStartup": true,
+    "onCommands": ["voicecall"]
+  },
+  "contracts": {
+    "tools": ["voice_call"]
+  },
+  "channelEnvVars": {
+    "voice-call": [
+      "TELNYX_API_KEY",
+      "TELNYX_CONNECTION_ID",
+      "TELNYX_PUBLIC_KEY",
+      "TWILIO_ACCOUNT_SID",
+      "TWILIO_AUTH_TOKEN",
+      "TWILIO_FROM_NUMBER",
+      "PLIVO_AUTH_ID",
+      "PLIVO_AUTH_TOKEN",
+      "NGROK_AUTHTOKEN",
+      "NGROK_DOMAIN"
+    ]
+  },
   "uiHints": {
     "provider": {
       "label": "Provider",
@@ -23,6 +45,11 @@
       "label": "Inbound Greeting",
       "advanced": true
     },
+    "numbers": {
+      "label": "Per-number Routing",
+      "help": "Inbound overrides keyed by dialed E.164 number.",
+      "advanced": true
+    },
     "telnyx.apiKey": {
       "label": "Telnyx API Key",
       "sensitive": true
@@ -86,52 +113,73 @@
       "label": "Enable Streaming",
       "advanced": true
     },
-    "streaming.openaiApiKey": {
-      "label": "OpenAI Realtime API Key",
-      "sensitive": true,
+    "streaming.provider": {
+      "label": "Streaming Provider",
+      "help": "Uses the first registered realtime transcription provider when unset.",
       "advanced": true
     },
-    "streaming.sttModel": {
-      "label": "Realtime STT Model",
+    "streaming.providers": {
+      "label": "Streaming Provider Config",
       "advanced": true
     },
     "streaming.streamPath": {
       "label": "Media Stream Path",
       "advanced": true
     },
-    "tts.provider": {
-      "label": "TTS Provider Override",
-      "help": "Deep-merges with messages.tts (Edge is ignored for calls).",
+    "realtime.enabled": {
+      "label": "Enable Realtime Voice",
       "advanced": true
     },
-    "tts.openai.model": {
-      "label": "OpenAI TTS Model",
+    "realtime.provider": {
+      "label": "Realtime Voice Provider",
+      "help": "Uses the first registered realtime voice provider when unset.",
       "advanced": true
     },
-    "tts.openai.voice": {
-      "label": "OpenAI TTS Voice",
+    "realtime.streamPath": {
+      "label": "Realtime Stream Path",
       "advanced": true
     },
-    "tts.openai.apiKey": {
-      "label": "OpenAI API Key",
-      "sensitive": true,
+    "realtime.instructions": {
+      "label": "Realtime Instructions",
       "advanced": true
     },
-    "tts.elevenlabs.modelId": {
-      "label": "ElevenLabs Model ID",
+    "realtime.toolPolicy": {
+      "label": "Realtime Tool Policy",
+      "help": "Controls the shared openclaw_agent_consult tool.",
       "advanced": true
     },
-    "tts.elevenlabs.voiceId": {
-      "label": "ElevenLabs Voice ID",
+    "realtime.fastContext.enabled": {
+      "label": "Enable Fast Realtime Context",
+      "help": "Searches memory/session context before the full consult agent.",
       "advanced": true
     },
-    "tts.elevenlabs.apiKey": {
-      "label": "ElevenLabs API Key",
-      "sensitive": true,
+    "realtime.fastContext.timeoutMs": {
+      "label": "Fast Context Timeout",
+      "advanced": true
+    },
+    "realtime.fastContext.maxResults": {
+      "label": "Fast Context Result Limit",
       "advanced": true
     },
-    "tts.elevenlabs.baseUrl": {
-      "label": "ElevenLabs Base URL",
+    "realtime.fastContext.sources": {
+      "label": "Fast Context Sources",
+      "advanced": true
+    },
+    "realtime.fastContext.fallbackToConsult": {
+      "label": "Fallback To Full Consult",
+      "advanced": true
+    },
+    "realtime.providers": {
+      "label": "Realtime Provider Config",
+      "advanced": true
+    },
+    "tts.provider": {
+      "label": "TTS Provider Override",
+      "help": "Deep-merges with messages.tts (Microsoft is ignored for calls).",
+      "advanced": true
+    },
+    "tts.providers": {
+      "label": "TTS Provider Config",
       "advanced": true
     },
     "publicUrl": {
@@ -146,8 +194,13 @@
       "label": "Call Log Store Path",
       "advanced": true
     },
+    "sessionScope": {
+      "label": "Session Scope",
+      "help": "Use per-phone to preserve caller memory across calls, or per-call to isolate every call into a fresh voice session."
+    },
     "responseModel": {
       "label": "Response Model",
+      "help": "Optional override. Falls back to the runtime default model when unset.",
       "advanced": true
     },
     "responseSystemPrompt": {
@@ -193,7 +246,7 @@
             "type": "string"
           },
           "authToken": {
-            "type": "string"
+            "type": ["string", "object"]
           }
         }
       },
@@ -231,6 +284,38 @@
       "inboundGreeting": {
         "type": "string"
       },
+      "numbers": {
+        "type": "object",
+        "propertyNames": {
+          "pattern": "^\\+[1-9]\\d{1,14}$"
+        },
+        "additionalProperties": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "inboundGreeting": {
+              "type": "string"
+            },
+            "tts": {
+              "$ref": "#/properties/tts"
+            },
+            "agentId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "responseModel": {
+              "type": "string"
+            },
+            "responseSystemPrompt": {
+              "type": "string"
+            },
+            "responseTimeoutMs": {
+              "type": "integer",
+              "minimum": 1
+            }
+          }
+        }
+      },
       "outbound": {
         "type": "object",
         "additionalProperties": false,
@@ -345,28 +430,19 @@
           "enabled": {
             "type": "boolean"
           },
-          "sttProvider": {
-            "type": "string",
-            "enum": ["openai-realtime"]
-          },
-          "openaiApiKey": {
-            "type": "string"
-          },
-          "sttModel": {
+          "provider": {
             "type": "string"
           },
-          "silenceDurationMs": {
-            "type": "integer",
-            "minimum": 1
-          },
-          "vadThreshold": {
-            "type": "number",
-            "minimum": 0,
-            "maximum": 1
-          },
           "streamPath": {
             "type": "string"
           },
+          "providers": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object",
+              "additionalProperties": true
+            }
+          },
           "preStartTimeoutMs": {
             "type": "integer",
             "minimum": 1
@@ -385,25 +461,110 @@
           }
         }
       },
-      "publicUrl": {
-        "type": "string"
-      },
-      "skipSignatureVerification": {
-        "type": "boolean"
-      },
-      "stt": {
+      "realtime": {
         "type": "object",
         "additionalProperties": false,
         "properties": {
+          "enabled": {
+            "type": "boolean"
+          },
           "provider": {
-            "type": "string",
-            "enum": ["openai"]
+            "type": "string"
+          },
+          "streamPath": {
+            "type": "string"
           },
-          "model": {
+          "instructions": {
             "type": "string"
+          },
+          "toolPolicy": {
+            "type": "string",
+            "enum": ["safe-read-only", "owner", "none"]
+          },
+          "tools": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "enum": ["function"]
+                },
+                "name": {
+                  "type": "string"
+                },
+                "description": {
+                  "type": "string"
+                },
+                "parameters": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "enum": ["object"]
+                    },
+                    "properties": {
+                      "type": "object",
+                      "additionalProperties": true
+                    },
+                    "required": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": ["type", "properties"]
+                }
+              },
+              "required": ["type", "name", "description", "parameters"]
+            }
+          },
+          "fastContext": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "enabled": {
+                "type": "boolean"
+              },
+              "timeoutMs": {
+                "type": "number",
+                "minimum": 1
+              },
+              "maxResults": {
+                "type": "number",
+                "minimum": 1
+              },
+              "sources": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": "string",
+                  "enum": ["memory", "sessions"]
+                }
+              },
+              "fallbackToConsult": {
+                "type": "boolean"
+              }
+            }
+          },
+          "providers": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object",
+              "additionalProperties": true
+            }
           }
         }
       },
+      "publicUrl": {
+        "type": "string"
+      },
+      "skipSignatureVerification": {
+        "type": "boolean"
+      },
       "tts": {
         "type": "object",
         "additionalProperties": false,
@@ -420,8 +581,7 @@
             "enum": ["final", "all"]
           },
           "provider": {
-            "type": "string",
-            "enum": ["openai", "elevenlabs", "edge"]
+            "type": "string"
           },
           "summaryModel": {
             "type": "string"
@@ -456,127 +616,179 @@
               }
             }
           },
-          "elevenlabs": {
+          "providers": {
             "type": "object",
-            "additionalProperties": false,
             "properties": {
-              "apiKey": {
-                "type": "string"
-              },
-              "baseUrl": {
-                "type": "string"
-              },
-              "voiceId": {
-                "type": "string"
-              },
-              "modelId": {
-                "type": "string"
-              },
-              "seed": {
-                "type": "integer",
-                "minimum": 0,
-                "maximum": 4294967295
-              },
-              "applyTextNormalization": {
-                "type": "string",
-                "enum": ["auto", "on", "off"]
-              },
-              "languageCode": {
-                "type": "string"
-              },
-              "voiceSettings": {
+              "openai": {
                 "type": "object",
                 "additionalProperties": false,
                 "properties": {
-                  "stability": {
-                    "type": "number",
-                    "minimum": 0,
-                    "maximum": 1
+                  "apiKey": {
+                    "type": ["string", "object"]
                   },
-                  "similarityBoost": {
-                    "type": "number",
-                    "minimum": 0,
-                    "maximum": 1
+                  "baseUrl": {
+                    "type": "string"
                   },
-                  "style": {
-                    "type": "number",
-                    "minimum": 0,
-                    "maximum": 1
+                  "model": {
+                    "type": "string"
                   },
-                  "useSpeakerBoost": {
-                    "type": "boolean"
+                  "voice": {
+                    "type": "string"
                   },
                   "speed": {
                     "type": "number",
-                    "minimum": 0.5,
-                    "maximum": 2
+                    "minimum": 0.25,
+                    "maximum": 4.0
+                  },
+                  "instructions": {
+                    "type": "string"
                   }
                 }
-              }
-            }
-          },
-          "openai": {
-            "type": "object",
-            "additionalProperties": false,
-            "properties": {
-              "apiKey": {
-                "type": "string"
-              },
-              "baseUrl": {
-                "type": "string"
               },
-              "model": {
-                "type": "string"
-              },
-              "voice": {
-                "type": "string"
+              "elevenlabs": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "apiKey": {
+                    "type": ["string", "object"]
+                  },
+                  "baseUrl": {
+                    "type": "string"
+                  },
+                  "voiceId": {
+                    "type": "string"
+                  },
+                  "modelId": {
+                    "type": "string"
+                  },
+                  "seed": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 4294967295
+                  },
+                  "applyTextNormalization": {
+                    "type": "string",
+                    "enum": ["auto", "on", "off"]
+                  },
+                  "languageCode": {
+                    "type": "string"
+                  },
+                  "voiceSettings": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "stability": {
+                        "type": "number",
+                        "minimum": 0,
+                        "maximum": 1
+                      },
+                      "similarityBoost": {
+                        "type": "number",
+                        "minimum": 0,
+                        "maximum": 1
+                      },
+                      "style": {
+                        "type": "number",
+                        "minimum": 0,
+                        "maximum": 1
+                      },
+                      "useSpeakerBoost": {
+                        "type": "boolean"
+                      },
+                      "speed": {
+                        "type": "number",
+                        "minimum": 0.5,
+                        "maximum": 2
+                      }
+                    }
+                  }
+                }
               },
-              "speed": {
-                "type": "number",
-                "minimum": 0.25,
-                "maximum": 4.0
+              "microsoft": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "enabled": {
+                    "type": "boolean"
+                  },
+                  "voice": {
+                    "type": "string"
+                  },
+                  "lang": {
+                    "type": "string"
+                  },
+                  "outputFormat": {
+                    "type": "string"
+                  },
+                  "pitch": {
+                    "type": "string"
+                  },
+                  "rate": {
+                    "type": "string"
+                  },
+                  "volume": {
+                    "type": "string"
+                  },
+                  "saveSubtitles": {
+                    "type": "boolean"
+                  },
+                  "proxy": {
+                    "type": "string"
+                  },
+                  "timeoutMs": {
+                    "type": "integer",
+                    "minimum": 1000,
+                    "maximum": 120000
+                  }
+                }
               },
-              "instructions": {
-                "type": "string"
+              "edge": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "enabled": {
+                    "type": "boolean"
+                  },
+                  "voice": {
+                    "type": "string"
+                  },
+                  "lang": {
+                    "type": "string"
+                  },
+                  "outputFormat": {
+                    "type": "string"
+                  },
+                  "pitch": {
+                    "type": "string"
+                  },
+                  "rate": {
+                    "type": "string"
+                  },
+                  "volume": {
+                    "type": "string"
+                  },
+                  "saveSubtitles": {
+                    "type": "boolean"
+                  },
+                  "proxy": {
+                    "type": "string"
+                  },
+                  "timeoutMs": {
+                    "type": "integer",
+                    "minimum": 1000,
+                    "maximum": 120000
+                  }
+                }
               }
-            }
-          },
-          "edge": {
-            "type": "object",
-            "additionalProperties": false,
-            "properties": {
-              "enabled": {
-                "type": "boolean"
-              },
-              "voice": {
-                "type": "string"
-              },
-              "lang": {
-                "type": "string"
-              },
-              "outputFormat": {
-                "type": "string"
-              },
-              "pitch": {
-                "type": "string"
-              },
-              "rate": {
-                "type": "string"
-              },
-              "volume": {
-                "type": "string"
-              },
-              "saveSubtitles": {
-                "type": "boolean"
-              },
-              "proxy": {
-                "type": "string"
+            },
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "apiKey": {
+                  "type": ["string", "object"]
+                }
               },
-              "timeoutMs": {
-                "type": "integer",
-                "minimum": 1000,
-                "maximum": 120000
-              }
+              "additionalProperties": true
             }
           },
           "prefsPath": {
@@ -596,6 +808,10 @@
       "store": {
         "type": "string"
       },
+      "sessionScope": {
+        "type": "string",
+        "enum": ["per-phone", "per-call"]
+      },
       "responseModel": {
         "type": "string"
       },
@@ -607,5 +823,16 @@
         "minimum": 1
       }
     }
+  },
+  "configContracts": {
+    "compatibilityMigrationPaths": ["plugins.entries.voice-call.config"],
+    "secretInputs": {
+      "paths": [
+        { "path": "twilio.authToken", "expected": "string" },
+        { "path": "realtime.providers.*.apiKey", "expected": "string" },
+        { "path": "streaming.providers.*.apiKey", "expected": "string" },
+        { "path": "tts.providers.*.apiKey", "expected": "string" }
+      ]
+    }
   }
 }