# openclaw voicecall

voicecall فرمانی است که توسط Plugin ارائه می‌شود. این فرمان فقط زمانی ظاهر می‌شود که Plugin تماس صوتی نصب و فعال باشد.

وقتی Gateway در حال اجرا باشد، فرمان‌های عملیاتی (call، start، continue، speak، dtmf، end و status) به runtime تماس صوتی همان Gateway ارسال می‌شوند. اگر هیچ Gateway در دسترس نباشد، به runtime مستقل CLI بازمی‌گردند.

سند اصلی:

• Plugin تماس صوتی: تماس صوتی

# فرمان‌های رایج

openclaw voicecall setup
openclaw voicecall smoke
openclaw voicecall status --json
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 به‌طور پیش‌فرض بررسی‌های آمادگی قابل‌خواندن برای انسان را چاپ می‌کند. برای اسکریپت‌ها از --json استفاده کنید:

openclaw voicecall setup --json

status به‌طور پیش‌فرض تماس‌های فعال را به‌صورت JSON چاپ می‌کند. برای بررسی یک تماس، --call-id <id> را بدهید.

برای ارائه‌دهندگان خارجی (twilio، telnyx، plivo)، راه‌اندازی باید یک URL عمومی Webhook را از publicUrl، یک تونل، یا درمعرض‌گذاری Tailscale تشخیص دهد. fallback سرویس‌دهی loopback/خصوصی رد می‌شود، چون اپراتورها نمی‌توانند به آن دسترسی داشته باشند.

smoke همان بررسی‌های آمادگی را اجرا می‌کند. مگر اینکه هر دو گزینه --to و --yes حاضر باشند، تماس تلفنی واقعی برقرار نمی‌کند:

openclaw voicecall smoke --to "+15555550123"        # اجرای خشک
openclaw voicecall smoke --to "+15555550123" --yes  # تماس اعلان زنده

# درمعرض‌گذاری Webhookها (Tailscale)

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

نکته امنیتی: endpoint مربوط به Webhook را فقط در معرض شبکه‌هایی قرار دهید که به آن‌ها اعتماد دارید. در صورت امکان Tailscale Serve را به Funnel ترجیح دهید.

# مرتبط

• مرجع CLI
• Plugin تماس صوتی