← All skills
Tencent SkillHub · Communication & Collaboration

ai-calls-china-phone

可以拨打中国电话号码的机器人外呼, 专为openclaw(龙虾)用户打造的专业ai呼叫能力,只要一个prompt就可以帮你打电话干活了,支持查看电话对话记录,查看电话状态等。

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

可以拨打中国电话号码的机器人外呼, 专为openclaw(龙虾)用户打造的专业ai呼叫能力,只要一个prompt就可以帮你打电话干活了,支持查看电话对话记录,查看电话状态等。

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
callout.sh, stepone.sh, SKILL.md, callinfo.sh, stream_chat.sh

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

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

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.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.8

Documentation

ClawHub primary doc Primary doc: SKILL.md 38 sections Open source page

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

Category context

Messaging, meetings, inboxes, CRM, and teammate communication surfaces.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
4 Scripts1 Docs
  • SKILL.md Primary doc
  • callinfo.sh Scripts
  • callout.sh Scripts
  • stepone.sh Scripts
  • stream_chat.sh Scripts