SkillHub

openclaw-phone-receipt

v1.0.1

Trigger and manage OpenClaw outbound phone receipts via ElevenLabs+Twilio for task completion/failure notifications. Use when user asks to call them after finishing/failing a task, asks to enable/disable fixed command toggles ("phone-receipt=on/off"), asks to test call quality, or asks to persist ph...

Sourced from ClawHub, Authored by tuofangzhe

Installation

Please help me install the skill `openclaw-phone-receipt` from SkillHub official store. npx skills add tuofangzhe/openclaw-phone-receipt

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:
  3. policy.onComplete=false
  4. policy.onFailure=true
  5. policy.onUrgent=true
  6. Persist state to memory/phone-receipt-state.json.
  7. 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