前言¶
在 Agent 或 Claw 里做外呼，常见做法是手写外呼脚本、对接语音平台 API，再单独维护 Bot 人设、通话流程和合规约束。需求一变就要改配置或改代码，试用和生产账号、号码资源也要自己串起来。
下面介绍 SkillHub 社区 Skill「Vox 自定义电话 Bot」（坐标 @user_caf52609/vox-custom-phone-agent，当前版本 v1.0.9）。它面向 Agent/Claw，用自然语言描述「打给谁、什么身份、完成什么目标、用什么音色」，由 Skill 解析并生成 Vox agent_profile，再调用 Vox 外呼能力完成试用或正式外呼。
这是什么¶
Vox 电话 Bot 试用助手（页面名称：Vox 自定义电话 Bot）是社区发布（来源：community）、分类为 ai-agent 的智能外呼 Skill，发布者为 user_caf52609。标签标明 requires_api_key=true，正式接入需配置 Vox 凭证。
一句话定位：在对话里用自然语言创建自定义电话 Bot，并发起真实电话外呼；底层基于 Vox botType=custom，由 Vox custom bot 按生成的 agent_profile 执行对话。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_caf52609/vox-custom-phone-agent
- 资料地址：https://api.skillhub.cn/user_caf52609/vox-custom-phone-agent
核心功能¶
以下能力均来自 SkillHub 页面与已抓取简介，未单独展开的实现细节不臆测。
-
自然语言建 Bot
用户描述被叫号码、Bot 角色、业务目标、音色等；Skill 自动解析手机号、角色、目标、通话流程、约束与音色，生成完整 Voxagent_profile。 -
真实外呼
生成配置后调用 Vox 外呼能力；试用可走内置试用能力，正式环境使用企业账号的VOX_APP_ID/VOX_SECRET、外呼额度与号码资源。 -
复杂场景补全
售后、聊天、健康等需要更多背景时，Skill 会追问业务背景、可聊话题、禁止事项、处理边界和结束条件，减少空泛或不安全的任务。 -
配套能力
音色选择、业务背景补全、安全合规拦截、任务 briefing、callTask标准输出、WorkBuddy 友好摘要、试用额度展示、正式注册引导。 -
模式
- 推广试用：内置试用，体验单次外呼后引导注册 Vox 企业账号。
- 正式账号：使用专属VOX_APP_ID/VOX_SECRET与生产接入能力。 -
明确不包含
当前版本不包含实时 SSE 通话接管。
安装与启用¶
SkillHub 页面给出的安装方式，是让当前 AI 按统一安装文档处理指定坐标（Cursor、Claude Code、Codex 等 Agent 共用同一套 SkillHub CLI 与目录约定，差异主要在 --dir 指向的路径）。
方式一：提示词安装（页面原文）
把下面整段发给已支持 Skill 安装的 Agent：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_caf52609/vox-custom-phone-agent`。
方式二：SkillHub CLI
先确认 CLI 是否已安装（文档要求安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能无法被识别）：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行完整安装或仅 CLI（需联网）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 到对应 Agent 目录（将 <skills 目录> 换成你当前环境的路径）：
skillhub install user_caf52609/vox-custom-phone-agent --dir <skills 目录>
安装文档中列出的常用 skills 目录示例：
| Agent | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| workbuddy | ~/.workbuddy/skills/ |
凭证与 API Key
- 标签
requires_api_key=true：正式外呼需 Vox 企业账号的VOX_APP_ID、VOX_SECRET（试用完成后页面说明会引导注册获取）。 - 具体环境变量名与填写位置以安装后的
SKILL.md及 Agent 侧配置为准；本文仅记录官方简介中出现的字段名。
典型用法¶
官方未提供独立脚本示例，用法以「自然语言任务描述 + Skill 自动结构化」为主。可按页面说明组织一次外呼请求，包含四类信息：
- 给谁打电话（手机号，由 Skill 解析）
- 以什么身份（Bot 角色）
- 要完成什么目标（业务目标与通话流程）
- 使用什么音色（音色配置）
示例表述（示意，非官方逐字范例）：
请用偏稳重的男声，以公司活动助理身份，给 13800138000 打电话，邀请对方参加本周六下午的产品体验会，说明时间地点，对方犹豫时只补充议程与报名方式，不要承诺优惠，通话在对方确认「收到」后结束。
经过上面的步骤，Skill 应生成 agent_profile、输出 briefing / callTask 等标准结构，并走试用或正式外呼链路。售后、健康、闲聊类任务若信息不足，Agent 会先按 Skill 规则追问背景与边界，再发起呼叫。
适用场景与注意¶
适用场景（官方列举）：会议通知、活动邀请、售后回访、满意度调查、课程/产品邀约、招聘/面试通知、健康/体检提醒、商务沟通、聊天关怀等。
适合谁
- 已在 Cursor、Claw 生态或 SkillHub 上跑 Agent，需要快速验证「AI 外呼」而不是从零对接语音 API 的团队或个人。
- 愿意先试用内置额度，再按需注册 Vox 企业账号做生产的用户。
限制与注意
- 执行模型为 Vox custom bot +
agent_profile，不能用本 Skill 做实时 SSE 人工接管通话。 - 外呼涉及真实号码与合规，应依赖 Skill 内的安全合规拦截，并在业务侧准备好禁止事项与结束条件（复杂场景应配合 Skill 的追问流程）。
- 试用与正式账号能力、额度以 Vox 侧及 Skill 内引导为准；生产接入前需完成注册并配置
VOX_APP_ID/VOX_SECRET。 - SkillHub 页面显示版本 v1.0.9、分类
ai-agent；下载量等统计以 SkillHub 实时展示为准（抓取时曾为下载 854、评分 100000）。
结尾¶
Vox 自定义电话 Bot 把「外呼 Bot 配置 + 发起真实通话」收敛成 Agent 里的一段自然语言任务：自动产出 agent_profile 与 callTask，区分试用与正式账号，并针对高敏感场景补全背景与边界。若你要在 Agent 里试智能外呼，可从官方 SkillHub 页面安装坐标 @user_caf52609/vox-custom-phone-agent：
https://www.skillhub.cn/skills/user_caf52609/vox-custom-phone-agent
