📞

AI Agent 自主代理三王實戰

CH20 | 讓龍蝦打電話給你

給龍蝦一個電話號碼,讓它能接打電話——開車問事情、長輩不會打字、語音客服,通通搞定

📋 本章學習目標

  • 認識 Twilio 的功能和費用
  • 學會申請 Twilio 帳號和電話號碼
  • 設定龍蝦接聽語音通話
  • 了解語音通話的實際應用場景
1 / 12

為什麼要讓龍蝦接電話?

到目前為止,你跟龍蝦的互動都是靠「文字」。但你有沒有想過,直接打電話給龍蝦

🚗 開車族

開車時不方便打字,直接打電話問龍蝦事情,安全又方便

👴 長輩友善

長輩不會用 LINE 打字,但他們很會打電話——電話就是最好的介面

📱 外出查資料

在外面需要龍蝦幫你查資料,拿起手機撥個號碼就搞定

🏪 語音客服

做小生意的人,用龍蝦接聽客戶來電,自動回答問題

💡 這就是 OpenClaw 的 Twilio 語音通話功能——給龍蝦一個電話號碼,讓它能接打電話。
2 / 12

20.1 Twilio 是什麼?

Twilio 是全球最大的「通訊平台即服務」(CPaaS)公司。它讓開發者透過 API 來打電話、傳簡訊。你不需要了解電話系統底層技術——Twilio 都幫你包好了。

Twilio Console

Twilio 能做什麼

功能說明
接聽電話給龍蝦一個電話號碼,使用者打來龍蝦自動接聽
撥打電話龍蝦主動撥打電話給指定號碼
語音辨識來電者說的話,即時轉成文字給龍蝦
語音合成龍蝦的文字回覆,用語音唸出來給來電者聽
簡訊龍蝦也可以收發 SMS 簡訊
3 / 12

20.1.3 Twilio 費用說明

Twilio 不是免費的——它是商業服務。但費用比你想像的低:

項目費用(美元)說明
電話號碼$1.15/月美國號碼月租費
接聽電話$0.0085/分鐘每分鐘不到 0.3 台幣
語音辨識$0.02/15 秒Twilio 內建的 STT
語音合成免費~$0.01/句看你用哪種 TTS
撥打電話$0.014/分鐘撥打美國號碼
免費試用:Twilio 新帳號有免費額度(約 $15),足夠你測試和學習。你不需要一開始就花錢。
💰 月費估算範例:假設每天接 5 通、每通 3 分鐘,月費約 $8.4 美元(≈ 270 台幣)。可在 Twilio Console 隨時查看帳單。
⚠️ 台灣號碼也有,但月租費較高(約 $11/月)。如果只是學習和測試,用美國號碼就夠了。
4 / 12

20.2 申請 Twilio 帳號

註冊步驟

  1. https://www.twilio.com/try-twilio 註冊
  2. 填寫 Email、密碼
  3. 驗證手機號碼(台灣的 +886 號碼可以用)
  4. 回答幾個問題(選「Voice」和「With code」)
  5. 完成註冊,進入 Console

取得 Account SID 和 Auth Token

在 Twilio Console 首頁就能看到兩個重要的值:

Account SID:AC1234567890abcdef...
Auth Token:(點擊眼睛圖示顯示)
⚠️ Auth Token 是密碼等級的敏感資訊,不要分享給任何人,不要放到 GitHub 上。

購買電話號碼

購買電話號碼
  1. 在 Console 左側選單點 Phone Numbers → Manage → Buy a number
  2. 選擇國家(建議選美國 United States,最便宜)
  3. 勾選「Voice」能力
  4. 選一個你喜歡的號碼,按 Buy
  5. 試用帳號免費買一個號碼
⚠️ 試用帳號限制
• 只能撥打已驗證的號碼(見下方驗證步驟)
• 每通電話接通時會先播放英文語音浮水印(升級付費帳號後消失)
• 免費 $15 額度用完後需儲值

驗證你的手機號碼(試用帳號必做)

  1. Phone Numbers → Manage → Verified Caller IDs
  2. Add a new Caller ID
  3. 輸入手機號碼(台灣格式:+886912345678,去掉開頭 0)
  4. Call meText me 驗證
  5. 輸入驗證碼,完成!
💡 註冊時用的手機號碼會自動驗證,用同一支手機測試通常不需額外操作。
5 / 12

20.3 設定龍蝦接聽語音通話

安裝 Twilio 外掛

openclaw plugins install twilio-voice
💡 openclaw plugins install 是安裝系統外掛(plugin),跟 CH15 的 clawdhub install 安裝社群技能(skill)是不同層級的東西。

設定認證資訊(擇一即可)

## Twilio(語音通話)
- Account SID: 你的_Account_SID
- Auth Token: 你的_Auth_Token
- 電話號碼: +1xxxxxxxxxx(你買的號碼)
- 語音語言: zh-TW(中文)
- TTS 引擎: google(Google 語音合成)

設定 Webhook

Twilio Webhook 設定

Webhook URL 取得方式(擇一):

  • Cloudflare Tunnel(CH12)https://lobster.你的域名.com/twilio/voice
  • ngrok(還沒做 CH12 的人):執行 ngrok http 18789,URL 為 https://xxxx.ngrok.io/twilio/voice

到 Twilio Console 設定:

  1. 進入 Phone Numbers → Manage → Active numbers
  2. 點擊你的號碼
  3. Voice Configuration 區塊:
    • A call comes in → Webhook
    • URL 填入你的 Webhook URL
    • 方法選 POST
  4. Save configuration
