{"skill":{"slug":"openclaw-voiceai-voice-agent","displayName":"Voice.Ai Voice Agents","summary":"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.","description":"---\nname: voice.ai-voice-agents\ntitle: \"Voice.ai Voice Agents\"\ndescription: >\n  Create, manage, and deploy Voice.ai conversational AI agents.\n  Use when the user wants to work with voice agents, list their agents, create new ones, or manage agent configurations.\n---\n\n# Voice.ai Agents\n\nBuild the best conversational AI voice agents with Voice.ai's Agent API.\n\n## ✨ Features\n\n- **Agent Management** - Create, update, and delete voice agents\n- **One-Click Deploy** - Deploy agents for phone calls instantly\n- **Knowledge Base** - RAG-powered agents with custom knowledge\n- **MCP Integration** - Connect agents to external tools via MCP\n- **Phone Numbers** - Manage inbound/outbound phone numbers\n- **Analytics** - Track call history and agent performance\n\n## ⚙️ Configuration\n\n### Get Your API Key\n\n1. Go to [Voice.ai Developer Dashboard](https://voice.ai/app/dashboard/developers)\n2. Sign in or create an account\n3. Generate a new API key\n4. Copy and save it securely\n\n### Set Up Authentication (3 Methods)\n\n**Method 1: Environment Variable (Recommended)**\n```bash\nexport VOICE_AI_API_KEY=\"your-api-key-here\"\n```\n\n**Method 2: .env File**\n```bash\n# Create .env file in project root\necho 'VOICE_AI_API_KEY=your-api-key-here' >> .env\n```\n\n**Method 3: OpenClaw Config**\n```json\n{\n  \"skills\": {\n    \"voice.ai-voice-agents\": {\n      \"api_key\": \"your-api-key-here\"\n    }\n  }\n}\n```\n\n## 🔐 Before Any Operation\n\n> **Important:** Always verify authentication before running any commands.\n\n```bash\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```\n\n### Silent Initialization\nThe SDK automatically initializes when you run any command. No manual setup required after setting the API key.\n\n## 🚀 Quick Start\n\n```bash\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 <agent_id>\n```\n\n## 🤖 Agent Configuration\n\n| Parameter              | Default | Description                          |\n|------------------------|---------|--------------------------------------|\n| llm_model              | gemini-2.5-flash-lite | LLM model for responses |\n| llm_temperature        | 0.7     | Response creativity (0-2)            |\n| max_call_duration      | 900     | Max call length in seconds           |\n| allow_interruptions    | true    | Let users interrupt agent            |\n| auto_noise_reduction   | true    | Filter background noise              |\n\n## 🎙️ TTS Voice Settings\n\n| Parameter   | Default | Description                    |\n|-------------|---------|--------------------------------|\n| voice_id    | -       | Voice ID for agent speech      |\n| model       | auto    | TTS model (auto-selected)      |\n| language    | en      | Language code                  |\n| temperature | 1.0     | Voice expressiveness (0-2)     |\n| top_p       | 0.8     | Sampling parameter (0-1)       |\n\n## 🌍 Supported Languages\n\n`auto`, `en`, `ca`, `sv`, `es`, `fr`, `de`, `it`, `pt`, `pl`, `ru`, `nl`\n\n## 💻 CLI Usage\n\n```bash\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 <agent_id>\n\n# Update an agent\nnode scripts/agent.js update --id <agent_id> --prompt \"New prompt\"\n\n# Deploy an agent\nnode scripts/agent.js deploy --id <agent_id>\n\n# Pause an agent\nnode scripts/agent.js pause --id <agent_id>\n\n# Delete an agent\nnode scripts/agent.js delete --id <agent_id>\n```\n\n## 🤖 OpenClaw Integration\n\n### JSON Configuration\n\n```json\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```\n\n### Chat Triggers\n\nOpenClaw automatically activates this skill when you mention:\n- \"voice agent\", \"voice bot\", \"phone agent\"\n- \"create agent\", \"deploy agent\", \"list agents\"\n- \"Voice.ai\", \"voice ai\"\n\n## 🗣️ User-Friendly Language\n\n| When User Says... | Skill Does... |\n|-------------------|---------------|\n| \"Create a support agent\" | Creates agent with support-focused prompt |\n| \"Show my agents\" | Lists all agents with status |\n| \"Deploy the agent\" | Deploys agent for phone calls |\n| \"Update the greeting\" | Updates agent greeting message |\n| \"Delete the test agent\" | Deletes specified agent |\n| \"What agents do I have?\" | Lists agents in friendly format |\n| \"Make an FAQ bot\" | Creates agent with FAQ template |\n| \"Connect to my MCP server\" | Configures MCP integration |\n\n## 📁 Project Files\n\n```\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```\n\n| File | Purpose |\n|------|---------|\n| `SKILL.md` | Documentation and OpenClaw skill definition |\n| `voice-ai-agents.yaml` | API config, models, defaults |\n| `voice-ai-agents-sdk.js` | Full SDK with all API methods |\n| `scripts/agent.js` | Command-line interface |\n\n## ❌ Error Handling\n\n| Error | Cause | Solution |\n|-------|-------|----------|\n| `401 Unauthorized` | Invalid or missing API key | Check `VOICE_AI_API_KEY` is set correctly |\n| `403 Forbidden` | API key lacks permissions | Generate new key with proper scopes |\n| `404 Not Found` | Agent ID doesn't exist | Run `list` to get valid agent IDs |\n| `429 Too Many Requests` | Rate limit exceeded | Wait 60 seconds and retry |\n| `500 Server Error` | Voice.ai API issue | Check [status page](https://status.voice.ai) |\n| `ENOTFOUND` | Network error | Check internet connection |\n| `Agent not deployed` | Agent exists but not active | Run `deploy --id <agent_id>` |\n\n### Graceful 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\n## 📝 Triggers\n\nThese phrases activate the Voice.ai Agents skill in OpenClaw:\n\n| Category | Trigger Phrases |\n|----------|-----------------|\n| **Create** | \"create voice agent\", \"make a phone bot\", \"new agent\" |\n| **List** | \"show agents\", \"list my agents\", \"what agents exist\" |\n| **Deploy** | \"deploy agent\", \"activate agent\", \"start the bot\" |\n| **Update** | \"update agent\", \"change prompt\", \"edit greeting\" |\n| **Delete** | \"delete agent\", \"remove bot\", \"destroy agent\" |\n| **Info** | \"agent details\", \"show agent\", \"get agent info\" |\n\n## 🔗 MCP Server Integration\n\nConnect your agent to external tools:\n\n```javascript\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\n## 📚 Knowledge Base (RAG)\n\nAdd custom knowledge to your agent:\n\n```bash\n# Create agent with knowledge base\nnode scripts/agent.js create --name \"FAQ Bot\" --kb-id 123\n```\n\n## 🔗 Links\n\n- [Get API Key](https://voice.ai/app/dashboard/developers) ← Start here!\n- [Voice Agents Guide](https://voice.ai/docs/guides/voice-agents/quickstart)\n- [Agent API Reference](https://voice.ai/docs/api-reference/agent-management/create-agent)\n- [Status Page](https://status.voice.ai)\n\n## 📋 Changelog\n\n| Version | Date | Changes |\n|---------|------|---------|\n| 1.0.0 | 2026-01-31 | Initial release with full agent management |\n\n---\n\nMade with ❤️ by [Nick Gill](https://github.com/gizmoGremlin)\n","tags":{"latest":"0.1.4"},"stats":{"comments":0,"downloads":2910,"installsAllTime":3,"installsCurrent":3,"stars":3,"versions":5},"createdAt":1769863778225,"updatedAt":1778485878349},"latestVersion":{"version":"0.1.4","createdAt":1769869257452,"changelog":"- Major documentation update: SKILL.md now covers API key setup, authentication methods, error handling, and OpenClaw integration in detail.\n- Expanded documentation for configuration via environment variable, .env file, and OpenClaw config.\n- Added comprehensive CLI, JSON configuration, and user-trigger phrase reference tables.\n- Improved troubleshooting section with common errors and solutions.\n- Included more usage examples, file overviews, and links for quick onboarding.","license":null},"metadata":null,"owner":{"handle":"gizmogremlin","userId":"s178490vvb7nmykckbyc8sh0sx884gc1","displayName":"Nick Gill","image":"https://avatars.githubusercontent.com/u/42254038?v=4"},"moderation":null}