{ "schemaVersion": "1.0", "item": { "slug": "openclaw-voiceai-voice-agent", "name": "Voice.Ai Voice Agents", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/gizmoGremlin/openclaw-voiceai-voice-agent", "canonicalUrl": "https://clawhub.ai/gizmoGremlin/openclaw-voiceai-voice-agent", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/openclaw-voiceai-voice-agent", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-voiceai-voice-agent", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "scripts/agent.js", "voice-ai-agents-sdk.js", "voice-ai-agents.yaml" ], "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/openclaw-voiceai-voice-agent" }, "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/openclaw-voiceai-voice-agent", "agentPageUrl": "https://openagent3.xyz/skills/openclaw-voiceai-voice-agent/agent", "manifestUrl": "https://openagent3.xyz/skills/openclaw-voiceai-voice-agent/agent.json", "briefUrl": "https://openagent3.xyz/skills/openclaw-voiceai-voice-agent/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": "Voice.ai Agents", "body": "Build the best conversational AI voice agents with Voice.ai's Agent API." }, { "title": "✨ Features", "body": "Agent Management - Create, update, and delete voice agents\nOne-Click Deploy - Deploy agents for phone calls instantly\nKnowledge Base - RAG-powered agents with custom knowledge\nMCP Integration - Connect agents to external tools via MCP\nPhone Numbers - Manage inbound/outbound phone numbers\nAnalytics - Track call history and agent performance" }, { "title": "Get Your API Key", "body": "Go to Voice.ai Developer Dashboard\nSign in or create an account\nGenerate a new API key\nCopy and save it securely" }, { "title": "Set Up Authentication (3 Methods)", "body": "Method 1: Environment Variable (Recommended)\n\nexport VOICE_AI_API_KEY=\"your-api-key-here\"\n\nMethod 2: .env File\n\n# Create .env file in project root\necho 'VOICE_AI_API_KEY=your-api-key-here' >> .env\n\nMethod 3: OpenClaw Config\n\n{\n \"skills\": {\n \"voice.ai-voice-agents\": {\n \"api_key\": \"your-api-key-here\"\n }\n }\n}" }, { "title": "πŸ” Before Any Operation", "body": "Important: Always verify authentication before running any commands.\n\n# 1. Check if API key is set\necho $VOICE_AI_API_KEY\n\n# 2. Test connection (list agents)\nnode scripts/agent.js list\n\n# 3. If errors, re-export your key\nexport VOICE_AI_API_KEY=\"your-api-key-here\"" }, { "title": "Silent Initialization", "body": "The SDK automatically initializes when you run any command. No manual setup required after setting the API key." }, { "title": "πŸš€ Quick Start", "body": "export VOICE_AI_API_KEY=\"your-api-key\"\n\n# Create an agent\nnode scripts/agent.js create --name \"Support Bot\" --prompt \"You are a helpful assistant\"\n\n# List all agents\nnode scripts/agent.js list\n\n# Deploy an agent\nnode scripts/agent.js deploy --id " }, { "title": "πŸ€– Agent Configuration", "body": "ParameterDefaultDescriptionllm_modelgemini-2.5-flash-liteLLM model for responsesllm_temperature0.7Response creativity (0-2)max_call_duration900Max call length in secondsallow_interruptionstrueLet users interrupt agentauto_noise_reductiontrueFilter background noise" }, { "title": "πŸŽ™οΈ TTS Voice Settings", "body": "ParameterDefaultDescriptionvoice_id-Voice ID for agent speechmodelautoTTS model (auto-selected)languageenLanguage codetemperature1.0Voice expressiveness (0-2)top_p0.8Sampling parameter (0-1)" }, { "title": "🌍 Supported Languages", "body": "auto, en, ca, sv, es, fr, de, it, pt, pl, ru, nl" }, { "title": "πŸ’» CLI Usage", "body": "# Create a new agent\nnode scripts/agent.js create --name \"My Agent\" --prompt \"System prompt here\" --greeting \"Hello!\"\n\n# List all agents\nnode scripts/agent.js list\n\n# Get agent details\nnode scripts/agent.js get --id \n\n# Update an agent\nnode scripts/agent.js update --id --prompt \"New prompt\"\n\n# Deploy an agent\nnode scripts/agent.js deploy --id \n\n# Pause an agent\nnode scripts/agent.js pause --id \n\n# Delete an agent\nnode scripts/agent.js delete --id " }, { "title": "JSON Configuration", "body": "{\n \"name\": \"voice.ai-voice-agents\",\n \"enabled\": true,\n \"config\": {\n \"api_key\": \"${VOICE_AI_API_KEY}\",\n \"default_model\": \"gemini-2.5-flash-lite\",\n \"auto_deploy\": false\n }\n}" }, { "title": "Chat Triggers", "body": "OpenClaw automatically activates this skill when you mention:\n\n\"voice agent\", \"voice bot\", \"phone agent\"\n\"create agent\", \"deploy agent\", \"list agents\"\n\"Voice.ai\", \"voice ai\"" }, { "title": "πŸ—£οΈ User-Friendly Language", "body": "When User Says...Skill Does...\"Create a support agent\"Creates agent with support-focused prompt\"Show my agents\"Lists all agents with status\"Deploy the agent\"Deploys agent for phone calls\"Update the greeting\"Updates agent greeting message\"Delete the test agent\"Deletes specified agent\"What agents do I have?\"Lists agents in friendly format\"Make an FAQ bot\"Creates agent with FAQ template\"Connect to my MCP server\"Configures MCP integration" }, { "title": "πŸ“ Project Files", "body": "voice-ai-agents/\nβ”œβ”€β”€ SKILL.md # This documentation\nβ”œβ”€β”€ voice-ai-agents.yaml # Skill configuration\nβ”œβ”€β”€ voice-ai-agents-sdk.js # JavaScript SDK\n└── scripts/\n └── agent.js # CLI tool\n\nFilePurposeSKILL.mdDocumentation and OpenClaw skill definitionvoice-ai-agents.yamlAPI config, models, defaultsvoice-ai-agents-sdk.jsFull SDK with all API methodsscripts/agent.jsCommand-line interface" }, { "title": "❌ Error Handling", "body": "ErrorCauseSolution401 UnauthorizedInvalid or missing API keyCheck VOICE_AI_API_KEY is set correctly403 ForbiddenAPI key lacks permissionsGenerate new key with proper scopes404 Not FoundAgent ID doesn't existRun list to get valid agent IDs429 Too Many RequestsRate limit exceededWait 60 seconds and retry500 Server ErrorVoice.ai API issueCheck status pageENOTFOUNDNetwork errorCheck internet connectionAgent not deployedAgent exists but not activeRun deploy --id " }, { "title": "Graceful Error Messages", "body": "The SDK provides user-friendly error messages:\n\n❌ Authentication failed. Please check your API key.\n Get one at: https://voice.ai/app/dashboard/developers\n\n❌ Agent \"support-bot\" not found. \n Run 'node scripts/agent.js list' to see available agents.\n\n❌ Rate limit reached. Please wait 60 seconds before retrying." }, { "title": "πŸ“ Triggers", "body": "These phrases activate the Voice.ai Agents skill in OpenClaw:\n\nCategoryTrigger PhrasesCreate\"create voice agent\", \"make a phone bot\", \"new agent\"List\"show agents\", \"list my agents\", \"what agents exist\"Deploy\"deploy agent\", \"activate agent\", \"start the bot\"Update\"update agent\", \"change prompt\", \"edit greeting\"Delete\"delete agent\", \"remove bot\", \"destroy agent\"Info\"agent details\", \"show agent\", \"get agent info\"" }, { "title": "πŸ”— MCP Server Integration", "body": "Connect your agent to external tools:\n\nconst agent = await client.createAgent({\n name: \"MCP Agent\",\n config: {\n prompt: \"You can use tools to help users\",\n mcp_servers: [{\n name: \"my-tools\",\n url: \"https://my-server.com/mcp\",\n auth_type: \"bearer_token\",\n auth_token: \"secret\"\n }]\n }\n});" }, { "title": "πŸ“š Knowledge Base (RAG)", "body": "Add custom knowledge to your agent:\n\n# Create agent with knowledge base\nnode scripts/agent.js create --name \"FAQ Bot\" --kb-id 123" }, { "title": "πŸ”— Links", "body": "Get API Key ← Start here!\nVoice Agents Guide\nAgent API Reference\nStatus Page" }, { "title": "πŸ“‹ Changelog", "body": "VersionDateChanges1.0.02026-01-31Initial release with full agent management\n\nMade with ❀️ by Nick Gill" } ], "body": "Voice.ai Agents\n\nBuild the best conversational AI voice agents with Voice.ai's Agent API.\n\n✨ Features\nAgent Management - Create, update, and delete voice agents\nOne-Click Deploy - Deploy agents for phone calls instantly\nKnowledge Base - RAG-powered agents with custom knowledge\nMCP Integration - Connect agents to external tools via MCP\nPhone Numbers - Manage inbound/outbound phone numbers\nAnalytics - Track call history and agent performance\nβš™οΈ Configuration\nGet Your API Key\nGo to Voice.ai Developer Dashboard\nSign in or create an account\nGenerate a new API key\nCopy and save it securely\nSet Up Authentication (3 Methods)\n\nMethod 1: Environment Variable (Recommended)\n\nexport VOICE_AI_API_KEY=\"your-api-key-here\"\n\n\nMethod 2: .env File\n\n# Create .env file in project root\necho 'VOICE_AI_API_KEY=your-api-key-here' >> .env\n\n\nMethod 3: OpenClaw Config\n\n{\n \"skills\": {\n \"voice.ai-voice-agents\": {\n \"api_key\": \"your-api-key-here\"\n }\n }\n}\n\nπŸ” Before Any Operation\n\nImportant: Always verify authentication before running any commands.\n\n# 1. Check if API key is set\necho $VOICE_AI_API_KEY\n\n# 2. Test connection (list agents)\nnode scripts/agent.js list\n\n# 3. If errors, re-export your key\nexport VOICE_AI_API_KEY=\"your-api-key-here\"\n\nSilent Initialization\n\nThe SDK automatically initializes when you run any command. No manual setup required after setting the API key.\n\nπŸš€ Quick Start\nexport VOICE_AI_API_KEY=\"your-api-key\"\n\n# Create an agent\nnode scripts/agent.js create --name \"Support Bot\" --prompt \"You are a helpful assistant\"\n\n# List all agents\nnode scripts/agent.js list\n\n# Deploy an agent\nnode scripts/agent.js deploy --id \n\nπŸ€– Agent Configuration\nParameter\tDefault\tDescription\nllm_model\tgemini-2.5-flash-lite\tLLM model for responses\nllm_temperature\t0.7\tResponse creativity (0-2)\nmax_call_duration\t900\tMax call length in seconds\nallow_interruptions\ttrue\tLet users interrupt agent\nauto_noise_reduction\ttrue\tFilter background noise\nπŸŽ™οΈ TTS Voice Settings\nParameter\tDefault\tDescription\nvoice_id\t-\tVoice ID for agent speech\nmodel\tauto\tTTS model (auto-selected)\nlanguage\ten\tLanguage code\ntemperature\t1.0\tVoice expressiveness (0-2)\ntop_p\t0.8\tSampling parameter (0-1)\n🌍 Supported Languages\n\nauto, en, ca, sv, es, fr, de, it, pt, pl, ru, nl\n\nπŸ’» CLI Usage\n# Create a new agent\nnode scripts/agent.js create --name \"My Agent\" --prompt \"System prompt here\" --greeting \"Hello!\"\n\n# List all agents\nnode scripts/agent.js list\n\n# Get agent details\nnode scripts/agent.js get --id \n\n# Update an agent\nnode scripts/agent.js update --id --prompt \"New prompt\"\n\n# Deploy an agent\nnode scripts/agent.js deploy --id \n\n# Pause an agent\nnode scripts/agent.js pause --id \n\n# Delete an agent\nnode scripts/agent.js delete --id \n\nπŸ€– OpenClaw Integration\nJSON Configuration\n{\n \"name\": \"voice.ai-voice-agents\",\n \"enabled\": true,\n \"config\": {\n \"api_key\": \"${VOICE_AI_API_KEY}\",\n \"default_model\": \"gemini-2.5-flash-lite\",\n \"auto_deploy\": false\n }\n}\n\nChat Triggers\n\nOpenClaw automatically activates this skill when you mention:\n\n\"voice agent\", \"voice bot\", \"phone agent\"\n\"create agent\", \"deploy agent\", \"list agents\"\n\"Voice.ai\", \"voice ai\"\nπŸ—£οΈ User-Friendly Language\nWhen User Says...\tSkill Does...\n\"Create a support agent\"\tCreates agent with support-focused prompt\n\"Show my agents\"\tLists all agents with status\n\"Deploy the agent\"\tDeploys agent for phone calls\n\"Update the greeting\"\tUpdates agent greeting message\n\"Delete the test agent\"\tDeletes specified agent\n\"What agents do I have?\"\tLists agents in friendly format\n\"Make an FAQ bot\"\tCreates agent with FAQ template\n\"Connect to my MCP server\"\tConfigures MCP integration\nπŸ“ Project Files\nvoice-ai-agents/\nβ”œβ”€β”€ SKILL.md # This documentation\nβ”œβ”€β”€ voice-ai-agents.yaml # Skill configuration\nβ”œβ”€β”€ voice-ai-agents-sdk.js # JavaScript SDK\n└── scripts/\n └── agent.js # CLI tool\n\nFile\tPurpose\nSKILL.md\tDocumentation and OpenClaw skill definition\nvoice-ai-agents.yaml\tAPI config, models, defaults\nvoice-ai-agents-sdk.js\tFull SDK with all API methods\nscripts/agent.js\tCommand-line interface\n❌ Error Handling\nError\tCause\tSolution\n401 Unauthorized\tInvalid or missing API key\tCheck VOICE_AI_API_KEY is set correctly\n403 Forbidden\tAPI key lacks permissions\tGenerate new key with proper scopes\n404 Not Found\tAgent ID doesn't exist\tRun list to get valid agent IDs\n429 Too Many Requests\tRate limit exceeded\tWait 60 seconds and retry\n500 Server Error\tVoice.ai API issue\tCheck status page\nENOTFOUND\tNetwork error\tCheck internet connection\nAgent not deployed\tAgent exists but not active\tRun deploy --id \nGraceful Error Messages\n\nThe SDK provides user-friendly error messages:\n\n❌ Authentication failed. Please check your API key.\n Get one at: https://voice.ai/app/dashboard/developers\n\n❌ Agent \"support-bot\" not found. \n Run 'node scripts/agent.js list' to see available agents.\n\n❌ Rate limit reached. Please wait 60 seconds before retrying.\n\nπŸ“ Triggers\n\nThese phrases activate the Voice.ai Agents skill in OpenClaw:\n\nCategory\tTrigger Phrases\nCreate\t\"create voice agent\", \"make a phone bot\", \"new agent\"\nList\t\"show agents\", \"list my agents\", \"what agents exist\"\nDeploy\t\"deploy agent\", \"activate agent\", \"start the bot\"\nUpdate\t\"update agent\", \"change prompt\", \"edit greeting\"\nDelete\t\"delete agent\", \"remove bot\", \"destroy agent\"\nInfo\t\"agent details\", \"show agent\", \"get agent info\"\nπŸ”— MCP Server Integration\n\nConnect your agent to external tools:\n\nconst agent = await client.createAgent({\n name: \"MCP Agent\",\n config: {\n prompt: \"You can use tools to help users\",\n mcp_servers: [{\n name: \"my-tools\",\n url: \"https://my-server.com/mcp\",\n auth_type: \"bearer_token\",\n auth_token: \"secret\"\n }]\n }\n});\n\nπŸ“š Knowledge Base (RAG)\n\nAdd custom knowledge to your agent:\n\n# Create agent with knowledge base\nnode scripts/agent.js create --name \"FAQ Bot\" --kb-id 123\n\nπŸ”— Links\nGet API Key ← Start here!\nVoice Agents Guide\nAgent API Reference\nStatus Page\nπŸ“‹ Changelog\nVersion\tDate\tChanges\n1.0.0\t2026-01-31\tInitial release with full agent management\n\nMade with ❀️ by Nick Gill" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/gizmoGremlin/openclaw-voiceai-voice-agent", "publisherUrl": "https://clawhub.ai/gizmoGremlin/openclaw-voiceai-voice-agent", "owner": "gizmoGremlin", "version": "0.1.4", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/openclaw-voiceai-voice-agent", "downloadUrl": "https://openagent3.xyz/downloads/openclaw-voiceai-voice-agent", "agentUrl": "https://openagent3.xyz/skills/openclaw-voiceai-voice-agent/agent", "manifestUrl": "https://openagent3.xyz/skills/openclaw-voiceai-voice-agent/agent.json", "briefUrl": "https://openagent3.xyz/skills/openclaw-voiceai-voice-agent/agent.md" } }