ringringring：AI 拨打你的手机进行语音通话

中文 | English

0 成本实现 iOS 原生通话。 无需 Mac，无需 99$ 开发者账号，无需购买或编写 iOS 原生 App，无需配置数据库——iPhone 手机上装个免费的 Linphone，你的 AI 就能给你打电话。

无需购买号码，无按分钟计费；语音识别与语音合成均使用免费额度。仅需一台已在运行 AI 的 Linux 服务器。iPhone 熄屏或 Linphone 处于后台时同样可以来电。

功能

• 双向语音通话：AI 拨打手机，接通后进行多轮对话。用户语音经识别转为文字交给 AI，AI 的回复经合成后播放。

• 插话打断：AI 说话期间用户开口，播放立即停止，并返回已说出与未说出的部分。

• 单线路锁：同一主机上的多个 AI 入口共享一条线路，通话中再次拨号将返回忙线。

• 隐私默认值：日志仅记录接通、挂断、错误类别与转写文本；手机网络地址默认打码，以降低其进入模型上下文的风险（不构成对服务器管理员的强隔离）。

• 可替换的识别与合成：语音识别与语音合成均可配置，详见「替换语音识别与语音合成」。

Related MCP server: Bond-OpenAI MCP

前置条件

安装

方式一：在 Claude Code 中安装插件（推荐）

/plugin marketplace add yanyan1115/ringringring
/plugin install ringringring@ringringring

安装时按提示填写 SIP 账号、密码与语音识别 key（未提示时可执行 /plugin configure ringringring@ringringring）。插件首次启动时自动下载并安装运行环境（实测约 15 秒），无需手动执行脚本。如服务器缺少系统包，插件启动失败并给出一条 sudo apt-get install … 命令，执行后在 /mcp 中重新连接即可。

方式二：手动安装

git clone https://github.com/yanyan1115/ringringring.git && cd ringringring
# 检查缺失的系统包（不做任何修改）
plugin-native/bin/install.sh --check
# 安装；加 --no-apt 则不调用 apt，仅列出缺失的包
plugin-native/bin/install.sh --pjsua2 https://github.com/yanyan1115/ringringring/releases/download/v0.1.0/pjsua2-2.17-linux-x86_64-cp311.tar.gz --src .

两种方式的安装目录均为 ~/.local/share/ringringring，配置文件为 ~/.config/ringringring/voice.env（权限 600）。

配置

以插件方式安装时，在安装提示中填写即可。也可编辑 ~/.config/ringringring/voice.env，至少填写以下各项（插件设置中已填写的项优先）：

export VOICE_SIP_ID="sip:<AI 账号>@sip.linphone.org"
export VOICE_SIP_USER="<AI 账号>"
export VOICE_SIP_PASS="<密码>"                       # 手动配置时凭据仅保存在此文件
export VOICE_SIP_CALLEE="sip:<手机账号>@sip.linphone.org"
export VOICE_DISPLAY_NAME="Claude"                   # 来电显示名称（部分手机不显示 emoji）
export VOICE_STT_KEY="<Groq key>"                    # 或以 VOICE_STT_ENV_FILE 指向单独的文件
export VOICE_STT_LANG="zh"

网络

无需放行端口：服务器先向外发送音频并借助 STUN 穿越 NAT，实测在安全组中拒绝 UDP 4000-4100 入站后，通话仍双向正常。如接通后听不到声音，先确认 Linphone 处于前台；仍无声音时，可尝试在防火墙或安全组中放行 UDP 4000-4100（RTP 音频）。

接入 AI

Claude Code

按上文「安装」方式一安装插件即可。也可以直接加载本地目录：claude --plugin-dir <仓库路径>/plugin-native。

加载后提供 call_start、converse、call_end 等工具，以及 phone-call skill（拨号、对话、挂断流程与隐私约定）。

OpenCode 及其他 MCP 客户端

将 plugin-native/bin/run-voice-native.sh 配置为 stdio MCP 服务器。AI 与电话服务不在同一主机时，可通过 SSH 在电话服务所在主机上启动该脚本。

替换语音识别与语音合成

语音识别（STT）：支持任意兼容 OpenAI /audio/transcriptions 接口的服务。

# 默认：Groq
export VOICE_STT_URL="https://api.groq.com/openai/v1/audio/transcriptions"
export VOICE_STT_MODEL="whisper-large-v3-turbo"
# OpenAI：
# export VOICE_STT_URL="https://api.openai.com/v1/audio/transcriptions"
# export VOICE_STT_MODEL="whisper-1"
export VOICE_STT_KEY="<key>"

语音合成（TTS）

# 默认：Microsoft Edge TTS（zh-CN-YunxiNeural）
export VOICE_TTS="edge"
# 自定义命令：{text} 替换为待合成文本，{out} 替换为输出音频路径。
# 命令不经 shell 执行，不支持管道与重定向；如有需要请封装为脚本。
# export VOICE_TTS_CMD="python3 my_tts.py --text {text} --out {out}"

iPhone 设置

1. 安装后先在前台接听一次，此后熄屏或后台状态均可来电。

2. 设置 → 辅助功能 → 触控 → 开启「防止锁定后结束通话」，避免通话中误触锁屏键挂断。

3. 不要将 AI 的号码存入通讯录，否则来电显示为通讯录名称而非 VOICE_DISPLAY_NAME。

常见问题

感谢

• Linphone：提供免费 SIP 账号与客户端。sip.linphone.org 仅承载信令，音频由服务器与手机直连（尚未抓包验证）。如使用量较大，建议支持 Linphone 或自建 SIP 服务器。

• Ringback（Apache 2.0）：本项目上游。

致谢

调研与构思：Cora 和 South；实现：Claude

许可证

AGPL-3.0-or-later。本项目派生自 Ringback，上游代码以 Apache 2.0 授权，原许可证与 NOTICE 保留于 LICENSE-APACHE-2.0 和 NOTICE。依赖的 pjproject 为 GPL-2.0-or-later。