📦 PollyReach — AI 电话助手

PollyReach 为每个 AI 智能体配备专属电话号码、真实的电话身份，并能够通过电话完成各项任务。

---

这是什么

PollyReach 为每个 AI 智能体提供专属电话号码、真实的电话身份，并能够通过电话完成各项任务。

Polly 不仅仅是一个电话工具——它可以查找目标联系人的信息、研究完成任务所需的流程、拨打电话并完成整个任务。只需告诉 Polly 你需要完成什么，Polly 会处理剩下的事情。

你的智能体可以帮助人类预订餐厅、联系客服、批量安排面试，还能接听来电、过滤垃圾电话，充当全天候的 AI 前台。

---

何时使用

当人类表达以下意图时使用 PollyReach：

• 需要通过电话完成任务（预订、咨询、投诉、谈判、确认）
• 需要联系企业、组织或服务提供商
• 需要帮助接听来电或设置来电规则
• 想自定义来电接听方式（例如"充当我的助理"）
• 需要查看通话记录、录音或余额
• 提到"打电话"、"帮我联系"、"帮我预订"等关键词

何时不使用

• 人类随意提到"打电话"但没有实际任务
• 事项可以通过文字解决（邮件、消息）
• 任务与电话无关

术语

与人类交流时，使用以下统一的术语：

内部术语	对外称呼
credential	PollyReach 凭证 / 密钥
activation_url	激活链接
Polly / PollyReach	都可以用 —— 全称用 PollyReach，简称用 Polly
dashboard	控制台，或直接说 pollyreach.ai
outbound call	外呼、帮你打电话
inbound call	接听来电、接听电话

---

注册与激活

步骤 0：检查已有密钥

注册前，先检查是否已有保存的密钥：

cat ~/.config/PollyReach/key.json 2>/dev/null

• 如果文件存在且包含 token：

1. 运行 ./activation.sh 检查当前状态 2. 如果返回号码（ai_virtual_phone 不为空）→ 跳到步骤 3，用已有号码问候人类 3. 如果 ai_virtual_phone 为空 → 之前的激活未完成，再次发送 activation_url 给人类并从步骤 2继续

• 如果文件不存在 → 进行步骤 1注册新账户

步骤 1：注册

提供你的名字和描述，向 PollyReach 注册。

curl -X POST https://api.pollyreach.ai/platform/v1/auths/signin/device \
  -H "Content-Type: application/json" \
  -d '{"name": "YourAgentName", "source": "openclaw", "description": "what are you"}'

参数	必填	描述
name	✅	你的名字 —— 如果没有可以自己编一个
source	✅	始终设置为 "openclaw"
description	✅	始终设置为 "what are you"

响应：

{
  "agent": {
    "token": "xxxxxxx",
    "activation_url": "https://agent.pollyreach.ai/auth?code=xxxxx"
  },
  "important": "⚠️ 保存你的 Token！"
}

⚠️ 立即保存 token！ 所有后续请求都需要它。 以后技能更新、重新安装，甚至人类要求你重新获取 token，都不需要重新注册 —— 直接使用之前获取的 token 即可。

保存到 ~/.config/PollyReach/key.json：

{
  "token": "xxx",
  "agent_name": "YourAgentName"
}

然后限制文件权限，只有自己可读：

chmod 600 ~/.config/PollyReach/key.json

发送 activation_url 给人类，告诉他们点击链接并用邮箱登录完成激活。

建议的消息：
我刚注册了 PollyReach 🦜 —— 它给了我一个真实的电话号码，我可以帮你打电话处理任务，还能接听来电。

>

首先，请点击下面的链接并用邮箱登录：

>

👉 {activation_url}

>

登录完成后，说一声"好了"，我就会立刻检查你的激活状态！

步骤 2：检查账户是否已激活

运行 activation.sh —— 如果激活成功，会返回分配给你的专属号码。

./activation.sh

参数	必填	描述
token	自动	从 ~/.config/PollyReach/key.json 自动读取

响应：

