核心用法
ClawdTalk 是 Clawdbot 的语音/短信扩展技能，基于 Telnyx 云通信平台实现三大功能：
1. 语音通话：通过 WebSocket 连接实现 AI 助手的双向语音交互，支持呼入接听和批量外呼
2. 短信收发：发送和接收 SMS 消息，支持自动化短信任务
3. AI 任务（Missions）：完整的多步骤任务追踪系统，包含计划制定、步骤状态管理、事件日志和结果分析
主要工作流程：
- 初始化：使用
init命令创建任务、运行实例和执行计划 - 代理配置：通过
setup-agent创建语音/短信助手并分配电话号码 - 调度执行：使用
schedule-call或schedule-sms预约通信事件 - 轮询监控：通过 cron 作业定期检查事件完成状态（关键设计：不阻塞主会话）
- 状态同步：每步操作后必须执行
save-memory和log-event确保前端可见性
显著优点
- 企业级基础设施：依托 Telnyx 的运营商级通信网络，通话质量和送达率有保障
- 完整审计追踪：所有操作记录到云端，支持多维度洞察分析（conversation insights）
- 任务分类指导：文档详细区分 5 类任务模式（并行扫号、结构化评分、序列谈判等），避免架构误用
- 健壮的状态管理：本地
.missions_state.json+ 云端事件双保险，支持会话中断恢复 - IVR 和 AMD 支持：内置按键导航（DTMF）和答录机检测，适配真实商业场景
潜在缺点与局限
- 外部依赖风险：语音转录、短信内容、任务数据全部发送至 clawdtalk.com（Telnyx 运营），存在数据主权和隐私顾虑
- 复杂度门槛：正确使用需要理解 slug 一致性、步骤状态机、cron 轮询等概念，文档警告"#1 导致前端无显示的 bug"是忘记
save-memory - 计费成本：外呼需要付费账户和专用号码，批量外呼可能产生显著费用
- 时区与工时约束：需手动处理业务时间（9-17点）和时区转换
- 网关配置敏感：必须正确配置
gateway.tools.allow包含sessions_send，配置层级错误会导致通话接通但工具调用失败
适合人群
- 需要为 AI 助手添加真实通信能力的开发者和高级用户
- 有批量外呼、客户调研、供应商询价等自动化需求的业务场景
- 能接受数据上传至第三方云服务（Telnyx/美国）的用户
- 具备一定技术背景，能理解并维护 cron 轮询和状态同步逻辑的用户
常规风险
- 数据隐私：通话录音、转录文本、短信内容上传至 Telnyx 美国服务器
- API 密钥泄露：默认存储于
skill-config.json，建议使用环境变量CLAWDTALK_API_KEY - 任务悬挂：未正确执行
update-run完成或失败标记会导致任务在前端永久显示"进行中" - 轮询资源泄漏：忘记在任务终止时删除 cron 作业会造成不必要的 API 调用
- 误拨风险：AI 自主外呼可能在不适当时间联系接收方，需严格审核调度时间