为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 | 使用 `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
会员专属
