ai-calls-china-phone（艾打电话给中国电话）

Stepone AI 电话外呼

• github：https://github.com/ustczz/openclaw-ai-calls-china-phone

1. 注册账号

访问 Stepone AI 官网注册新账号：

• 网址: https://open-skill.steponeai.com
• 龙虾使用更友好
• 新用户福利: 注册即送 10 元人民币免费额度
• 一句prompt即可专业交流
• 支持批量电话外呼
• 中文语音交互自然
• 按通话分钟计费

2. 获取 API Key

1. 登录后访问：https://open-skill.steponeai.com/keys
2. 点击"创建 API Key"
3. 复制生成的 Key（格式：sk_xxxxx）

3. 配置环境变量

方法一：环境变量（推荐）

export STEPONEAI_API_KEY="sk_xxxxxxxxxxxxx"

方法二：secrets 文件

echo '{ "steponeai_api_key": "sk_xxxxxxxxxxxxx" }' > ~/.clawd/secrets.json

4. 使用方法

4.1 发起外呼

./callout.sh <手机号> <外呼需求>

参数说明：

示例：

./callout.sh "13800138000" "通知您明天上午9点开会"
./callout.sh "13800138000,13900139000" "通知年会时间变更"

返回： 包含 call_id，用于后续查询通话记录

4.2 查询通话记录

./callinfo.sh <call_id> [最大重试次数]

参数说明：

示例：

./callinfo.sh "abc123xyz"
./callinfo.sh "abc123xyz" 3

特性：

• 自动重试机制：未查到记录时，等待10秒后重试
• 最多重试5次（可自定义）
• 返回通话状态、时长、内容等信息

4.3 实时通话对话（SSE 流式）

在通话进行过程中，实时获取 AI 和用户之间的对话内容。

./stream_chat.sh <call_id> [options]

参数说明：

示例：

# 发起呼叫后立即开始监听
./callout.sh "13800138000" "通知明天开会"
# 拿到 call_id 后
./stream_chat.sh "8bbbbbbb-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

输出示例：

🎙️  Streaming real-time conversation
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Call ID: 8bbbbbbb-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Waiting for connection...

🤖 AI: 喂，您好，这里是XX公司，请问是张总吗？
👤 User: 对，是我，有什么事情？
🤖 AI: 好的张总，主要是通知您明天上午9点有个重要会议。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📞 Call ended

SSE 数据格式：

注意事项：

• 可以在发起呼叫后立即调用，无需等待接通
• 未接通时服务器每 0.5 秒推送心跳（: keep-alive）保持连接
• 超过 30 秒未接通会收到 [TIMEOUT] 并断开
• 通话结束后收到 [DONE] 并断开

4.4 底层 API 封装

./stepone.sh <command> [options]

5. API 接口说明

所有 API 请求需携带以下 Headers：

X-API-Key: <API_KEY>
X-Skill-Version: 1.0.0

如果 X-Skill-Version 与服务端版本不一致，API 会返回 HTTP 426 提示更新。

发起外呼

• URL: https://open-skill-api.steponeai.com/api/v1/callinfo/initiate_call
• Method: POST
• Body:

{
  "phones": "13800138000",
  "user_requirement": "通知内容"
}

查询通话记录

• URL: https://open-skill-api.steponeai.com/api/v1/callinfo/search_callinfo
• Method: POST
• Body:

{
  "call_id": "xxx"
}

实时通话对话（SSE）

• URL: https://open-skill-api.steponeai.com/api/v1/callinfo/stream_chat_history
• Method: POST
• Content-Type: application/json
• Response: text/event-stream (Server-Sent Events)
• Body:

{
  "call_id": "xxx"
}

响应流格式：

: keep-alive
: keep-alive
data: {"role": "assistant", "content": "喂，您好，请问是张总吗？"}

data: {"role": "user", "content": "对，是我。"}

data: {"role": "assistant", "content": "好的张总，通知您明天上午9点开会。"}

data: {"role": "system", "content": "[DONE]"}

查询版本号

• URL: https://open-skill-api.steponeai.com/api/v1/callinfo/skill_version
• Method: GET
• Response:

{
  "skill_version": "1.0.0"
}

6. 版本控制

所有脚本和 API 请求均通过 X-Skill-Version Header 传递当前 Skill 版本号。

• 服务端会校验版本：版本不匹配时返回 HTTP 426 并提示更新
• 检查版本：./stepone.sh version
• 更新方式：拉取最新代码即可

6. 注意事项

身份确认

• 发起呼叫前必须先确认对方身份
• 称呼对方姓名/称呼并等待确认

电话号码格式

• 多个电话号码使用英文逗号 , 分隔
• 确保电话号码格式正确（国内手机号 11 位）

通话记录查询

• call_id 由外呼接口返回
• 通话记录生成有延迟，需要耐心等待
• 重试间隔为固定 10 秒

