（10298期）ClawdTalk – AI语音通话与任务自动化引擎

AI语音通话与任务自动化引擎 为Clawdbot提供语音通话、短信发送及AI任务自动化能力，支持多步骤外呼 campaigns 与完整状态追踪，需信任 Telnyx 云服务处理通话数据。 使用说明 核心用法 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 | 使用 CLAWDTALKAPIKEY 环境变量或 ${} 引用 || 任务状态不一致 | 未显式调用 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 环境变量：CLAWDTALKAPIKEY（必需）、CLAWDTALKAPIURL（可选） 官方仓库：https://github.com/team-telnyx/clawdtalk-client 原始说明 ClawdTalk — Voice calls, SMS, and AI Missions for Clawdbot