ClawdTalk

核心用法

ClawdTalk 是 Clawdbot 的语音通话与短信扩展技能，通过 Telnyx 云通信平台实现。主要功能包括：

• WebSocket 语音通话：建立实时连接，将电话呼叫路由至网关主代理会话，AI 可访问完整记忆、工具和上下文
• 双向 SMS：发送和接收文本消息，支持消息历史与会话管理
• 呼出电话：可拨打本人号码或外部号码（后者需付费账户和专用号码，AI 自动进入隐私模式）

使用流程：注册账号 → 绑定手机 → 获取 API key → 执行 ./setup.sh → 启动连接 ./scripts/connect.sh start

显著优点

1. 深度集成：通话直接接入主代理会话，非独立技能，保持上下文连续性
2. 隐私保护：拨打外部号码时自动启用隐私模式，不泄露用户私人信息
3. 低门槛脚本：提供完善的 Bash 脚本封装（call.sh、sms.sh、connect.sh），无需手动处理 WebSocket
4. 灵活配置：支持自定义问候语、自动读取 USER.md/IDENTITY.md 的身份信息

潜在缺点与局限性

1. 第三方依赖：核心服务依赖 Telnyx 平台，存在供应商锁定风险
2. 付费门槛：外部呼出功能需付费账户 + 专用号码，免费层仅支持自有设备
3. 工具链要求：需要 bash、node、jq 三个二进制依赖，环境兼容性受限
4. 网络依赖：WebSocket 连接质量直接影响通话体验，无离线能力
5. 安全黑箱：认证报告为占位符，未实际执行安全扫描，API key 存储于本地 JSON 文件

适合人群

• 已部署 Clawdbot 网关且希望扩展电话交互能力的用户
• 需要 AI 主动外呼提醒、电话客服场景的轻度商业用途
• 能接受第三方云通信服务依赖的技术用户

常规风险

• API key 明文存储于 skill-config.json，权限泄露可导致通话/SMS 滥用
• 外部通话的隐私模式依赖服务端实现，无法本地审计
• Telnyx 服务中断将直接导致功能失效，无降级方案

核心功能

ClawdTalk为Clawdbot提供了完整的语音通话（Voice Calls）和短信（SMS）双向通信能力，基于Telnyx全球电信基础设施构建。核心功能包括：

• 语音通话：支持呼入（用户拨打绑定号码）和呼出（bot主动呼叫）两种模式，WebSocket实时连接，通话过程中AI可访问完整记忆、工具和上下文
• 短信服务：发送、接收、列表查询和对话管理，支持双向文本交互
• 网关集成：与Clawdbot本地网关深度集成，实现语音转文本、AI处理、文本转语音的完整链路

显著优点

1. 企业级可靠性：Telnyx为2019年成立的老牌电信基础设施商，全球PoP覆盖，SLA保障
2. 安全合规：通过CLS-Certify S级认证（90分），TLS 1.2+加密传输，无硬编码密钥，支持环境变量配置
3. 隐私保护：外呼陌生号码时自动启用"隐私模式"，不泄露用户私人信息
4. 架构清晰：代码970行/10文件，单一依赖ws@8.18.0，无动态代码执行，易于审计
5. 无缝集成：自动读取IDENTITY.md/USER.md配置，零配置启动体验

潜在局限

• 付费门槛：外呼外部号码需付费账户和专用号码，免费账户仅限回拨自己手机
• 网络依赖：核心功能完全依赖clawdtalk.com云端服务，离线不可用（RISK-001）
• 本地日志：DEBUG模式可能记录敏感信息，需手动清理.connect.log
• 号码格式：当前输入验证较宽松，建议用户自行校验E.164格式

适合人群

• 需要实时语音交互的Clawdbot用户（如客服、陪伴、远程控制场景）
• 已有Telnyx账户或愿意付费获取专用号码的企业用户
• 对来源可信度要求高的用户（T2级企业维护）

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| API密钥泄露 | 中 | 默认写入skill-config.json，建议改用环境变量 |

| 隐私信息日志 | 低 | DEBUG模式可能记录完整消息，需定期清理日志 |

| 服务可用性 | 低 | 完全依赖Telnyx云服务，无本地降级方案 |

| 电话号码隐私 | 低 | 日志中电话号码未脱敏，建议手动处理 |

使用建议：优先使用环境变量配置API密钥，定期检查日志内容，生产环境建议锁定依赖版本。