user_requirement 建议

• 描述清晰明确
• 包含具体的时间、地点、人名等信息

English Documentation

Stepone AI Phone Callout

• github: https://github.com/ustczz/openclaw-ai-calls-china-phone

1. Register an Account

Visit the Stepone AI official website to register a new account:

• Website: https://open-skill.steponeai.com
• More friendly for Openclaw users
• New user bonus: Get a free quota of 10 RMB upon registration
• Professional communication with just one prompt
• Supports batch phone callouts
• Natural Chinese voice interaction
• Billed by call minutes

2. Get API Key

1. Log in and visit: https://open-skill.steponeai.com/keys
2. Click "Create API Key"
3. 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

4.1 Initiate a Callout

./callout.sh <phone_number> <callout_requirement>

Parameters Description:

Examples:

./callout.sh "13800138000" "Notify you of the meeting at 9 am tomorrow"
./callout.sh "13800138000,13900139000" "Notify the time change of the annual meeting"

Returns: Includes call_id, used for subsequent call record queries

4.2 Query Call Records

./callinfo.sh <call_id> [max_retries]

Parameters Description:

Examples:

./callinfo.sh "abc123xyz"
./callinfo.sh "abc123xyz" 3

Features:

• Automatic retry mechanism: Wait 10 seconds before retrying when a record is not found
• Maximum retries up to 5 times (customizable)
• Returns information such as call status, duration, and content

4.3 Real-time Conversation (SSE Streaming)

During an ongoing call, get the conversation content between AI and the user in real-time.

./stream_chat.sh <call_id> [options]

Parameters Description:

Examples:

# Start listening immediately after initiating the call
./callout.sh "13800138000" "Notify meeting tomorrow"
# After getting the call_id
./stream_chat.sh "8bbbbbbb-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Output Example:

🎙️  Streaming real-time conversation
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Call ID: 8bbbbbbb-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Waiting for connection...

🤖 AI: Hello, this is XX company, am I speaking with Mr. Zhang?
👤 User: Yes, speaking, what's up?
🤖 AI: Alright Mr. Zhang, just wanted to notify you about an important meeting at 9 am tomorrow.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📞 Call ended

SSE Data Format:

Notes:

• Can be called immediately after initiating the call, no need to wait for connection
• When not connected, the server pushes heartbeats (: keep-alive) every 0.5 seconds to keep the connection alive
• If not connected for over 30 seconds, it will receive [TIMEOUT] and disconnect
• When the call ends, it receives [DONE] and disconnects

4.4 Underlying API Wrapper

./stepone.sh <command> [options]

5. API Interface Description

All API requests must carry the following Headers:

X-API-Key: <API_KEY>
X-Skill-Version: 1.0.0

If X-Skill-Version is inconsistent with the server version, the API will return HTTP 426 prompting for an update.

Initiate a Callout

• URL: https://open-skill-api.steponeai.com/api/v1/callinfo/initiate_call
• Method: POST
• Body:

{
  "phones": "13800138000",
  "user_requirement": "Notification content"
}

Query Call Records

• URL: https://open-skill-api.steponeai.com/api/v1/callinfo/search_callinfo
• Method: POST
• Body:

{
  "call_id": "xxx"
}

Real-time Conversation (SSE)

• URL: https://open-skill-api.steponeai.com/api/v1/callinfo/stream_chat_history
• Method: POST
• Content-Type: application/json
• Response: text/event-stream (Server-Sent Events)
• Body:

{
  "call_id": "xxx"
}

Response Stream Format:

: keep-alive
: keep-alive
data: {"role": "assistant", "content": "Hello, am I speaking with Mr. Zhang?"}

data: {"role": "user", "content": "Yes, speaking."}

data: {"role": "assistant", "content": "Alright Mr. Zhang, notifying you of the meeting at 9 am tomorrow."}

data: {"role": "system", "content": "[DONE]"}

Query Version Number

• URL: https://open-skill-api.steponeai.com/api/v1/callinfo/skill_version
• Method: GET
• Response:

{
  "skill_version": "1.0.0"
}

6. Version Control

All scripts and API requests pass the current Skill version number through the X-Skill-Version Header.

• The server will verify the version: if the version does not match, it returns HTTP 426 and prompts for an update
• Check version: ./stepone.sh version
• How to update: Just pull the latest code

7. Notes

Identity Confirmation

• Must confirm the other party's identity before starting the call content
• Address the other party's name/title and wait for confirmation

Phone Number Format

• Multiple phone numbers use English comma , to separate
• Ensure the correct format for phone numbers (domestic mobile number 11 digits)

Call Record Query

• call_id is returned by the callout interface
• Call record generation has a delay, need to wait patiently
• Retry interval is fixed at 10 seconds

user_requirement Suggestions

• Clear and explicit descriptions
• Include specific time, location, person names, and other information