feat(voice-call): add setup smoke checks

docs/cli/voicecall.md

@@ -2,7 +2,7 @@
 summary: "CLI reference for `openclaw voicecall` (voice-call plugin command surface)"
 read_when:
   - You use the voice-call plugin and want the CLI entry points
-  - You want quick examples for `voicecall call|continue|dtmf|status|tail|expose`
+  - You want quick examples for `voicecall setup|smoke|call|continue|dtmf|status|tail|expose`
 title: "Voicecall"
 ---
 
@@ -17,6 +17,8 @@ Primary doc:
 ## Common commands
 
 ```bash
+openclaw voicecall setup
+openclaw voicecall smoke
 openclaw voicecall status --call-id <id>
 openclaw voicecall call --to "+15555550123" --message "Hello" --mode notify
 openclaw voicecall continue --call-id <id> --message "Any questions?"
@@ -24,6 +26,21 @@ openclaw voicecall dtmf --call-id <id> --digits "ww123456#"
 openclaw voicecall end --call-id <id>
 ```
 
+`setup` prints human-readable readiness checks by default. Use `--json` for
+scripts:
+
+```bash
+openclaw voicecall setup --json
+```
+
+`smoke` runs the same readiness checks. It will not place a real phone call
+unless both `--to` and `--yes` are present:
+
+```bash
+openclaw voicecall smoke --to "+15555550123"        # dry run
+openclaw voicecall smoke --to "+15555550123" --yes  # live notify call
+```
+
 ## Exposing webhooks (Tailscale)
 
 ```bash

docs/plugins/voice-call.md

@@ -141,6 +141,31 @@ Set config under `plugins.entries.voice-call.config`:
 }
 ```
 
+Check setup before testing with a real provider:
+
+```bash
+openclaw voicecall setup
+```
+
+The default output is readable in chat logs and terminal sessions. It checks
+whether the plugin is enabled, the provider and credentials are present, webhook
+exposure is configured, and only one audio mode is active. Use
+`openclaw voicecall setup --json` for scripts.
+
+For a no-surprises smoke test, run:
+
+```bash
+openclaw voicecall smoke
+openclaw voicecall smoke --to "+15555550123"
+```
+
+The second command is still a dry run. Add `--yes` to place a short outbound
+notify call:
+
+```bash
+openclaw voicecall smoke --to "+15555550123" --yes
+```
+
 Notes:
 
 - Twilio/Telnyx require a **publicly reachable** webhook URL.