SuperAPI AI 工具集

sms

办公与效率

查看项目

更新于 10-16 04:50

技能介绍

用途

SMS Skill 用于通过 Telnyx 和 Twilio 两个服务商发送短信/彩信、读取收件箱、监听实时入站消息、查看对话线程,并以 Claudius 身份自动回复入站短信。资料称其覆盖两个服务商的多个电话号码,并支持提供方自动识别。

主要能力

  • 发送短信与 MMS(可附带图片等媒体 URL)。
  • 读取收件箱、按号码/方向/数量筛选,支持查询单一或两个服务商。
  • 查看与某个号码的完整对话线程。
  • 列出可用号码,并可选查询实时状态。
  • 实时监听入站消息:Twilio 通过轮询,Telnyx 通过 webhook,消息写入 data/inbox.jsonl。
  • 自动回复,提供两种模式:交互式斜杠命令(/sms-respond)与独立守护进程(sms_respond.py)。
  • 三层 SQLite 记忆:工作记忆(对话历史与认知输出)、用户模型(按号码的个性画像)、soul 记忆(跨会话状态)。
  • 本地消息日志:所有已发送消息记录到 messages.jsonl。

使用方式

前置条件:需要安装 requests(uv pip install --system requests)。凭证可自动加载:Telnyx 使用 TELNYX_API_KEY 环境变量或回退到 ~/.claude.json;Twilio 使用 TWILIO_ACCOUNT_SID + TWILIO_AUTH_TOKEN 或回退到内置默认值。

常用命令示例(保留原样):

发送短信: python3 ~/.claude/skills/sms/scripts/sms_send.py "+19175551234" "Hello from Claude"

读取最近消息: python3 ~/.claude/skills/sms/scripts/sms_read.py -n 10

查看与某人的对话: python3 ~/.claude/skills/sms/scripts/sms_conversation.py "+19175551234"

列出所有可用号码: python3 ~/.claude/skills/sms/scripts/sms_numbers.py

启动实时监听(后台): python3 ~/.claude/skills/sms/scripts/sms_listen.py --bg

检查入站消息: python3 ~/.claude/skills/sms/scripts/sms_inbox.py

各脚本均提供多种参数,例如发送脚本支持 --from、--provider、--media;读取脚本支持 --to、--from-number、--direction、-n、--provider、--all-providers;监听脚本支持 --bg、--stop、--status、--interval、--numbers、--webhook-port、--no-telnyx、--no-twilio。

自动回复模式 A:/sms-respond 斜杠命令,使用当前 Claude Code 会话作为 LLM,加载 inbox、soul.md 与记忆上下文,经过 6 步认知流程后回复,并启动后台 watcher(sms_watch.py)每 5 秒轮询。

自动回复模式 B:sms_respond.py 独立守护进程,适用于 Mac Mini 或无头部署,使用 claude -p 子进程生成回复,不能在运行中的 Claude Code 会话内使用。

sms_process_reply.py 可在一次调用中发送回复并完成 9 项记忆操作。 sms_watch.py 作为后台监视器,检测到新消息时输出结构化 JSON 行(可附加 --enrich 输出记忆上下文)。 sms_inbox.py 用于读取、筛选与标记已处理消息。

Telnyx webhook 设置:将 Telnyx Messaging Profile 的 webhook URL 指向 http://localhost:9147/telnyx;远程访问可使用 ngrok 等隧道。

适用场景

  • 从 Claude Code 会话内发送短信或彩信。
  • 读取并整理短信收件箱、查看对话历史。
  • 监听并自动回复入站短信,形成双向往返的短信循环。
  • 在无头环境(如 Mac Mini)上以守护进程方式自动回复。

限制

  • Telnyx 仅支持发送:没有 GET /v2/messages 端点,接收消息仅靠 webhook;已发送消息依赖本地日志。需要完整读取/对话能力时,请使用 --provider twilio 或 --all-providers。
  • 模式 B 的守护进程不能在正在运行的 Claude Code 会话内使用(子进程嵌套冲突)。
  • 两种自动回复模式都需要 sms_listen.py 运行以填充 inbox.jsonl。
  • 本地消息日志随每次发送增长,可通过删除 data/messages.jsonl 重置。
  • 号码参考:Telnyx 有 +18628026208(Longcode,主要,默认)与 +18334843851(Toll-free,次要);Twilio 列出 9 个号码,含各号码的标签与用途说明(资料中标注的部分状态如 broken 等请以原文为准)。
  • 收费、价格、平台兼容范围等资料未提供。