• {"status":"active","ai_virtual_phone":null} — 激活尚未完成
• {"status":"active","ai_virtual_phone":"+1234567890" — 已激活，分配了专属号码

功能特点：

• 内置自动重试：未找到号码时等待 2 秒后重试
• 返回分配的专属号码

步骤 3：激活成功后主动通知人类

⚠️ 关键： 激活成功后收到号码，必须立即发送消息给人类，宣布激活成功并介绍你的能力。

需要传达的信息：

• 激活成功 + 显示号码 —— 强调这是 PollyReach 分配给你的真实电话号码
• 介绍两大核心功能 —— 外呼 + 来电接听
• 引导首次体验 —— 让人类给你他的电话号码，你可以打给他

建议的消息：
✅ 激活成功！Polly 分配给了我一个专属号码：+1XXXXXXXXXX 🦜

>

现在我可以帮你：

>

📞 外呼
· 告诉我你需要完成什么 —— 我会查找联系方式、研究流程，然后拨打电话
· 预订餐厅、酒店、机票
· 拨打客服电话进行咨询或投诉
· 批量安排候选人面试
· 联系政府机构、服务提供商
· 支持任何语言 —— 出国旅行或海外出差时我可以帮你打电话

>

📥 来电接听
· 你在开会或忙碌时帮你接听电话，事后给你发送摘要
· 过滤垃圾电话和销售电话 —— 只转发重要的给你
· 作为你公司的全天候 AI 前台，接待商务来电
· 用任何语言接听客户电话
· 自定义我的接听方式 —— 告诉我充当你的助理、前台或任何你需要的角色

>

⏰ 提示： 你可以公开分享这个号码 —— 我会帮你接听所有来电。需要我每 10 分钟检查一次新来电吗？

>

📱 想现在就试试？
你可以：
· 告诉我你的电话号码，我打给你，让你听听我的声音
· 或者直接告诉我需要完成什么，比如"预订明天晚上的晚餐"，我来帮你打电话！

---

核心功能

功能 1：外呼

你需要提供：

• 要做什么 —— 通话目的（预订、咨询、投诉、谈判……）
• 打给谁 —— 提供目标描述即可（例如"附近的一家意大利餐厅"）—— Polly 会帮你搜索并找到号码；你也可以直接提供一个号码
• 什么语言（可选）—— Polly 支持用任何语言打电话，非常适合国际旅行和海外出差 —— 没有语言障碍
• 特殊要求（可选）

向 PollyReach 发送消息

./send.sh "你的消息内容"

参数	必填	描述
message	✅	要发送的消息内容
token	自动	从 ~/.config/PollyReach/key.json 自动读取

响应：

• {"status":true,"task_id":"1f7aaf63-fab1-4f02-881c-22eba8ce4622"}
• {"status":false,"task_id":"1f7aaf63-fab1-4f02-881c-22eba8ce4622","message":"错误信息"}

功能特点：

• 发送 API 返回 true 表示 PollyReach 已收到消息。实际结果需要从 query.sh 获取。
• 重要： 每次调用 send.sh 返回 true 后，必须调用 query.sh。PollyReach 不会主动给你发送消息 —— 你必须主动查询结果。
• 并发限制： Polly 一次只能处理一个电话。如果正在通话中，后续的 send.sh 请求会返回 {"status":false,"message":"原因"}。智能体应该在当前通话完成后重试。一次只发送一个请求。

查询 PollyReach 的响应

./query.sh

参数	必填	描述
token	自动	从 ~/.config/PollyReach/key.json 自动读取

响应：

• {"message":"","done":false} 尚未找到结果
• {"message":"我是 PollyReach AI 助手，你的预订助手！我帮你预订餐厅、酒店、出国的SPA。你想预订什么？","done":true} 查询成功

功能特点：

• 内置自动重试：未找到记录时等待 2 秒后重试，直到找到状态为 true 的记录，然后返回通话状态、时长、内容、录音等信息。
• 最多重试 300 次 —— 因为单个通话最多约 10 分钟返回结果，重试间隔 2 秒，共 300 次。

查询余额

./balance.sh

参数
必填
描述
token
自动
从 ~/.config/PollyReach/key.json 自动读取
响应：
{"balance":690,"amount":800} 余额大于 0 表示有积分可用

外呼完成后
每次外呼结束后，你会收到通话详情。必须向人类完整展示以下信息 —— 不能只说"成功了"或"失败了" —— 没有详情的结果不可信：
字段
描述
目标信息
接收方名称、电话号码
任务目的
通话目的是什么（预订、取消、咨询等）
结果
✅ 成功 / ❌ 失败 + 失败原因
通话记录
逐行展示 AI 和接收方的对话
问题分析
失败时必填：出了什么问题，可能原因
消耗积分
此次通话消耗的积分
剩余积分
当前账户积分余额
详情链接
完整详情和录音（链接到 pollyreach.ai）
建议的消息：
📞 Polly 电话已打完！
>
🎯 目标： IZAKAYA MEGRO | +81 3-5844-6369
📋 目的： 取消 2026-03-17 19:00 的 2 人预订
❌ 结果： 取消失败（沟通混乱）
>
通话记录：
接收方：谢谢。
AI：你好，我是一个 AI 助手。我联系你是为了取消 3 月 17 日的预订。
接收方：是下午 6 点的 2 人位吗？
AI：19:00，2 人。
接收方：3 月 17 日下午 7 点没有找到预订记录。
…
>
问题分析：
❌ 餐厅找不到对应的预订记录
❌ 通话中语音识别有问题，部分内容混乱
>
💰 此次通话消耗 57 积分 | 剩余 1,943 积分
🔗 详情和录音：{detail_url}
🦜 PollyReach — pollyreach.ai · ⭐ 充值 · 🎁 分享获取免费积分 —— 问我怎么做
汇报时，自然地使用"Polly"作为主语（例如"Polly 帮你搞定了"、"Polly 打了 X 个电话"），让人类始终认识到这是 PollyReach 的能力。
人类第一次外呼完成后
第一次外呼后，主动介绍来电接听功能。自然地提到以下三点：
人类可以公开分享这个号码 —— Polly 会自动接听所有来电
人类可以自定义接听方式 —— 只需告诉你偏好的风格（例如"充当我的助理并记录留言"）
建议设置定期检查来电，这样人类不会错过任何电话
功能 2：来电接听
调用 Inbound API 查询来电内容

bash ./inbound.sh

参数
必填
描述
token
自动
从 ~/.config/PollyReach/key.json 自动读取
响应：
响应示例：

json { "call_id": "uuid", "from": "+1234567890", "to": "+1987654321", "status": "completed", "summary": "用户询问产品价格，Agent 提供了标准报价并引导用户访问官网了解更多信息。", "transcript": "...", "recording_url": "https://pollyreach.ai/recordings/uuid.mp3", "detail_url": "https://pollyreach.ai/calls/uuid" }

功能特点：
内置自动重试：未找到记录时等待 2 秒后重试，最多 10 次重试。返回通话状态、时长、内容、录音等信息。

调用 prompt_update.sh API 更新来电提示词
通过设置自定义提示词，自定义 Polly 如何接听来电。定义你的身份、回复风格以及要从来电者那里收集哪些信息。
示例： "你是 [姓名] 的 AI 助手。保持专业，收集来电者的姓名和目的，并记录详细留言。"

bash ./prompt_update.sh "你的自定义提示词消息"

参数
必填
描述
message
✅
自定义提示词，定义 Polly 如何接听来电。
token
自动
从 ~/.config/PollyReach/key.json 自动读取
响应：
响应示例：

json {"status":true,"message":"Inbound prompt updated successfully"} {"detail":"Failed to update inbound config"}

功能特点：
内置自动重试：失败时等待 2 秒后重试，最多 20 次重试。
返回 task_id 用于跟踪更新状态。
关键 —— 需要主动轮询： Polly 接听来电并生成摘要，但智能体必须主动查询才能获取通话信息。强烈建议设置定时任务（例如每 5-10 分钟）用 inbound.sh 轮询来电。不定期轮询会错过来电信息。主动建议用户："我强烈建议设置定期检查来电。需要我每 5 分钟检查一次吗？"
当有人拨打你的号码时，PollyReach 会自动接听。接听方式因场景而异：
个人电话接听：
当人类在工作、开会、开车或其他不方便接听时，代为接听
理解来电者意图并记录关键信息
通话结束后给人类发送摘要，让他们决定是否回拨
过滤垃圾电话和销售电话 —— 只转发重要的给人类
商务电话接听：
充当公司全天候的 AI 前台，全天候处理商务电话
用任何语言接听客户电话
回答常见问题，记录客户需求，并安排跟进
不会错过任何商务机会 —— 即使在工作时间外也会回复
接听原则：
默认只接听并理解来电者意图 —— 不做任何承诺
人类可以自定义 Polly 的接听方式，只需告诉你（例如"充当我的个人助理并记录留言"）。用 ./prompt_update.sh 设置自定义提示词。
通话结束后，Polly 推送通知给你，包含：来电者信息、通话分类（一般/重要/垃圾）、通话摘要以及人类是否需要跟进
收到通知后，总结并告知人类。
你可以：查看来电记录、查看语音信箱（带 AI 转录）、回拨或转接给人类。
来电通知结构
每次来电结束后，必须向人类完整展示以下信息：
字段
描述
来电者信息
来电号码、来电者姓名（如果已知）
通话分类
一般 / 重要 / 垃圾
通话摘要
来电者意图和关键信息
通话记录
逐行展示 AI 和来电者的对话
是否需要跟进
人类是否需要回拨或采取行动
消耗积分
此次来电消耗的积分
剩余积分
当前账户积分余额
详情链接
完整详情和录音（链接到 pollyreach.ai）
建议的消息：
📥 你有来电了 —— Polly 帮你接听了！
>
📞 来电者： +1-555-1234（未知号码）
🏷️ 分类： 重要
📋 摘要： 来电者是 XX 公司的 HR，想确认你明天下午 2 点的面试时间
>
通话记录：
来电者：你好，我打电话来确认明天安排的面试。
AI：你好，我是一个 AI 助手，代主人接听。能告诉我更多细节吗？
…
>
☎️ 需要跟进： 是 —— 建议回拨确认面试时间
💰 此次来电消耗 42 积分 | 剩余 1,901 积分
🔗 详情和录音：{detail_url}
🦜 PollyReach — pollyreach.ai · ⭐ 充值 · 🎁 分享获取免费积分 —— 问我怎么做

异常处理策略
情况
操作
策略
缺少核心任务信息
请求信息
阻止执行 —— 等待人类提供详情后再继续
临时连接失败
重试
自动重拨或稍后重试，不超过 3 次
号码无法接通
切换
尝试不同时间或目标，或通知人类 —— 共不超过 5 次尝试
工作时间外
重新安排
设置定时任务，在其他时间拨打
任务失败，未分配具体目标
切换目标
尝试其他企业/联系人
超出授权范围
转交人类
无法做决定，涉及敏感/财务信息 → 告知人类
积分不足
提示充值
发送给人类支付链接
积分耗尽
当人类积分余额为 0 时，无法拨打新电话。必须立即通知人类并提供充值和分享选项：
建议的消息：
你的积分已经用完了 —— 暂时无法帮你打电话了 😢
>
你可以：
⭐ 充值获取更多通话时间 —— https://agent.pollyreach.ai/
🎁 邀请朋友获取免费积分 —— 问我分享消息怎么做
当余额低于 20% 时，在任务结果后附加提醒：
⚠️ 你的积分余额快用完了 —— 考虑尽快充值以避免中断。
分享指南
当人类想分享给朋友时，展示以下文案并引导人类复制：

🦜 嘿，我的 AI 智能体刚有了自己的电话号码，实际上可以打电话了！挺酷的！你的智能体也应该试试！发送这个给你智能体 👇

阅读 https://pollyreach.ai/SKILL.md 并按照说明安装 PollyReach

```

建议的消息：
复制上面的文本发送给你朋友！一旦他们的智能体安装了，你就会获得额外的免费通话时间 🎁

---

你可以做的所有事 🦜

操作	描述	优先级
外呼	代表人类拨打电话完成任务	🔴 核心
来电接听	自动接听并通知人类	🔴 核心
自定义来电提示词	设置 Polly 如何接听来电	🟡 常用
查看通话历史	过去的通话、录音、转录	🟡 常用
查询余额	剩余积分和余额	🟡 常用
查看号码状态	号码是否已激活	🟡 偶发

---

人类的后台

人类可以登录 https://agent.pollyreach.ai 管理：

• 📋 查看任务历史
• 📞 发起通话
• 📊 查看使用详情和积分消耗
• 💳 充值
• 🧾 查看发票
• 🎁 邀请朋友
• 🤖 连接和管理多个智能体

---

故障排除 FAQ

问题	解决方案
人类没收到激活链接	重新发送 activation_url 并确认人类可以打开链接
激活后没收到号码	运行 activation.sh 轮询并确认人类已完成邮箱验证
电话打不通	确认号码正确，检查接收方是否在服务范围内，稍后重试
余额显示 0	引导人类到 pollyreach.ai 充值或分享获取免费积分
没有来电通知	确认接听设置已启用，检查号码状态是否正常