← 返回 Skills 市场
525
总下载
1
收藏
1
当前安装
3
版本数
在 OpenClaw 中安装
/install ai-phone-calls-steponeai
功能描述
可以拨打中国电话号码的机器人外呼, 专为openclaw(龙虾)用户打造的专业ai呼叫能力,只要一个prompt就可以帮你打电话干活了,支持查看电话对话记录,查看电话状态等。
使用说明 (SKILL.md)
Stepone AI 电话外呼
1. 注册账号
访问 Stepone AI 官网注册新账号:
- 网址: https://open-skill.steponeai.com
- 龙虾使用更友好
- 新用户福利: 注册即送 10 元人民币免费额度
- 一句prompt即可专业交流
- 支持批量电话外呼
- 中文语音交互自然
- 按通话分钟计费
2. 获取 API Key
- 登录后访问:https://open-skill.steponeai.com/keys
- 点击"创建 API Key"
- 复制生成的 Key(格式:
sk_xxxxx)
3. 配置环境变量
方法一:环境变量(推荐)
export STEPONEAI_API_KEY="sk_xxxxxxxxxxxxx"
方法二:secrets 文件
echo '{ "steponeai_api_key": "sk_xxxxxxxxxxxxx" }' > ~/.clawd/secrets.json
4. 使用方法
4.1 发起外呼
{baseDir}/scripts/callout.sh \x3C手机号> \x3C外呼需求>
参数说明:
| 参数 | 必填 | 描述 |
|---|---|---|
| 手机号 | 是 | 电话号码,如 "13800138000" |
| 外呼需求 | 是 | 外呼内容描述 |
示例:
./callout.sh "13800138000" "通知您明天上午9点开会"
./callout.sh "13800138000,13900139000" "通知年会时间变更"
返回: 包含 call_id,用于后续查询通话记录
4.2 查询通话记录
{baseDir}/scripts/callinfo.sh \x3Ccall_id> [最大重试次数]
参数说明:
| 参数 | 必填 | 描述 |
|---|---|---|
| call_id | 是 | 外呼返回的通话ID |
| 最大重试次数 | 否 | 默认为5次 |
示例:
./callinfo.sh "abc123xyz"
./callinfo.sh "abc123xyz" 3
特性:
- 自动重试机制:未查到记录时,等待10秒后重试
- 最多重试5次(可自定义)
- 返回通话状态、时长、内容等信息
5. API 接口说明
发起外呼
- URL:
https://open-skill.steponeai.com/api/v1/callinfo/initiate_call - Method: POST
- Headers:
X-API-Key: \x3CAPI_KEY> - Body:
{
"phones": "13800138000",
"user_requirement": "通知内容"
}
查询通话记录
- URL:
https://open-skill.steponeai.com/api/v1/callinfo/search_callinfo - Method: POST
- Headers:
X-API-Key: \x3CAPI_KEY> - Body:
{
"call_id": "xxx"
}
6. 注意事项
身份确认
- 发起呼叫前必须先确认对方身份
- 称呼对方姓名/称呼并等待确认
电话号码格式
- 多个电话号码使用英文逗号
,分隔 - 确保电话号码格式正确(国内手机号 11 位)
通话记录查询
- call_id 由外呼接口返回
- 通话记录生成有延迟,需要耐心等待
- 重试间隔为固定 10 秒
user_requirement 建议
- 描述清晰明确
- 包含具体的时间、地点、人名等信息
name: ai-calls-china-phone description: AI Call Robot for Outbound Calls to Chinese Phone Numbers — A professional AI calling capability designed exclusively for OpenClaw (Lobster) users. With just one prompt, it can make calls and get things done for you, supporting call transcript viewing and call status checking.
1. Account Registration
Visit the official website of Stepone AI to register a new account:
- Website: https://open-skill.steponeai.com
- openclaw-friendly operation
- New User Benefit: Get RMB 10 free credit upon registration
- Professional communication with just one prompt
- Supports batch outbound calls
- Natural Chinese voice interaction
- Charged by call minute
2. Obtain API Key
- After logging in, visit: https://open-skill.steponeai.com/keys
- Click "Create API Key"
- Copy the generated Key (format:
sk_xxxxx)
3. Configure Environment Variables
Method 1: Environment Variables (Recommended)
export STEPONEAI_API_KEY="sk_xxxxxxxxxxxxx"
Method 2: Secrets File
echo '{ "steponeai_api_key": "sk_xxxxxxxxxxxxx" }' > ~/.clawd/secrets.json
4. Usage Methods
4.1 Initiate Outbound Call
{baseDir}/scripts/callout.sh \x3Cphone_number> \x3Ccall_requirement>
Parameter Description:
| Parameter | Required | Description |
|---|---|---|
| phone_number | Yes | Phone number, e.g., "13800138000" |
| call_requirement | Yes | Description of call content |
Examples:
./callout.sh "13800138000" "Notify you about tomorrow's 9 AM meeting"
./callout.sh "13800138000,13900139000" "Notify about annual meeting time change"
Returns: Contains call_id for subsequent call record queries
4.2 Query Call Records
{baseDir}/scripts/callinfo.sh \x3Ccall_id> [max_retry_count]
Parameter Description:
| Parameter | Required | Description |
|---|---|---|
| call_id | Yes | Call ID returned from outbound call |
| max_retry_count | No | Default is 5 times |
Examples:
./callinfo.sh "abc123xyz"
./callinfo.sh "abc123xyz" 3
Features:
- Automatic retry mechanism: Waits 10 seconds before retrying if no record found
- Maximum 5 retries (customizable)
- Returns call status, duration, content, and other information
5. API Interface Description
Initiate Outbound Call
- URL:
https://open-skill.steponeai.com/api/v1/callinfo/initiate_call - Method: POST
- Headers:
X-API-Key: \x3CAPI_KEY> - Body:
{
"phones": "13800138000",
"user_requirement": "Notification content"
}
Query Call Records
- URL:
https://open-skill.steponeai.com/api/v1/callinfo/search_callinfo - Method: POST
- Headers:
X-API-Key: \x3CAPI_KEY> - Body:
{
"call_id": "xxx"
}
6. Important Notes
Identity Confirmation
- Must confirm the recipient's identity before initiating calls
- Address the recipient by name/title and wait for confirmation
Phone Number Format
- Multiple phone numbers separated by English commas
, - Ensure correct phone number format (11 digits for Chinese mobile numbers)
Call Record Query
- call_id is returned by the outbound call interface
- Call record generation has delays, requires patience
- Retry interval is fixed at 10 seconds
user_requirement Suggestions
- Clear and specific descriptions
- Include specific time, location, person names, and other information
安全使用建议
Before installing: 1) Verify the service domain(s) are legitimate (ask the author which hostname to use and why SKILL.md and scripts differ). 2) Use a throwaway/test API key first to confirm behavior and billing. 3) Note the scripts will read ~/.clawd/secrets.json if present—either remove other secrets from that file or keep the file absent and set STEPONEAI_API_KEY in the environment. 4) Confirm legal/privacy requirements for calling real phone numbers and storing/transmitting transcripts (the service returns call transcripts and provider responses). 5) Run the scripts in an isolated environment or VM and monitor network traffic to confirm they only contact the expected API endpoints. 6) If you need to limit autonomous invocation risk, avoid enabling broad agent autonomy for this skill or restrict the agent's permissions.
功能分析
Type: OpenClaw Skill
Name: ai-phone-calls-steponeai
Version: 1.0.2
The skill bundle provides functionality for AI-powered phone calls via the Stepone AI service. It correctly handles API keys by expecting them in environment variables or a secrets file. The `callout.sh` and `callinfo.sh` scripts, which are the primary interfaces for the OpenClaw agent, include input validation and a custom JSON escaping function (`json_escape`) to sanitize user-provided phone numbers and call requirements before making API calls. While the `validate_call_id` regex has a minor bug and the API key extraction from `secrets.json` is somewhat fragile, these are not indicative of malicious intent. The `stepone.sh` script, a low-level wrapper, takes raw JSON, but it is not directly exposed by the `SKILL.md` for unsanitized user input. No evidence of data exfiltration, persistence, obfuscation, or prompt injection against the OpenClaw agent was found. All external network calls are directed to the legitimate Stepone AI API at `https://open-skill-api.steponeai.com`.
能力评估
Purpose & Capability
The name/description match the code: scripts perform outbound-call and call-info requests to a Stepone AI service and only require an API key. However, SKILL.md and the scripts reference two slightly different hostnames (open-skill.steponeai.com vs open-skill-api.steponeai.com), which is an inconsistency worth verifying. The registry metadata did not declare any config paths, but the scripts read ~/.clawd/secrets.json as an alternate source for the API key.
Instruction Scope
Runtime instructions and included scripts stick to the stated purpose: they construct JSON requests and call remote APIs (initiate_call and search_callinfo) and parse responses. They do not attempt to read arbitrary system files or other credentials beyond the declared API key / secrets file. They do retrieve call transcripts and provider responses (sensitive user data) from the remote API, which matches the advertised features.
Install Mechanism
No install spec is provided (instruction-only plus shipped shell scripts). Nothing is downloaded or written by an installer; the scripts run directly. This is the lowest install risk.
Credentials
The skill only requires a single API key (STEPONEAI_API_KEY), which is proportional. However, the scripts also read ~/.clawd/secrets.json to extract a key; the registry metadata declared no required config paths. Reading that secrets file (not declared) is a mismatch and should be declared/confirmed. Ensure the secrets file contains only the intended key and is stored with restrictive permissions. Also confirm that STEPONEAI_API_KEY corresponds only to this service and not to any other account with broader privileges.
Persistence & Privilege
always is false and the skill is user-invocable; it does not request persistent/always-on privileges or modify other skills. Autonomous invocation remains allowed by platform default (not a specific extra privilege of this skill).
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install ai-phone-calls-steponeai - 安装完成后,直接呼叫该 Skill 的名称或使用
/ai-phone-calls-steponeai触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.2
- Added new script file: stepone.sh for streamlined call operations.
- Updated and expanded SKILL.md with improved bilingual (Chinese/English) documentation.
- Enhanced usage instructions for registration, API key setup, and environment configuration.
- Clarified API parameter formats, return structure, and retry logic for call record queries.
- Provided clearer guidance and suggestions for effective call prompts and operational best practices.
v1.0.1
- Added clarification in the description that the skill can dial a Chinese phone number.
- Updated wording in the description for improved clarity regarding supported phone numbers.
- No changes to core functionality or usage instructions.
v1.0.0
the first version!
元数据
常见问题
ai-phone-calls-steponeai 是什么?
可以拨打中国电话号码的机器人外呼, 专为openclaw(龙虾)用户打造的专业ai呼叫能力,只要一个prompt就可以帮你打电话干活了,支持查看电话对话记录,查看电话状态等。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 525 次。
如何安装 ai-phone-calls-steponeai?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install ai-phone-calls-steponeai」即可一键安装,无需额外配置。
ai-phone-calls-steponeai 是免费的吗?
是的,ai-phone-calls-steponeai 完全免费(开源免费),可自由下载、安装和使用。
ai-phone-calls-steponeai 支持哪些平台?
ai-phone-calls-steponeai 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 ai-phone-calls-steponeai?
由 vincent(@ustczz)开发并维护,当前版本 v1.0.2。
推荐 Skills