Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Create, manage, and deploy Voice.ai conversational AI agents. Use when the user wants to work with voice agents, list their agents, create new ones, or manage agent configurations.
Create, manage, and deploy Voice.ai conversational AI agents. Use when the user wants to work with voice agents, list their agents, create new ones, or manage agent configurations.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
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.
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.
Build the best conversational AI voice agents with Voice.ai's Agent API.
Agent Management - Create, update, and delete voice agents One-Click Deploy - Deploy agents for phone calls instantly Knowledge Base - RAG-powered agents with custom knowledge MCP Integration - Connect agents to external tools via MCP Phone Numbers - Manage inbound/outbound phone numbers Analytics - Track call history and agent performance
Go to Voice.ai Developer Dashboard Sign in or create an account Generate a new API key Copy and save it securely
Method 1: Environment Variable (Recommended) export VOICE_AI_API_KEY="your-api-key-here" Method 2: .env File # Create .env file in project root echo 'VOICE_AI_API_KEY=your-api-key-here' >> .env Method 3: OpenClaw Config { "skills": { "voice.ai-voice-agents": { "api_key": "your-api-key-here" } } }
Important: Always verify authentication before running any commands. # 1. Check if API key is set echo $VOICE_AI_API_KEY # 2. Test connection (list agents) node scripts/agent.js list # 3. If errors, re-export your key export VOICE_AI_API_KEY="your-api-key-here"
The SDK automatically initializes when you run any command. No manual setup required after setting the API key.
export VOICE_AI_API_KEY="your-api-key" # Create an agent node scripts/agent.js create --name "Support Bot" --prompt "You are a helpful assistant" # List all agents node scripts/agent.js list # Deploy an agent node scripts/agent.js deploy --id <agent_id>
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
ParameterDefaultDescriptionvoice_id-Voice ID for agent speechmodelautoTTS model (auto-selected)languageenLanguage codetemperature1.0Voice expressiveness (0-2)top_p0.8Sampling parameter (0-1)
auto, en, ca, sv, es, fr, de, it, pt, pl, ru, nl
# Create a new agent node scripts/agent.js create --name "My Agent" --prompt "System prompt here" --greeting "Hello!" # List all agents node scripts/agent.js list # Get agent details node scripts/agent.js get --id <agent_id> # Update an agent node scripts/agent.js update --id <agent_id> --prompt "New prompt" # Deploy an agent node scripts/agent.js deploy --id <agent_id> # Pause an agent node scripts/agent.js pause --id <agent_id> # Delete an agent node scripts/agent.js delete --id <agent_id>
{ "name": "voice.ai-voice-agents", "enabled": true, "config": { "api_key": "${VOICE_AI_API_KEY}", "default_model": "gemini-2.5-flash-lite", "auto_deploy": false } }
OpenClaw automatically activates this skill when you mention: "voice agent", "voice bot", "phone agent" "create agent", "deploy agent", "list agents" "Voice.ai", "voice ai"
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
voice-ai-agents/ βββ SKILL.md # This documentation βββ voice-ai-agents.yaml # Skill configuration βββ voice-ai-agents-sdk.js # JavaScript SDK βββ scripts/ βββ agent.js # CLI tool FilePurposeSKILL.mdDocumentation and OpenClaw skill definitionvoice-ai-agents.yamlAPI config, models, defaultsvoice-ai-agents-sdk.jsFull SDK with all API methodsscripts/agent.jsCommand-line interface
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 <agent_id>
The SDK provides user-friendly error messages: β Authentication failed. Please check your API key. Get one at: https://voice.ai/app/dashboard/developers β Agent "support-bot" not found. Run 'node scripts/agent.js list' to see available agents. β Rate limit reached. Please wait 60 seconds before retrying.
These phrases activate the Voice.ai Agents skill in OpenClaw: CategoryTrigger 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"
Connect your agent to external tools: const agent = await client.createAgent({ name: "MCP Agent", config: { prompt: "You can use tools to help users", mcp_servers: [{ name: "my-tools", url: "https://my-server.com/mcp", auth_type: "bearer_token", auth_token: "secret" }] } });
Add custom knowledge to your agent: # Create agent with knowledge base node scripts/agent.js create --name "FAQ Bot" --kb-id 123
Get API Key β Start here! Voice Agents Guide Agent API Reference Status Page
VersionDateChanges1.0.02026-01-31Initial release with full agent management Made with β€οΈ by Nick Gill
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.