核心用法
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