短信服务Skill操作手册

核心技能

核心优势

• 对话式完成短信发送：无需频繁进入控制台，可直接在Claude Code、Qoderwork、悟空、OpenClaw等Agent工具中，通过自然语言完成签名查询、模板查询和短信发送。

• 降低号码文件整理成本：传统群发方式对号码文件和变量格式要求较高，格式不符可能导致任务失败。使用Skill后，只需提供本地号码文件位置，Agent可解析Excel、TXT、CSV等文件，并辅助完成变量匹配。

• 自动汇总发送结果：Skill支持发送完成后返回成功数、失败数和失败原因分类，也支持按时间、签名、模板等维度查询发送记录和统计数据。

• 支持灵活数据分析：相比控制台固定筛选维度，Skill可支持自然语言指定统计口径，例如“最近三天按签名汇总”“上周vs本周对比”“本月发送成功率趋势”等。

官方技能安装（推荐）

进入AI工具首页，单击技能，在技能广场中搜索“阿里云短信服务”，一键安装。

Qoderwork

1. 打开Qoderwork，单击技能进入技能广场。

2. 搜索“阿里云短信服务”，单击安装。

3. 安装完成后，确认技能状态为已启用。

手动上传安装

当技能广场未上架短信服务Skill或需要离线安装时，通过以下步骤手动安装。

通用步骤

1. 在阿里云技能平台下载短信服务技能压缩包alibabacloud-sms-send.zip。

2. 在AI工具的技能中心上传技能压缩包。

3. 验证技能状态是否已启用。

以下是各工具的具体操作说明。

安装运行环境

选中短信服务Skill后咨询日常问题，若缺少本地环境配置，AI工具会自动安装所需环境。

配置阿里云账号AccessKey

运行环境安装完成后，配置AccessKey以授权Skill访问短信服务API。

1. 获取AccessKey ID和AccessKey Secret。

   登录RAM访问控制中心，在目标子用户的详情页中创建或查看AccessKey。详情请参见创建AccessKey。

2. 打开终端（Terminal），执行以下命令打开配置文件：

   open ~/.aliyun/config.json

3. 将AccessKey填入配置文件，示例如下：

   {
     "current": "default",
     "profiles": [
       {
         "name": "default",
         "mode": "AK",
         "access_key_id": "<your_access_key_id>",
         "access_key_secret": "<your_access_key_secret>",
         "region_id": "cn-hangzhou",
         "output_format": "json",
         "language": "en",
         "site": "china",
         "auto_plugin_install": true
       }
     ],
     "meta_path": ""
   }

   将<your_access_key_id>和<your_access_key_secret>替换为实际的AccessKey ID和AccessKey Secret。

4. 保存配置文件。

验证配置

配置完成后，在AI工具中向短信服务Skill发送“查询我的签名列表”。若返回签名数据，则配置成功；若提示认证失败，请检查AccessKey是否正确填写以及RAM子账号是否已授权AliyunDysmsFullAccess权限。

支持的操作

• 对话式查询资质、签名和模板详情，获取可用的签名和模板。

• 自动单次或批量发送短信，可读取本地文件解析发送手机号和变量。

• 查询发送详情，解析失败原因。

• 多维度分析统计近3年的发送数据。

典型使用场景

短信服务Skill支持哪些AI Agent工具？

目前支持Claude Code、Cursor、OpenClaw、Qoderwork、悟空等遵循Agent Skills标准的工具。更多平台持续接入中。

Skill和控制台的能力有什么区别？

Skill当前支持发送短信、查询资质/签名/模板、查询发送记录和统计数据。资费查询、套餐包管理、审核加急等功能暂不支持，仍需通过控制台操作。

没注册账号，可以发短信吗？

不可以。需要注册阿里云账号，并开通短信服务，且已有审核通过的资质、签名和模板才可发送短信。

个人用户可以使用吗？

短信发送需要企业资质。个人用户如果有企业信息，可创建他用企业资质；不支持个人资质发送短信。

号码文件必须按控制台模板整理吗？

不需要。可使用Excel、TXT、CSV等本地文件，只要文件中包含手机号和必要变量，Agent可辅助解析和匹配。

什么样的签名和模板可以用来发短信？

签名审核状态为“通过”且状态为“可用-异常”或“可用-正常”，模板审核状态为“通过”，即可使用该签名和模板组合发送短信。

一次可以发多少条短信？

单次可批量发送100条短信，超过100条可分批多次发送。