# Send RingBot to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ringbot",
    "name": "RingBot",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/gbessoni/ringbot",
    "canonicalUrl": "https://clawhub.ai/gbessoni/ringbot",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/ringbot",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ringbot",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "ringbot",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T11:42:59.431Z",
      "expiresAt": "2026-05-10T11:42:59.431Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ringbot",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ringbot",
        "contentDisposition": "attachment; filename=\"ringbot-1.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "ringbot"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/ringbot"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/ringbot",
    "downloadUrl": "https://openagent3.xyz/downloads/ringbot",
    "agentUrl": "https://openagent3.xyz/skills/ringbot/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ringbot/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ringbot/agent.md"
  }
}
```
## Documentation

### RingBot - AI Phone Calls

Make outbound phone calls with an AI voice agent that can have natural conversations.

### 💰 Why RingBot? (99% Cheaper Voice AI)

Traditional Voice AI costs: $0.10-0.50/minute (ElevenLabs, PlayHT, etc.)
RingBot costs: ~$0.01/minute (just Twilio phone costs!)

ComponentProviderCostSTT (Speech-to-Text)Groq WhisperFREELLM (AI Brain)Groq Llama 3.3 70BFREETTS (Text-to-Speech)Groq OrpheusFREEVoice InfrastructureLiveKit CloudFREE tierPhone CallsTwilio~$0.01/min

You only pay for actual phone minutes through Twilio.

### Option 1: DIY (Free - Bring Your Own Keys)

Set up your own infrastructure - completely free except Twilio phone costs.

Required accounts:

Twilio - https://twilio.com

Phone number ($1/month) + calls ($0.01/min)
Get: TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_PHONE_NUMBER



LiveKit Cloud - https://cloud.livekit.io (free tier)

Create project + SIP trunk connected to Twilio
Get: LIVEKIT_URL, LIVEKIT_API_KEY, LIVEKIT_API_SECRET, LIVEKIT_SIP_TRUNK_ID



Groq - https://console.groq.com (100% free)

Get API key + accept TTS terms: https://console.groq.com/playground?model=canopylabs%2Forpheus-v1-english
Get: GROQ_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_key

### Option 2: Hosted (Paid - Just Bring Twilio)

Don't want to set up LiveKit and Groq? Use our hosted infrastructure.

✅ No LiveKit setup needed
✅ No Groq setup needed
✅ Just connect your Twilio account
💰 Pay per minute + rate limits apply

Coming soon - Contact for early access: https://talkforceai.com

### 1. Order Food by Phone

"Call DeLuca's Pizza and order a large pepperoni for pickup under Greg"

### 2. Make Reservations

"Call the restaurant and make a reservation for 4 people Saturday at 7pm"

### 3. Schedule Appointments

"Call Dr. Smith's office and schedule my annual checkup for next week morning"

### 4. Customer Service Calls

"Call Comcast and ask about upgrading my internet plan"

### 5. Personal Messages

"Call mom and tell her I love her and ask how her day was"

### 6. Business Lead Qualification

"Call this list of leads and ask if they're interested in our parking solutions"

### 7. Automated Daily Calls

"Every morning at 9am, call the warehouse and check inventory status"

### 8. Appointment Reminders

"Call patients and remind them of their appointments tomorrow"

### Making a Call

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 collect

### Example: Order Pizza

Step 1: Find the restaurant

goplaces search "pizza" --lat 41.36 --lng="-72.56" --limit 3

Step 2: Get phone number

goplaces details ChIJRdQwYs4v5okRY2gp8pgskJ0
# Phone: (860) 663-3999

Step 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."
  }'

### Tips for Good Results

Purpose - Keep it to one clear sentence:

✅ "Order a pizza for pickup"
✅ "Schedule a dental cleaning"
❌ "Call them and maybe order something or ask questions"

Context - Be specific:

Customer/caller name
Exact order or request
Preferences and constraints
What info to collect back

### Service Management

Start the agent:

cd /path/to/ringbot/src && python agent.py start

Start the API:

cd /path/to/ringbot && python main.py

Check call status:

curl http://localhost:8000/ringbot/call/{call_id}
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: gbessoni
- Version: 1.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T11:42:59.431Z
- Expires at: 2026-05-10T11:42:59.431Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/ringbot)
- [Send to Agent page](https://openagent3.xyz/skills/ringbot/agent)
- [JSON manifest](https://openagent3.xyz/skills/ringbot/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/ringbot/agent.md)
- [Download page](https://openagent3.xyz/downloads/ringbot)