phone-calling

What This Skill Does

The phone-calling skill, powered by the Ringez API, allows your AI agent to initiate international voice calls directly from its environment. It provides a seamless interface to connect with individuals, international business clients, or automated services across over 200 countries. By utilizing a simple authentication mechanism involving email verification or password login, the agent gains access to a balance-based calling system, eliminating the need for expensive, long-term monthly subscriptions. This skill is particularly powerful for agents because it supports both 'Bridge Mode', which connects the user to a destination, and 'Direct Mode', which allows the agent to place calls automatically without needing an intermediary device to ring. It provides full transparency into account balances and utilizes idempotency keys to ensure that API requests do not trigger duplicate calls, maintaining robust operational stability.

Installation

To integrate this skill into your environment, run the following command in your terminal:

clawhub install openclaw/skills/skills/adisahani/phone-calling

Ensure that you have your Ringez credentials ready, as the agent will require session authorization to authenticate its calls successfully against the service.

Use Cases

This skill is designed for high-utility scenarios, including:

• Global Customer Support: AI agents can make follow-up calls to international clients after a support ticket is resolved.
• Automated Appointment Setting: Agents can trigger calls to businesses or service providers to confirm reservations or schedule appointments without human intervention.
• Emergency or Urgent Notifications: When integrated with monitoring systems, agents can initiate voice calls to alert personnel of critical system events.
• International Communication: Seamlessly calling family or business partners across time zones without traditional carrier markups.

Example Prompts

1. "OpenClaw, please use the phone-calling skill to call the hotel in Paris at +33 1 23 45 67 89 to confirm my reservation for next Tuesday."
2. "Check my current Ringez account balance and if I have enough credit, call this support line: +44 20 7946 0123."
3. "Initiate a direct mode call to +91 9876543210 regarding the project update; make sure to use the latest session ID for this request."

Tips & Limitations

• Idempotency Keys: Always provide an idempotency key during the initiation step to prevent duplicate calls if your network request is retried.
• Mode Selection: Use 'Direct Mode' for purely agent-led automated tasks to avoid the 'bridge' ringback on your personal device.
• Balance Monitoring: Periodically query the '/me' endpoint to ensure you have sufficient minutes remaining to avoid call failures during critical tasks.
• Privacy: While the service is privacy-focused, ensure compliance with local regulations regarding automated or recorded calls in the destination country.