Stepone AI 电话外呼
1. 注册账号
访问 Stepone AI 官网注册新账号：
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 <手机号> <外呼需求>
参数说明：
| 参数 | 必填 | 描述 |
|---|
| 手机号 | 是 | 电话号码，如 "13800138000" |
| 外呼需求 | 是 | 外呼内容描述 |
示例：
./callout.sh "13800138000" "通知您明天上午9点开会"
./callout.sh "13800138000,13900139000" "通知年会时间变更"
返回： 包含 call_id，用于后续查询通话记录
4.2 查询通话记录
{baseDir}/scripts/callinfo.sh <call_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: <API_KEY>
- Body:
{
"phones": "13800138000",
"user_requirement": "通知内容"
}
查询通话记录
- URL:
https://open-skill.steponeai.com/api/v1/callinfo/search_callinfo
- Method: POST
- Headers:
X-API-Key: <API_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 <phone_number> <call_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 <call_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: <API_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: <API_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
