OpenClaw 外呼技能#

调用 /aisp/addSingleTask 接口发起外呼任务。支持通讯录查找、延时外呼、定时任务调度。

通讯录#

姓名别名号码季天雄天雄15345602935何天龙天龙15655170806

使用方式#

方式一：立即外呼#

bash

python "$SKILL_DIR/scripts/main.py" "<CONTACT>" "<CONTENT>" <DELAY_SECONDS>

示例：

bash

python scripts/main.py "天龙" "来开会" 0

方式二：智能定时外呼（推荐）#

支持自然语言指令，自动解析时间和内容：

bash

python "$SKILL_DIR/scripts/schedule_call.py" "<指令>"

支持的指令格式：

• 通知天龙三分钟后去吃饭
• 让天雄一小时后去睡觉
• 通知天龙明天下午来公司
• 通知天雄今天晚上开会

时间表达式：

• X分钟后 / 几分钟后
• X小时后 / 一小时后 / 两小时后
• 明天下午 / 明天上午 / 明天早上
• 今天晚上 / 今晚

示例：

bash

python scripts/schedule_call.py "通知天龙三分钟后去吃饭"

3. 汇报结果#

脚本会输出 JSON 格式的任务信息。调用者（Agent）必须使用 message 工具将结果发送给用户。

输出格式示例：

json

{
  "version": "3.0",
  "messageId": "dispatch_20260425195701",
  "timestamp": 1777118221519,
  "messages": [
    {
      "recipient": {
        "type": "shrimp",
        "phone": "15345602935"
      },
      "content": {
        "type": "text",
        "text": "去睡觉"
      }
    }
  ]
}

返回码说明#

retCode说明000000提交成功200001任务不存在（taskId/consumerId 不匹配）300001参数校验失败（phones 为空）000001操作失败999999系统异常