agentring - 让 AI 代理在需要决策时给你的手机打电话

agentring 是一个自托管的开源项目，目标是解决 AI 编码代理「找不到人」的问题：当代理需要你做一个决定、卡在某个环节，或者跑完一个长任务时，它可以主动给你的手机打一通电话，而不是把结果埋在终端日志里。据项目自述，通话由语音 AI 说明当前情况、回答你的追问，挂断后把对话记录交还给代理，代理据此继续执行。反向也成立：你可以从 App 里主动呼叫自己的代理，用语音向它提问。它适合已经在用 Claude Code、Codex、opencode 等命令行代理，并且希望在人不在电脑前时仍能介入的人。

维护者与状态

项目由 mutonby 维护，仓库创建于 2026-10-23，最后一次提交在 2026-11-11。最新正式发布为 v0.2.0（2026-10-28）。截至 2026-11-12，仓库获得 387 个星标。项目自述明确标注为预发布（Pre-release）状态：消息、锁屏状态下的来电、语音 AI、从 App 呼叫代理以及 MCP 服务器均已可用，但到目前为止只在一台手机（Pixel 6，Android 16）上测试过，且仅支持 Android。

主要能力

以下能力来自项目 README 的自述，未经本站独立验证。

• 代理主动触达你：代理可以发送消息、等待回复或直接发起呼叫，对应 send_message、get_replies、call 三个动作。通话中语音 AI 解释来电原因、回答你的问题，并把转录文本交回代理。
• 你主动触达代理：在 App 中点「Call agent」即可发起通话。语音 AI 可以在通话过程中向你的代理求助；如果某个代理响应慢，通话不会中断，答案准备好后再送达，若你已挂断则转为消息。
• 未接来电不丢：错过的来电会转成一条消息，可以直接从通知里回复。
• 与代理框架解耦：任何支持 MCP 的代理都能触达你，任何能以命令方式运行的程序都能在通话中被咨询。README 给出的对应关系包括 Claude Code、Codex、opencode、Grok Build、OpenClaw、Hermes，以及 n8n、脚本和任何具备 HTTP 能力的程序（通过 REST API 或 CLI）。
• 语音后端可选：默认使用 Gemini Live（含免费额度），也可切换 OpenAI Realtime、Grok Voice（xAI）、Phonic，或通过 --provider local 使用自建服务（项目称该模式为实验性且更慢）。

项目自述的典型用法包括「跑迁移，出错就打电话给我」「部署前先问我」「开车时问 CI 结果如何」，以及每天与助手通一次话过一遍收件箱。

使用入口

代码与文档位于 mutonby/agentring，托管版本的入口是 agentring.io。

据项目说明，自托管需要准备：一台带域名的 Linux 服务器（或本机，手机在同一 Wi-Fi 或通过 Tailscale 连接）运行 relay；一个免费的 Firebase 项目，用于让锁屏手机响铃；一个语音 AI 的密钥；以及一台 Android 手机。README 给出的流程大致为三步：在 deploy 目录配置并启动 Docker Compose；在运行代理的机器上安装 daemon 并初始化、配对（uv tool install './daemon[voice]'、agentring init、agentring pair 扫码）；最后把 MCP 服务器接入代理，例如 claude mcp add agentring -- agentring mcp。OpenClaw 与 Hermes 可用 agentring connect openclaw / agentring connect hermes 一条命令完成接入。

架构上分为四部分：relay（TypeScript，负责配对、消息、通话状态、推送与 LiveKit 令牌）、LiveKit（承载通话音频，与 relay 在同一 compose 文件中自托管）、daemon（Python，提供 CLI、MCP 服务器与语音 AI，可运行在 NAT 之后）、Android App（Kotlin，负责扫码配对、原生通话界面与消息）。

许可与限制

许可证为 Apache-2.0。

项目自述的已知限制包括：仅支持 Android，暂无 iOS；Android Auto 处于 beta 阶段，且只存在于 Releases 中的 APK，因为 Google Play 目前不允许面向汽车的通话类应用进入正式发布；每个 relay 只支持一个用户，没有账号体系；语音 AI 在云端实时模型（Gemini、OpenAI、Grok、Phonic）下效果最好，本地模式为实验性且更慢。

隐私方面，README 说明消息与通话元数据存放在你自己的 relay 上，推送经由你自己的 Firebase 项目，推送内容经过签名但未加密，因此 FCM 可以读取推送文本；通话音频经过你的 LiveKit 服务器，使用语音 AI 时还会发送给你选择的提供商，在 Google 免费额度下 Google 可能将数据用于改进产品。项目还提醒，语音 AI 会依据听到的内容行动，因此只应授予你愿意交给「拿着你手机的人」的工具与代理。