AI语音通话与任务自动化引擎

为Clawdbot提供语音通话、短信发送及AI任务自动化能力，支持多步骤外呼 campaigns 与完整状态追踪，需信任 Telnyx 云服务处理通话数据。

基本信息

• 技能名称?ClawdTalk
• 中文名称?AI语音通话与任务自动化引擎
• 作者?dcasem
• 分类?专业技能
• 版本?2.0.5
• 标签?voice, sms, telephony, automation, outreach, telnyx, mission-tracking, cron, api-client

使用方法

使用说明
核心用法
ClawdTalk 是 Clawdbot 的语音与短信通信技能，通过 Telnyx 云服务实现三类核心能力：

1. 实时语音通话
   WebSocket 客户端接入，支持呼入路由至主代理会话
   outbound 外呼脚本 ( call.sh )，支持自定义问候语与外部号码拨打
   通话转录、工具调用、会话状态实时同步至云端
2. SMS 消息收发
   单条/批量短信发送 ( sms.sh )
   会话列表管理与历史查询
3. AI Missions（完整任务追踪）
   基于 Python CLI ( telnyx_api.py ) 实现复杂多步骤任务的端到端管理：
   Mission/Run/Plan 三层架构 ：任务 → 执行实例 → 可追踪步骤
   Assistant 管理 ：创建语音/SMS代理、分配号码、绑定任务
   调度执行 ：定时呼叫/短信，支持 cron 轮询监控完成状态
   状态持久化 ：本地 .missions_state.json + 云端事件日志双备份
   洞察分析 ：通话结束后自动提取结构化结果（报价、预约等）
   典型工作流： init 初始化任务 → setup-agent 配置代理 → schedule-call/sms 调度 → cron 轮询 → get-insights 分析 → complete 结束任务。
   显著优点
   企业级通信基础设施 ：背靠 Telnyx（美国知名通信 API 服务商），通话质量与送达率有保障
   完整审计追踪 ：Mission 模式提供步骤级状态、事件日志、内存快照，适合合规要求场景
   AI 原生设计 ：语音通话直接接入主代理会话，可使用完整工具链与记忆能力
   灵活调度策略 ：支持并行批量外呼（Class 1/2）、顺序谈判（Class 3）、多轮跟进（Class 4）等多种任务模式
   错误恢复机制 ：步骤失败可重试，支持 mission 状态恢复与续跑
   隐私模式 ：外呼外部号码时自动隐藏用户私有信息
   潜在缺点与局限性
   强依赖外部云服务 ：所有语音转录、短信内容、任务状态均上传至 clawdtalk.com（Telnyx 运营），无法本地私有化部署
   复杂度过剩 ：简单单通外呼仍需创建 mission/run/plan，存在"用大炮打蚊子"的 over-engineering 风险（文档明确建议简单场景直接用 schedule-call 跳过 mission）
   手动生命周期管理 ：服务器不自动更新步骤状态或结束任务，必须由 bot 显式调用 update-step / update-run ，易因遗漏导致任务"假死"
   cron 轮询负担 ：监控呼叫完成需自建轮询机制，增加 bot 端复杂度
   成本门槛 ：外部号码外呼需付费账户与专用号码，免费账户仅限绑定手机
   网关配置敏感点 ： sessions_send 工具必须置于 gateway.tools.allow （非顶层 tools.allow ），配置错误会导致语音通话连接成功但代理无法响应
   适合人群
   需要 自动化外呼/短信 campaigns 的用户（销售线索跟进、供应商比价、预约确认）
   需要 完整通信审计日志 的企业合规场景
   已信任 Telnyx 云服务的 Clawdbot 用户
   能够处理多步骤任务编排与 cron 管理的进阶用户
   不适合 ：仅需偶尔单次通话/SMS、对数据出境敏感、或偏好极简配置的用户。
   常规风险
   | 风险类别 | 具体描述 | 缓解建议 | |---------|---------|---------| | 数据隐私 | 语音转录、短信内容、任务元数据持续上传 Telnyx 美国服务器 | 评估数据出境合规性；避免传输敏感个人信息 | | API 密钥泄露 | skill-config.json 默认明文存储 API key | 使用 CLAWDTALK_API_KEY 环境变量或 ${} 引用 | | 任务状态不一致 | 未显式调用 update-run 导致前端永久显示"running" | 建立步骤完成后的决策树检查机制 | | Cron 残留 | 任务结束后未清理轮询 cron | 在 terminal state（succeeded/failed）强制删除 cron | | Slug 不匹配 | init 与 setup-agent 使用不同 slug 导致事件不可见 | list-state 后复制粘贴，禁止缩写 | | 网关工具误配置 | sessions_send 放错层级导致语音通话无响应 | 严格按 gateway.tools.allow 路径配置 | | 费用失控 | 批量外呼未加限制 | 控制并发数（建议 5-10），监控 429 限流 | 版本与维护
   当前版本：2.0.0
   依赖：Python 3.7+、Node.js、bash、jq
   环境变量： CLAWDTALK_API_KEY （必需）、 CLAWDTALK_API_URL （可选）
   官方仓库：https://github.com/team-telnyx/clawdtalk-client