mirror of
https://github.com/openclaw/openclaw.git
synced 2026-05-06 19:50:43 +00:00
62 lines
1.8 KiB
Markdown
62 lines
1.8 KiB
Markdown
---
|
|
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 setup|smoke|call|continue|dtmf|status|tail|expose`
|
|
title: "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](/plugins/voice-call)
|
|
|
|
## 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?"
|
|
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
|
|
```
|
|
|
|
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:
|
|
|
|
```bash
|
|
openclaw voicecall smoke --to "+15555550123" # dry run
|
|
openclaw voicecall smoke --to "+15555550123" --yes # live notify call
|
|
```
|
|
|
|
## Exposing webhooks (Tailscale)
|
|
|
|
```bash
|
|
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](/cli)
|
|
- [Voice call plugin](/plugins/voice-call)
|