openclaw-voiceai-voice-agentCreate, 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.
Install via ClawdBot CLI:
clawdbot install gizmoGremlin/openclaw-voiceai-voice-agentBuild the best conversational AI voice agents with Voice.ai's Agent API.
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' >> .envMethod 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>| Parameter | Default | Description |
|------------------------|---------|--------------------------------------|
| llm_model | gemini-2.5-flash-lite | LLM model for responses |
| llm_temperature | 0.7 | Response creativity (0-2) |
| max_call_duration | 900 | Max call length in seconds |
| allow_interruptions | true | Let users interrupt agent |
| auto_noise_reduction | true | Filter background noise |
| Parameter | Default | Description |
|-------------|---------|--------------------------------|
| voice_id | - | Voice ID for agent speech |
| model | auto | TTS model (auto-selected) |
| language | en | Language code |
| temperature | 1.0 | Voice expressiveness (0-2) |
| top_p | 0.8 | Sampling 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:
| 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| File | Purpose |
|------|---------|
| SKILL.md | Documentation and OpenClaw skill definition |
| voice-ai-agents.yaml | API config, models, defaults |
| voice-ai-agents-sdk.js | Full SDK with all API methods |
| scripts/agent.js | Command-line interface |
| Error | Cause | Solution |
|-------|-------|----------|
| 401 Unauthorized | Invalid or missing API key | Check VOICE_AI_API_KEY is set correctly |
| 403 Forbidden | API key lacks permissions | Generate new key with proper scopes |
| 404 Not Found | Agent ID doesn't exist | Run list to get valid agent IDs |
| 429 Too Many Requests | Rate limit exceeded | Wait 60 seconds and retry |
| 500 Server Error | Voice.ai API issue | Check status page |
| ENOTFOUND | Network error | Check internet connection |
| Agent not deployed | Agent exists but not active | Run deploy --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:
| Category | Trigger Phrases |
|----------|-----------------|
| Create | "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| Version | Date | Changes |
|---------|------|---------|
| 1.0.0 | 2026-01-31 | Initial release with full agent management |
Made with ❤️ by Nick Gill
Generated Mar 1, 2026
Deploy voice agents to handle common customer inquiries, reducing wait times and freeing human agents for complex issues. Ideal for businesses with high call volumes like e-commerce or telecom, where agents can provide 24/7 support for FAQs, order tracking, and basic troubleshooting.
Use voice agents to automate appointment bookings, confirmations, and reminders for healthcare clinics, salons, or service-based businesses. This reduces no-shows and administrative overhead by integrating with calendar systems to manage schedules efficiently.
Implement voice agents to conduct initial outreach and qualify leads for sales teams, gathering key information like budget and timeline. This accelerates the sales pipeline in industries like real estate or B2B services, allowing human agents to focus on high-potential prospects.
Create interactive voice agents for language learning or subject tutoring, offering personalized quizzes and feedback. Useful for edtech platforms or schools to engage students through conversational practice, enhancing retention and accessibility.
Deploy voice agents in public safety or healthcare to triage emergency calls, assessing severity and providing initial guidance while routing to human responders. This improves response times and resource allocation in critical situations.
Charge businesses a monthly fee per agent or call volume, offering tiered plans with features like analytics and MCP integration. This provides recurring revenue and scales with client usage, ideal for SaaS companies targeting SMEs.
Bill clients based on actual usage metrics such as call minutes or number of interactions, with no upfront costs. This appeals to startups or seasonal businesses looking for flexible, cost-effective automation without long-term commitments.
License the voice agent technology to other companies for rebranding and integration into their own products, charging licensing fees or revenue shares. This expands market reach through partners in industries like call centers or software platforms.
💬 Integration Tip
Start by setting the API key via environment variables for quick testing, then explore CLI commands like 'list' and 'create' to build familiarity before deploying agents.
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Search and analyze your own session logs (older/parent conversations) using jq.
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linking related objects, enforcing constraints, planning multi-step actions as graph transformations, or when skills need to share state. Trigger on "remember", "what do I know about", "link X to Y", "show dependencies", entity CRUD, or cross-skill data access.
Ultimate AI agent memory system for Cursor, Claude, ChatGPT & Copilot. WAL protocol + vector search + git-notes + cloud backup. Never lose context again. Vibe-coding ready.
Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection