← 返回列表

新工具 GitHub · mutonby/agentring

用 agentring 让 AI Agent 打电话给你的手机，口头汇报并取回转录

Agent 需要决策或长任务结束时，让你的 Android 手机像真来电一样响，语音 AI 讲清情况、你口头回复，Agent 拿到转录继续干活。

开始尝试

效果

README 内有 demo 视频与无声版 demo.gif，展示 Claude Code 迁移失败时打电话给锁屏 Pixel 6 并由语音对话继续流程的画面；另附架构图。

这是什么

新在哪里：以前 Agent 需要你时只能发终端或聊天通知，你得回到电脑前看；现在它能自托管发起 VoIP 来电，锁屏也能响，用语音和你对话并把转录带回。

怎么做到的：在服务器或本机用 Docker Compose 起 relay 与 LiveKit，建一个免费 Firebase 项目负责锁屏推送；在跑 Agent 的机器上 uv 安装 daemon，用 agentring init 配好 relay 与 API key，agentring pair 扫码配对 App；给 Agent 挂上 agentring MCP 或改用 CLI，Agent 便可调用 send_message、get_replies、call，由 Gemini Live 语音 AI 现场解释并回传转录。

适合谁
手上有 Android 手机、能跑 Docker 和命令行、常用 Claude Code / Codex 等 Agent 并希望随时被叫到的开发者。
能帮你
把 Agent 的「找你」变成一通真实来电，让用户离开电脑也能口头介入长任务并留下转录。

评分 三项分开看，不合成总分；热度不等于好用

新颖性
全新做法 · 2026-10-23 出现
热度
未知
易上手
门槛较高
怎么评的

三项都由本站记录的事实按固定规则算出，编辑不能直接改档位；规则改动会写进更新说明。

新颖性

  • ●●● 全新做法，且有来源依据的出现时间在最近 30 天内
  • ●●○ 老工具新用法或近期刚开放，且有来源依据的时间在最近 30 天内
  • ●○○ 出现时间超过 30 天、未核实到精确日期，或已不再是新做法
  • 其他 出现时间未核实、晚于今天，或新颖类型未核实时按最低一档处理，不靠猜测加分

热度

  • ●●● 最近一次每周人工确认为“热门”：最近 14 天里独立讨论、实际案例、持续时间、传播平台、相对关注五项门槛全部满足（规则 heat-v1）
  • ●●○ 最近一次人工确认为“观察中”：前三项至少一项达到，或讨论增长 ≥ 50%，且至少 2 个独立案例
  • ●○○ 最近一次人工确认为“未进入跟踪”
  • 其他 还没有人工确认过的热度记录时显示“未知”。热度只统计本站已接入的信源，不代表全网

易上手

  • ●●● 准备门槛低且难度入门：不需要新账号或付费，首次尝试不超过 30 分钟，公开可用，会复制粘贴即可
  • ●●○ 准备门槛中等，或门槛低但需要改少量代码或配置
  • ●○○ 准备门槛高：需要商业软件或付费服务、首次尝试超过 2 小时、特殊硬件或网络、排队或邀请且无替代方案，或需要专业知识
  • 其他 只有介绍、还没有站内步骤，或关键步骤已失效时显示“暂不可试”；门槛未核实时显示“未核实”

怎么尝试

  • 时间 首次约 60 分钟
  • 费用 免费：项目为 Apache-2.0 开源自托管，README 写明无电话号码、无 Twilio、无按分钟费用；Gemini API key 可走免费层，Firebase 用免费项目。
  • 账号 不需要新账号
  • 环境 Linux 服务器（Docker、域名，开放 80/443、UDP 50000-50100、TCP 7881）或本机 Docker；跑 Agent 的机器需 Python/uv；Android 手机；浏览器创建 Firebase 与 Gemini 项目。
  • 准备 Docker 运行环境：运行 relay、LiveKit 的 compose 服务
  • 准备 域名或局域网/Tailscale 网络：手机访问 relay
  • 准备 Firebase 免费项目：FCM 推送，让锁屏手机响铃
  • 准备 Gemini API key：驱动语音 AI 对话
  • 准备 Android 手机：安装 App、扫码配对、接听来电
  • 准备 uv / Python 环境：安装 daemon 与 agentring CLI、MCP server
  • 准备 Claude Code 等 Agent（选用）：作为被呼叫方，通过 MCP 或 CLI 接入

替代方案：桌面通知 / 聊天机器人消息。能做到：不接电话也能用终端通知或 IM 机器人把 Agent 的求助推送给你；差别：需要回到电脑或打开聊天窗口打字回复，无法在锁屏状态下像接电话一样口头对话。

完成替代方案不算复现本实践。

按下面的步骤就能做出第一个结果。复制命令不会自动执行。

  1. 起 relay 与 LiveKit

    在服务器上复制环境变量并启动 compose 服务（需开放 80、443、UDP 50000-50100、TCP 7881）；也可在本机用 local compose 在局域网或 Tailscale IP 上运行。

    终端原始来源命令 
    cd deploy && cp .env.example .env && $EDITOR .env && docker compose up -d --build

    预期结果：docker compose 构建并拉起 relay、LiveKit 等容器

  2. 取回 API key

    从 relay 日志里找到 API key 并记下。

    终端原始来源命令 
    docker compose logs relay | grep -A2 " API key "

    预期结果：日志输出配对用的 API key

  3. 安装 daemon 并初始化

    在跑 Agent 的机器上安装带语音支持的 daemon，用 relay 地址和 API key 初始化。

    终端原始来源命令 
    uv tool install ' ./daemon[voice] '

    预期结果：agentring 命令可用

  4. 配对手机

    用 Releases 下载的 Android App 扫 agentring pair 显示的二维码完成配对。

    终端原始来源命令 
    agentring pair

    预期结果：终端显示二维码，App 扫码后配对成功

  5. 先发一条消息确认通路

    发送测试消息，确认手机能收到通知。

    终端原始来源命令 
    agentring msg " hello "

    预期结果：手机收到通知

  6. 打通语音通话并接入 Agent

    配置 Gemini key 后发起带语音 AI 的测试通话；再把 agentring 挂到 Claude Code 的 MCP 上，让 Agent 能主动 call 你。

    终端原始来源命令 
    agentring call " Testing agentring " --ai

    预期结果：手机以来电形式响铃，语音 AI 说明情况，通话结束后得到转录

原始来源：mutonby/agentring ↗