ringbotMake outbound AI phone calls. Use when asked to call a business, make a phone call, order food by phone, schedule appointments, or any task requiring voice calls. Triggers on "call", "phone", "dial", "ring", "order pizza", "make reservation", "schedule appointment".
Install via ClawdBot CLI:
clawdbot install gbessoni/ringbotMake outbound phone calls with an AI voice agent that can have natural conversations.
Traditional Voice AI costs: $0.10-0.50/minute (ElevenLabs, PlayHT, etc.)
RingBot costs: ~$0.01/minute (just Twilio phone costs!)
| Component | Provider | Cost |
|-----------|----------|------|
| STT (Speech-to-Text) | Groq Whisper | FREE |
| LLM (AI Brain) | Groq Llama 3.3 70B | FREE |
| TTS (Text-to-Speech) | Groq Orpheus | FREE |
| Voice Infrastructure | LiveKit Cloud | FREE tier |
| Phone Calls | Twilio | ~$0.01/min |
You only pay for actual phone minutes through Twilio.
Set up your own infrastructure - completely free except Twilio phone costs.
Required accounts:
TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_PHONE_NUMBERLIVEKIT_URL, LIVEKIT_API_KEY, LIVEKIT_API_SECRET, LIVEKIT_SIP_TRUNK_IDGROQ_API_KEY# .env for DIY setup
TWILIO_ACCOUNT_SID=your_sid
TWILIO_AUTH_TOKEN=your_token
TWILIO_PHONE_NUMBER=+1234567890
LIVEKIT_URL=wss://your-project.livekit.cloud
LIVEKIT_API_KEY=your_key
LIVEKIT_API_SECRET=your_secret
LIVEKIT_SIP_TRUNK_ID=your_trunk_id
GROQ_API_KEY=your_groq_keyDon't want to set up LiveKit and Groq? Use our hosted infrastructure.
Coming soon - Contact for early access: https://talkforceai.com
"Call DeLuca's Pizza and order a large pepperoni for pickup under Greg"
"Call the restaurant and make a reservation for 4 people Saturday at 7pm"
"Call Dr. Smith's office and schedule my annual checkup for next week morning"
"Call Comcast and ask about upgrading my internet plan"
"Call mom and tell her I love her and ask how her day was"
"Call this list of leads and ask if they're interested in our parking solutions"
"Every morning at 9am, call the warehouse and check inventory status"
"Call patients and remind them of their appointments tomorrow"
curl -X POST http://localhost:8000/ringbot/call \
-H "Content-Type: application/json" \
-d '{
"to": "+1XXXXXXXXXX",
"purpose": "Brief description of call objective",
"context": "Additional context the AI should know"
}'Parameters:
to - Phone number in E.164 format (+1XXXXXXXXXX)purpose - What the call is about (guides AI behavior)context - Background info, specific requests, what to collectStep 1: Find the restaurant
goplaces search "pizza" --lat 41.36 --lng="-72.56" --limit 3Step 2: Get phone number
goplaces details ChIJRdQwYs4v5okRY2gp8pgskJ0
# Phone: (860) 663-3999Step 3: Make the call
curl -X POST http://localhost:8000/ringbot/call \
-H "Content-Type: application/json" \
-d '{
"to": "+18606633999",
"purpose": "Order a pizza for pickup",
"context": "Order: 1 large pepperoni pizza. Customer name: Greg. Ask for pickup time and total."
}'Purpose - Keep it to one clear sentence:
Context - Be specific:
Start the agent:
cd /path/to/ringbot/src && python agent.py startStart the API:
cd /path/to/ringbot && python main.pyCheck call status:
curl http://localhost:8000/ringbot/call/{call_id}Generated Mar 1, 2026
Automates phone orders for food pickup or delivery, handling menu inquiries and payment details. Ideal for busy individuals or businesses managing multiple orders.
Calls service providers like medical offices or salons to book appointments, reducing wait times and administrative overhead. Useful for personal assistants or healthcare coordinators.
Handles inquiries with companies for billing, upgrades, or troubleshooting, providing 24/7 support without human agents. Suitable for telecom or utility sectors.
Contacts potential business leads to gauge interest and collect contact info, streamlining sales pipelines. Effective for real estate or B2B marketing teams.
Makes automated calls for daily check-ins or appointment reminders, enhancing personal organization and caregiving. Helpful for families or small businesses.
Users provide their own API keys for free services like Groq and LiveKit, paying only for Twilio phone usage. This model offers maximum control and minimal recurring costs.
A paid subscription where the provider manages infrastructure, simplifying setup for users who only need to connect their Twilio account. Includes rate limits and per-minute charges.
Custom deployments for businesses requiring high-volume calls, with dedicated support and advanced features like analytics. Targets sectors like customer service or logistics.
💬 Integration Tip
Ensure all API keys are securely stored in environment variables and test the setup with a simple call before scaling to avoid service disruptions.
Transcribe audio via OpenAI Audio Transcriptions API (Whisper).
Local speech-to-text with the Whisper CLI (no API key).
ElevenLabs text-to-speech with mac-style say UX.
Text-to-speech conversion using node-edge-tts npm package for generating audio from text. Supports multiple voices, languages, speed adjustment, pitch control, and subtitle generation. Use when: (1) User requests audio/voice output with the "tts" trigger or keyword. (2) Content needs to be spoken rather than read (multitasking, accessibility, driving, cooking). (3) User wants a specific voice, speed, pitch, or format for TTS output.
End-to-end encrypted agent-to-agent private messaging via Moltbook dead drops. Use when agents need to communicate privately, exchange secrets, or coordinate without human visibility.
Text-to-speech via OpenAI Audio Speech API.