OpenClaw Phone Receipt
Use this skill to manage phone callback notifications.
Commands to honor
- -
phone-receipt=on → enable phone receipt policy - INLINECODE1 → disable phone receipt policy
State file:
Default behavior
- 1. If user asks for callback on completion/failure, set
enabled=true. - Default policy is now:
-
policy.onComplete=false
-
policy.onFailure=true
-
policy.onUrgent=true
- 3. Persist state to
memory/phone-receipt-state.json. - For immediate test call, run
scripts/trigger_call.sh.
Delivery strategy (must follow)
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
-
python3 skills/openclaw-phone-receipt/scripts/set_phone_receipt_state.py on
-
python3 skills/openclaw-phone-receipt/scripts/set_phone_receipt_state.py off
- INLINECODE11
Call prerequisites
Requires .env.elevenlabs-call with:
- - INLINECODE13
- INLINECODE14
- INLINECODE15
INLINECODE16 can come from shell env or .env.elevenlabs-call.
For full setup (Twilio purchase/verify, ElevenLabs import, key scopes, troubleshooting), read:
For ClawHub upload checklist (version/changelog/size requirements), read:
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
OpenClaw 电话回执
使用此技能管理电话回叫通知。
需遵循的命令
- - phone-receipt=on → 启用电话回执策略
- phone-receipt=off → 禁用电话回执策略
状态文件:
- - memory/phone-receipt-state.json
默认行为
- 1. 如果用户要求在任务完成/失败时回叫,则设置 enabled=true。
- 默认策略如下:
- policy.onComplete=false
- policy.onFailure=true
- policy.onUrgent=true
- 3. 将状态持久化到 memory/phone-receipt-state.json。
- 如需立即测试通话,运行 scripts/trigger_call.sh。
投递策略(必须遵循)
1) 任务失败,或
2) 用户明确将任务标记为紧急(例如“紧急/高优先级”)。
- 仅发送 Telegram 文本摘要(不拨打电话)。
当策略不要求电话时,默认使用消息投递(Telegram 文本)作为回执路径。
工具/脚本
- python3 skills/openclaw-phone-receipt/scripts/set
phonereceipt_state.py on
- python3 skills/openclaw-phone-receipt/scripts/set
phonereceipt_state.py off
- bash skills/openclaw-phone-receipt/scripts/trigger_call.sh
通话前提条件
需要 .env.elevenlabs-call 包含:
- - ELEVENLABSAGENTID
- ELEVENLABSOUTBOUNDPHONEID
- TONUMBER
ELEVENLABSAPIKEY 可来自 shell 环境变量或 .env.elevenlabs-call。
完整设置(Twilio 购买/验证、ElevenLabs 导入、密钥范围、故障排除)请阅读:
ClawHub 上传清单(版本/变更日志/大小要求)请阅读:
- - references/publish-clawhub.md
故障处理
如果通话失败,返回简洁的根本原因和下一步操作:
- - 目标号码未验证(Twilio 试用版)
- 缺少 ConvAI 范围(convai_read)
- 缺少代理/电话 ID