📞 电话呼叫技能 (Phone Call Skill)

🤖 让 AI 助手自动打电话！ 支持阿里云、腾讯云等主流语音服务商，实现文字转语音（TTS）自动外呼。

---

✨ 功能特性

特性	描述
🤖 AI 集成	可作为 OpenClaw/Claude 等 AI 助手的技能
📱 语音外呼	自动拨打指定电话号码
🔊 文字转语音	输入文字，自动转换为语音播报
☁️ 多服务商	支持阿里云、腾讯云等主流服务商
🛠️ 简单易用	一条命令完成呼叫
🔒 安全可靠	环境变量隔离，不泄露密钥

---

🚀 快速开始

1️⃣ 安装

# 克隆仓库
git clone https://github.com/dadou-dev/phone-call-skill.git

# 进入目录
cd phone-call-skill

# 检查 Python 版本（需要 3.8+）
python3 --version

2️⃣ 配置服务商

阿里云（推荐）：

# 编辑环境变量
export ALIYUN_ACCESS_KEY_ID=your_access_key_id
export ALIYUN_ACCESS_KEY_SECRET=your_access_key_secret
export ALIYUN_APP_KEY=your_app_key

腾讯云：

export TENCENT_SECRET_ID=your_secret_id
export TENCENT_SECRET_KEY=your_secret_key
export TENCENT_APP_ID=your_app_id

💡 提示：也可以复制 .env.example 为 .env 文件，填入配置后使用 source .env 加载。

3️⃣ 检查配置

python3 scripts/phone_call.py check --provider aliyun

4️⃣ 拨打电话

python3 scripts/phone_call.py call \
  --to 13501074767 \
  --text "您好，这是一条测试语音通知" \
  --provider aliyun

---

📋 命令参考

命令	说明	示例
check	检查配置	python3 scripts/phone_call.py check --provider aliyun
call	拨打电话	python3 scripts/phone_call.py call --to 13800138000 --text "您好" --provider aliyun

call 命令参数：

参数	必填	说明
--to	✅	目标电话号码（中国大陆手机号）
--text	✅	呼叫内容（将转换为语音）
--provider	❌	服务商，默认 aliyun
--template-id	❌	预置语音模板 ID（可选）

---

💡 使用场景

场景	示例
📅 提醒通知	会议提醒、预约提醒、生日祝福
📦 业务通知	订单状态、物流信息、付款提醒
📞 客户服务	回访、满意度调查、会员关怀
🚨 紧急通知	系统告警、突发事件、安全提醒
👨‍👩‍👧 个人使用	给家人打电话、日常问候

---

📖 详细文档

• 📘 AI 技能使用：SKILL.md
• 📦 GitHub 发布指南：GITHUB_GUIDE.md

服务商官方文档：

• 阿里云语音交互
• 腾讯云语音通知
• 容联云通讯

---

🛠️ 开发

目录结构

phone-call-skill/
├── README.md              # 本文件
├── SKILL.md               # AI 技能使用说明
├── LICENSE                # MIT 许可证
├── .env.example           # 环境变量配置示例
├── .gitignore             # Git 忽略配置
├── requirements.txt       # Python 依赖
├── GITHUB_GUIDE.md        # GitHub 发布指南
├── scripts/
│   └── phone_call.py      # 主脚本
└── references/
    └── api_docs.md        # API 文档参考（可选）

测试

# 检查配置
python3 scripts/phone_call.py check --provider aliyun

# 测试呼叫（请替换为真实号码）
python3 scripts/phone_call.py call --to YOUR_PHONE --text "测试" --provider aliyun

---

⚠️ 注意事项

项目	说明
企业资质	大部分语音服务需要企业实名认证
防骚扰限制	单个号码呼叫频率有限制
费用	按分钟计费（约 0.08-0.15 元/分钟）
合规使用	不得用于营销骚扰、诈骗等违法用途
呼叫时间	建议在工作时间（9:00-21:00）呼叫

---

🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

---

📄 许可证

MIT License - 详见 LICENSE 文件

---

📬 联系方式

• 作者：大豆
• 问题反馈：提交 Issue

---

🌟 觉得有用？

如果觉得这个项目对你有帮助，欢迎：

• ⭐ Star 支持一下
• 📢 分享给需要的朋友
• 💡 提交建议和改进

---

⚠️ 免责声明：本技能仅供学习和技术研究使用。请遵守当地法律法规，不得用于骚扰、诈骗等违法用途。使用者自行承担全部责任。