# Send ai-calls-china-phone to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ai-calls-china-phone",
    "name": "ai-calls-china-phone",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/ustczz/ai-calls-china-phone",
    "canonicalUrl": "https://clawhub.ai/ustczz/ai-calls-china-phone",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/ai-calls-china-phone",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ai-calls-china-phone",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "callout.sh",
      "stepone.sh",
      "SKILL.md",
      "callinfo.sh",
      "stream_chat.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/ai-calls-china-phone"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/ai-calls-china-phone",
    "downloadUrl": "https://openagent3.xyz/downloads/ai-calls-china-phone",
    "agentUrl": "https://openagent3.xyz/skills/ai-calls-china-phone/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ai-calls-china-phone/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ai-calls-china-phone/agent.md"
  }
}
```
## Documentation

### 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

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

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

export STEPONEAI_API_KEY="sk_xxxxxxxxxxxxx"

### 方法二：secrets 文件

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

### 4.1 发起外呼

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

参数说明：

参数必填描述手机号是电话号码，如 "13800138000"外呼需求是外呼内容描述

示例：

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

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

### 4.2 查询通话记录

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

参数说明：

参数必填描述call_id是外呼返回的通话ID最大重试次数否默认为5次

示例：

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

特性：

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

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

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

./stream_chat.sh <call_id> [options]

参数说明：

参数必填描述call_id是外呼返回的通话ID--json否输出原始SSE数据（不格式化）

示例：

# 发起呼叫后立即开始监听
./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 数据格式：

rolecontent说明assistant具体文本AI 的回复内容user具体文本用户语音转文本system[DONE]通话正常结束system[TIMEOUT]30秒内未接通，超时断开

注意事项：

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

### 4.4 底层 API 封装

./stepone.sh <command> [options]

命令描述call '<json>'发起呼叫（原始JSON）callinfo <id>查询通话记录stream <id>实时对话流version检查版本号balance查看余额

### 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
更新方式：拉取最新代码即可

### 身份确认

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

### 电话号码格式

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

### 通话记录查询

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

### user_requirement 建议

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

### 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

Log in and visit: https://open-skill.steponeai.com/keys
Click "Create API Key"
Copy the generated Key (format: sk_xxxxx)

### 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.1 Initiate a Callout

./callout.sh <phone_number> <callout_requirement>

Parameters Description:

ParameterRequiredDescriptionphone_numberYesPhone number, e.g. "13800138000"callout_requirementYesDescription of the callout content

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:

ParameterRequiredDescriptioncall_idYesThe call ID returned by the calloutmax_retriesNoDefaults to 5 times

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:

ParameterRequiredDescriptioncall_idYesThe call ID returned by the callout--jsonNoOutput raw SSE data (unformatted)

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:

rolecontentDescriptionassistantSpecific textAI's reply contentuserSpecific textUser's voice-to-textsystem[DONE]Call ended normallysystem[TIMEOUT]Not connected within 30 seconds, disconnected due to timeout

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]

CommandDescriptioncall '<json>'Initiate a call (raw JSON)callinfo <id>Query call recordsstream <id>Real-time conversation streamversionCheck version numberbalanceCheck balance

### 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

### 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ustczz
- Version: 1.0.8
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/ai-calls-china-phone)
- [Send to Agent page](https://openagent3.xyz/skills/ai-calls-china-phone/agent)
- [JSON manifest](https://openagent3.xyz/skills/ai-calls-china-phone/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/ai-calls-china-phone/agent.md)
- [Download page](https://openagent3.xyz/downloads/ai-calls-china-phone)