OpenClaw Phone Receipt

Use this skill to manage phone callback notifications.

Commands to honor

• phone-receipt=on → enable phone receipt policy
• phone-receipt=off → disable phone receipt policy

State file:

• memory/phone-receipt-state.json

Default behavior

1. If user asks for callback on completion/failure, set enabled=true.
2. Default policy is now:
• policy.onComplete=false
• policy.onFailure=true
• policy.onUrgent=true
3. Persist state to memory/phone-receipt-state.json.
4. For immediate test call, run scripts/trigger_call.sh.

Delivery strategy (must follow)

• Phone call only when:

1) task failed, OR

2) user explicitly marks task as urgent (e.g., “urgent/high-priority”).

• All other non-urgent successful tasks:
• send Telegram text summary only (no phone call).

When phone is not required by policy, use message delivery (Telegram text) as default receipt path.

Tools/scripts

• Toggle state:
• python3 skills/openclaw-phone-receipt/scripts/set_phone_receipt_state.py on
• python3 skills/openclaw-phone-receipt/scripts/set_phone_receipt_state.py off
• Trigger call now:
• bash skills/openclaw-phone-receipt/scripts/trigger_call.sh

Call prerequisites

Requires .env.elevenlabs-call with:

• ELEVENLABS_AGENT_ID
• ELEVENLABS_OUTBOUND_PHONE_ID
• TO_NUMBER

ELEVENLABS_API_KEY can come from shell env or .env.elevenlabs-call.

For full setup (Twilio purchase/verify, ElevenLabs import, key scopes, troubleshooting), read:

• references/setup.md

For ClawHub upload checklist (version/changelog/size requirements), read:

• references/publish-clawhub.md

Failure handling

If call fails, return concise root cause and next action:

• unverified target number (Twilio trial)
• missing ConvAI scope (convai_read)
• missing agent/phone ids