# Send Phone Caller 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": "phone-caller",
    "name": "Phone Caller",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/omerflo/phone-caller",
    "canonicalUrl": "https://clawhub.ai/omerflo/phone-caller",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/phone-caller",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=phone-caller",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/voices.md",
      "scripts/interactive_call.py",
      "scripts/one_way_call.py",
      "scripts/server.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "phone-caller",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T01:17:58.438Z",
      "expiresAt": "2026-05-08T01:17:58.438Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=phone-caller",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=phone-caller",
        "contentDisposition": "attachment; filename=\"phone-caller-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "phone-caller"
      },
      "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/phone-caller"
    },
    "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/phone-caller",
    "downloadUrl": "https://openagent3.xyz/downloads/phone-caller",
    "agentUrl": "https://openagent3.xyz/skills/phone-caller/agent",
    "manifestUrl": "https://openagent3.xyz/skills/phone-caller/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/phone-caller/agent.md"
  }
}
```
## Documentation

### phone-caller

Make AI-powered outbound calls via Twilio, voiced by ElevenLabs, with optional live GPT-powered conversation.

### Two Modes

Mode 1: One-way message — Generate audio with ElevenLabs, upload it, play it on a Twilio call. Simple, fast, no server needed.

Mode 2: Interactive conversation — Start server.py, call with a webhook URL. The AI listens to responses (Twilio STT), thinks (GPT), and speaks back (ElevenLabs) in real-time. Ends with auto-summary sent via iMessage.

### Required Credentials (env vars)

ELEVENLABS_API_KEY   # from elevenlabs.io
TWILIO_ACCOUNT_SID   # from console.twilio.com (starts with AC...)
TWILIO_AUTH_TOKEN    # from console.twilio.com
TWILIO_PHONE_NUMBER  # your Twilio number e.g. +12025551234
OPENAI_API_KEY       # for interactive mode brain

### Mode 1: One-way Call

python3 scripts/one_way_call.py \\
  --to "+13105551234" \\
  --text "Hey! Just calling to say good morning." \\
  --voice "tyepWYJJwJM9TTFIg5U7"   # optional, defaults to Clara (Australian female)

See references/voices.md for curated voice IDs.

### Step 1 — Start a tunnel (needed so Twilio can reach your server)

npx localtunnel --port 5050 --subdomain my-caller
# Note the URL: https://my-caller.loca.lt

### Step 2 — Start the server

export CLARA_PUBLIC_URL="https://my-caller.loca.lt"
python3 scripts/server.py

### Step 3 — Make the call

python3 scripts/interactive_call.py \\
  --to "+13105551234" \\
  --url "https://my-caller.loca.lt" \\
  --persona "You are calling a restaurant to book a table for 2 at 8pm tonight." \\
  --opening "Hi! I'd like to make a reservation for two people this evening around 8pm. Do you have availability?"

When the call ends, a GPT-generated summary is automatically sent via iMessage to MASTER_PHONE env var.

### Scheduling a Call

Use macOS cron for timed calls:

# Add to crontab — this example calls at 8:45 AM
crontab -e
45 8 24 2 * python3 /path/to/scripts/one_way_call.py --to "+1..." --text "Good morning!" >> /tmp/call.log 2>&1

### Voice Selection

Default: Clara tyepWYJJwJM9TTFIg5U7 — Australian female, warm, clear, professional
See references/voices.md for full curated list with IDs and descriptions

### Key Notes

Twilio trial accounts: Can only call verified numbers. Upgrade or verify numbers at console.twilio.com → Verified Caller IDs
Audio hosting: Scripts use tmpfiles.org for one-off calls (60 min TTL). For scheduled calls, server.py serves audio at /audio/<file> via the tunnel
localtunnel: Free, no account needed. ngrok requires a free account + authtoken
Interactive mode latency: ~3-5s per turn (ElevenLabs TTS + GPT + audio upload). Normal for phone conversations
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: omerflo
- Version: 1.0.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-01T01:17:58.438Z
- Expires at: 2026-05-08T01:17:58.438Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/phone-caller)
- [Send to Agent page](https://openagent3.xyz/skills/phone-caller/agent)
- [JSON manifest](https://openagent3.xyz/skills/phone-caller/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/phone-caller/agent.md)
- [Download page](https://openagent3.xyz/downloads/phone-caller)