stringclaw_skill

Overview

This skill lets you place real outbound phone calls to users through Stringclaw voice AI. It bridges your local OpenClaw agent to Stringclaw’s telephony infrastructure so the user connects to a live voice session with the agent. Use it when a user explicitly asks to be called, and handle simple API responses to guide the user.

How this skill works

The skill requires a running stringclaw-bridge process on the host to connect the agent to Stringclaw. To initiate a call, the skill sends a POST to the Stringclaw call endpoint with an optional phoneNumber; if omitted, the dashboard number is used. It interprets success and common error codes (401, 402, 400) and returns concise user-facing messages.

When to use it

• User explicitly requests a phone call (e.g., “call me”, “give me a call”).
• You need a live voice session where the agent’s tools and memory remain available.
• Remote users who prefer voice over chat for guidance or support.
• When real-time, interactive conversation is required (appointments, troubleshooting).

Best practices

• Always verify the stringclaw-bridge is running before attempting a call (pgrep -f stringclaw-bridge).
• Respect user consent and confirm the phone number before calling.
• Handle API error codes explicitly: 401 (API key), 402 (out of minutes), 400 (no number).
• Keep user messages concise during call initiation (e.g., “Calling you now! Pick up in a moment.”).
• Log callId and basic metadata for troubleshooting and audit.

Example use cases

• A user requests step-by-step help and prefers a live walkthrough by phone.
• Support agents escalate a chat session to a voice call for faster resolution.
• Scheduling or confirming appointments via a real-time voice interaction.
• Delivering urgent notifications that require immediate acknowledgement.