{ "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": { "downloadMode": "redirect", "downloadUrl": "/downloads/phone-caller", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=phone-caller", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "references/voices.md", "scripts/interactive_call.py", "scripts/one_way_call.py", "scripts/server.py" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "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." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/phone-caller", "agentPageUrl": "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" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "phone-caller", "body": "Make AI-powered outbound calls via Twilio, voiced by ElevenLabs, with optional live GPT-powered conversation." }, { "title": "Two Modes", "body": "Mode 1: One-way message — Generate audio with ElevenLabs, upload it, play it on a Twilio call. Simple, fast, no server needed.\n\nMode 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." }, { "title": "Required Credentials (env vars)", "body": "ELEVENLABS_API_KEY # from elevenlabs.io\nTWILIO_ACCOUNT_SID # from console.twilio.com (starts with AC...)\nTWILIO_AUTH_TOKEN # from console.twilio.com\nTWILIO_PHONE_NUMBER # your Twilio number e.g. +12025551234\nOPENAI_API_KEY # for interactive mode brain" }, { "title": "Mode 1: One-way Call", "body": "python3 scripts/one_way_call.py \\\n --to \"+13105551234\" \\\n --text \"Hey! Just calling to say good morning.\" \\\n --voice \"tyepWYJJwJM9TTFIg5U7\" # optional, defaults to Clara (Australian female)\n\nSee references/voices.md for curated voice IDs." }, { "title": "Step 1 — Start a tunnel (needed so Twilio can reach your server)", "body": "npx localtunnel --port 5050 --subdomain my-caller\n# Note the URL: https://my-caller.loca.lt" }, { "title": "Step 2 — Start the server", "body": "export CLARA_PUBLIC_URL=\"https://my-caller.loca.lt\"\npython3 scripts/server.py" }, { "title": "Step 3 — Make the call", "body": "python3 scripts/interactive_call.py \\\n --to \"+13105551234\" \\\n --url \"https://my-caller.loca.lt\" \\\n --persona \"You are calling a restaurant to book a table for 2 at 8pm tonight.\" \\\n --opening \"Hi! I'd like to make a reservation for two people this evening around 8pm. Do you have availability?\"\n\nWhen the call ends, a GPT-generated summary is automatically sent via iMessage to MASTER_PHONE env var." }, { "title": "Scheduling a Call", "body": "Use macOS cron for timed calls:\n\n# Add to crontab — this example calls at 8:45 AM\ncrontab -e\n45 8 24 2 * python3 /path/to/scripts/one_way_call.py --to \"+1...\" --text \"Good morning!\" >> /tmp/call.log 2>&1" }, { "title": "Voice Selection", "body": "Default: Clara tyepWYJJwJM9TTFIg5U7 — Australian female, warm, clear, professional\nSee references/voices.md for full curated list with IDs and descriptions" }, { "title": "Key Notes", "body": "Twilio trial accounts: Can only call verified numbers. Upgrade or verify numbers at console.twilio.com → Verified Caller IDs\nAudio hosting: Scripts use tmpfiles.org for one-off calls (60 min TTL). For scheduled calls, server.py serves audio at /audio/ via the tunnel\nlocaltunnel: Free, no account needed. ngrok requires a free account + authtoken\nInteractive mode latency: ~3-5s per turn (ElevenLabs TTS + GPT + audio upload). Normal for phone conversations" } ], "body": "phone-caller\n\nMake AI-powered outbound calls via Twilio, voiced by ElevenLabs, with optional live GPT-powered conversation.\n\nTwo Modes\n\nMode 1: One-way message — Generate audio with ElevenLabs, upload it, play it on a Twilio call. Simple, fast, no server needed.\n\nMode 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.\n\nRequired Credentials (env vars)\nELEVENLABS_API_KEY # from elevenlabs.io\nTWILIO_ACCOUNT_SID # from console.twilio.com (starts with AC...)\nTWILIO_AUTH_TOKEN # from console.twilio.com\nTWILIO_PHONE_NUMBER # your Twilio number e.g. +12025551234\nOPENAI_API_KEY # for interactive mode brain\n\nMode 1: One-way Call\npython3 scripts/one_way_call.py \\\n --to \"+13105551234\" \\\n --text \"Hey! Just calling to say good morning.\" \\\n --voice \"tyepWYJJwJM9TTFIg5U7\" # optional, defaults to Clara (Australian female)\n\n\nSee references/voices.md for curated voice IDs.\n\nMode 2: Interactive Conversation\nStep 1 — Start a tunnel (needed so Twilio can reach your server)\nnpx localtunnel --port 5050 --subdomain my-caller\n# Note the URL: https://my-caller.loca.lt\n\nStep 2 — Start the server\nexport CLARA_PUBLIC_URL=\"https://my-caller.loca.lt\"\npython3 scripts/server.py\n\nStep 3 — Make the call\npython3 scripts/interactive_call.py \\\n --to \"+13105551234\" \\\n --url \"https://my-caller.loca.lt\" \\\n --persona \"You are calling a restaurant to book a table for 2 at 8pm tonight.\" \\\n --opening \"Hi! I'd like to make a reservation for two people this evening around 8pm. Do you have availability?\"\n\n\nWhen the call ends, a GPT-generated summary is automatically sent via iMessage to MASTER_PHONE env var.\n\nScheduling a Call\n\nUse macOS cron for timed calls:\n\n# Add to crontab — this example calls at 8:45 AM\ncrontab -e\n45 8 24 2 * python3 /path/to/scripts/one_way_call.py --to \"+1...\" --text \"Good morning!\" >> /tmp/call.log 2>&1\n\nVoice Selection\nDefault: Clara tyepWYJJwJM9TTFIg5U7 — Australian female, warm, clear, professional\nSee references/voices.md for full curated list with IDs and descriptions\nKey Notes\nTwilio trial accounts: Can only call verified numbers. Upgrade or verify numbers at console.twilio.com → Verified Caller IDs\nAudio hosting: Scripts use tmpfiles.org for one-off calls (60 min TTL). For scheduled calls, server.py serves audio at /audio/ via the tunnel\nlocaltunnel: Free, no account needed. ngrok requires a free account + authtoken\nInteractive mode latency: ~3-5s per turn (ElevenLabs TTS + GPT + audio upload). Normal for phone conversations" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/omerflo/phone-caller", "publisherUrl": "https://clawhub.ai/omerflo/phone-caller", "owner": "omerflo", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "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" } }