From 828d9955f20f0a45bb78f1f9108970e6f5aee594 Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Mon, 12 Jan 2026 02:16:14 +0000 Subject: [PATCH] docs(voice-call): add Twilio setup guide --- docs/plugins/voice-call.md | 17 +++++++++++++++++ extensions/voice-call/README.md | 9 +++++++++ 2 files changed, 26 insertions(+) diff --git a/docs/plugins/voice-call.md b/docs/plugins/voice-call.md index c4a2cd264..e8e1727ef 100644 --- a/docs/plugins/voice-call.md +++ b/docs/plugins/voice-call.md @@ -28,6 +28,23 @@ The Voice Call plugin runs **inside the Gateway process**. If you use a remote Gateway, install/configure the plugin on the **machine running the Gateway**, then restart the Gateway to load it. +## Twilio setup (getting the credentials) + +You’ll need: +- **Account SID** (`AC...`) +- **Auth Token** (treat like a password) +- A Twilio **Voice-capable phone number** to use as `from` (E.164, like `+15551234567`) + +Steps: +1) Create/sign in to Twilio: `https://www.twilio.com/` +2) Open the Twilio Console: `https://console.twilio.com/` +3) Find your **Account SID** + **Auth Token** (typically on the Console dashboard / Account settings). +4) Buy (or select) a Twilio phone number with **Voice** capability: + - Console → Phone Numbers → Manage → Buy a number +5) (Trial accounts) You may need to verify the destination `to` numbers before Twilio allows outbound calling. + +Tip: keep `twilio.authToken` out of git; store it in `~/.clawdbot/clawdbot.json` or your Control UI config, not in repo files. + ## Install ### Option A: install from npm (recommended) diff --git a/extensions/voice-call/README.md b/extensions/voice-call/README.md index 32b7858e3..d67759610 100644 --- a/extensions/voice-call/README.md +++ b/extensions/voice-call/README.md @@ -62,6 +62,15 @@ Dev fallback (no network): { provider: "log" } ``` +## Twilio credentials (quick notes) + +You’ll need a Twilio account, your **Account SID**, your **Auth Token**, and a Twilio **Voice-capable** phone number to use as `from`. + +- Signup: `https://www.twilio.com/` +- Console: `https://console.twilio.com/` + +Full setup guide: `https://docs.clawd.bot/plugins/voice-call` + ## CLI ```bash