ringg-voice-agent_skill

Overview

This skill integrates Ringg AI Voice OS with OpenClaw to make, receive, and manage phone calls using Ringg voice agents. It enables outbound calls, campaign launches, call status checks, transcripts, analytics, and assistant management directly from OpenClaw. Configure with Ringg API keys and optional defaults for assistant and from-number.

How this skill works

The skill uses Ringg REST endpoints to initiate outbound calls, trigger campaigns, query call status, fetch transcripts, and list or manage assistants. It also supports webhook registration so OpenClaw can receive real-time call events (completed, failed, transcript_ready) and react programmatically. Environment variables supply API credentials and default assistant/from-number values for convenient usage.

When to use it

• Make outbound calls from an OpenClaw flow using a Ringg AI assistant
• Trigger batch calling campaigns for leads, surveys, or reminders
• Retrieve call status, transcripts, or recent call history and analytics
• List, create, or update Ringg AI assistants from OpenClaw
• Connect OpenClaw agents to Ringg for automated lead qualification, feedback, or confirmations

Best practices

• Set RINGG_API_KEY and RINGG_WORKSPACE_ID in environment variables for secure calls
• Provide RINGG_DEFAULT_ASSISTANT_ID and RINGG_DEFAULT_FROM_NUMBER to simplify outbound requests
• Always use E.164 formatted phone numbers to avoid delivery errors
• Register webhooks in Ringg for call events to keep OpenClaw state synchronized
• Handle 401/404/429 errors with clear fallbacks and exponential backoff for rate limits

Example use cases

• Ask the agent to “call +14155552671” to initiate an outbound Ringg AI call using the default assistant
• Launch a feedback campaign to call a contact list and collect survey responses via voice AI
• Request recent call analytics to evaluate campaign performance over a date range
• Get the transcript for a specific call_id to review agent-customer conversations
• List available Ringg assistants to choose a specific voice agent before calling