openclaw gateway restart    # 重啟 Gateway
6 / 12

打不通?除錯清單

如果測試通話失敗,請依序檢查:

#檢查項目操作方式
1Gateway 有在跑嗎?openclaw gateway status 應顯示 Running
2Webhook URL 正確嗎?在 Twilio Console 檢查,結尾要是 /twilio/voice
3ngrok / Tunnel 有在跑嗎?確認終端機還開著、URL 還有效
4Twilio 有錯誤紀錄嗎?Monitor → Logs → Errors 查看
5手機號碼已驗證嗎?試用帳號需先在 Verified Caller IDs 驗證
6聽到英文語音提示?這是試用帳號正常現象,不是錯誤
7接通但沒聲音?檢查 TOOLS.md 的 TTS 引擎設定和 API Key
✅ 大部分問題都是 Webhook URL 填錯或 Gateway 沒啟動造成的,修正後重試即可。
7 / 12

20.4 語音通話的運作原理

通話流程圖

通話流程

1. 你撥打 Twilio 號碼
2. Twilio 接聽,通知 OpenClaw(透過 Webhook)
3. OpenClaw 送出歡迎語(TTS 語音合成 → 播放給你聽)
4. 你開始說話
5. Twilio 即時語音辨識(STT),把你的話轉成文字
6. OpenClaw 把文字送給 AI 模型處理
7. AI 產生回覆文字
8. TTS 把回覆轉成語音,播放給你聽
9. 重複 4-8 直到掛斷
💡 整個過程的延遲大約 1-3 秒——你說完話後,龍蝦需要一兩秒才會回答。比打字聊天稍微慢一點,但完全可以接受。
8 / 12

語音辨識(STT)與語音合成(TTS)

語音辨識(STT)引擎

引擎中文支援準確度費用
Twilio 內建✅ zh-TW中等包含在通話費裡
Google STT✅ zh-TW額外計費
Deepgram✅(有限)額外計費

語音合成(TTS)引擎

引擎中文音質自然度費用
Twilio 內建一般★★☆☆免費
Google TTS★★★☆
ElevenLabs很好★★★★
OpenAI TTS很好★★★★
💡 建議先用 Twilio 內建的 STT/TTS,夠用了。如果覺得音質不夠好再升級到 ElevenLabs 或 OpenAI TTS。
🔑 ElevenLabs API Key:到 elevenlabs.io 免費註冊,每月 10,000 字元免費額度。詳見附錄 E
🎤 不只是通話! OpenClaw 還有獨立的 tts 技能(SAG),不需要 Twilio 也能在 LINE/Telegram 聊天中回覆語音訊息。安裝:clawdhub install tts,詳見 CH15 §15.2.4。
9 / 12

20.5 實際應用場景

語音通話聊天

🎙️ 個人語音助手

打電話問行程、改行程、查資料。「幫我查一下明天下午有什麼行程?」「把四點半的改到五點。」

👴 長輩友善介面

阿公打電話問天氣:「明天要不要帶傘?」龍蝦:「明天台中 22 度,有小雨喔,出門記得帶傘。」

🏪 語音客服機器人

客戶打來問營業時間、訂位。龍蝦自動回答、幫忙預約,不用你親自接電話。

⏰ 電話提醒

搭配 HEARTBEAT.md,龍蝦每天早上八點打電話報行程和天氣:「早安!今天有一個行程:下午 2 點看牙醫。」

10 / 12

20.6 進階設定與常見問題

進階設定

🎙️ 通話錄音

自動錄音方便回顧,設定保留天數,儲存到 workspace/data/recordings/

⚠️ 台灣《通訊保障及監察法》:錄音需事前告知對方,建議在歡迎語加入提示

🚫 來電黑名單

避免騷擾電話。可設黑名單或白名單模式(只接白名單電話)

⏱️ 通話時長限制

避免意外高額費用。最長 10 分鐘、每日上限 30 分鐘

常見問題

問題回答
台灣手機可以打美國號碼嗎?可以,但有國際通話費。建議用 LINE Out 或其他 VoIP 撥打更便宜
語音辨識聽不懂台灣國語?設定 zh-TW,說慢一點、安靜環境,或升級 Google STT
通話中可以操作電腦嗎?可以!搭配 Desktop Agent(CH18),語音指令操作電腦
可以多人同時打嗎?可以,每通電話獨立對話、獨立計費
有其他選擇嗎?目前官方支援 Twilio,社群開發中 SIP/WebRTC 方案
11 / 12

20.8 小結與展望

這一章讓你的龍蝦學會了「說話」!

🔑 Twilio 帳號

註冊、取得 SID/Token、購買電話號碼

🔧 語音通話設定

安裝外掛、設定 Webhook、測試通話

⚙️ 通話原理

STT 語音辨識 + AI 處理 + TTS 語音合成

🌟 實際應用

個人助手、長輩友善、客服機器人、電話提醒

你的龍蝦現在是一個真正的全方位 AI 助手——能打字聊天、能看圖片、能操控電腦、能打電話。

📖 下一章預告:CH21 全自動 AI 管家——排程與事件驅動
教你打造一隻全自動的龍蝦——不用你開口,它就會主動幫你做事。每天自動報天氣、到時間自動提醒行程、收到特定訊息自動處理!

前往 CH21 ➡️
12 / 12