openclaw/docs/cli/voicecall.md

summary, read_when, title

summary	read_when	title
CLI reference for `openclaw voicecall` (voice-call plugin command surface)	You use the voice-call plugin and want the CLI entry points You want quick examples for `voicecall setup|smoke|call|continue|dtmf|status|tail|expose`	Voicecall

openclaw voicecall

voicecall is a plugin-provided command. It only appears if the voice-call plugin is installed and enabled.

Primary doc:

• Voice-call plugin: Voice Call

Common commands

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?"
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:

openclaw voicecall setup --json

For external providers (twilio, telnyx, plivo), setup must resolve a public webhook URL from publicUrl, a tunnel, or Tailscale exposure. A loopback/private serve fallback is rejected because carriers cannot reach it.

smoke runs the same readiness checks. It will not place a real phone call unless both --to and --yes are present:

openclaw voicecall smoke --to "+15555550123"        # dry run
openclaw voicecall smoke --to "+15555550123" --yes  # live notify call

Exposing webhooks (Tailscale)

openclaw voicecall expose --mode serve
openclaw voicecall expose --mode funnel
openclaw voicecall expose --mode off

Security note: only expose the webhook endpoint to networks you trust. Prefer Tailscale Serve over Funnel when possible.

Related

• CLI reference
• Voice call plugin