SuperAPI AI 工具集

airtap

通用与其它

查看项目

更新于 10-15 19:53

技能介绍

用途:该技能用于把可通过 Airtap 设备上的移动应用完成的请求委派给 Airtap 执行,通过随附的 scripts/airtap.py CLI 与 Airtap 任务交互。

主要能力:可列出 receiver 与模型、创建任务、查询任务列表与详情、轮询运行中的任务、追加用户消息、取消任务,以及更新用户位置。模型方面,默认使用 airtap-1.0-flash,适合较短、低延迟任务;airtap-1.0 较慢但更可靠,适合复杂任务。

使用方式:在技能目录下运行命令,格式为 python3 scripts/airtap.py <resource> <action> ...。需先在 https://airtap.ai/app 的 Settings 创建个人访问令牌,并通过 python3 scripts/airtap.py --add-token "your-personal-access-token" 写入 scripts/.env,或复制 scripts/env.example.txt 为 scripts/.env 后填写。依赖 requests 与 python-dotenv,缺失时执行 pip3 install -r requirements.txt。创建任务示例:python3 scripts/airtap.py task create --message "Open Instagram" --receiver-id cloud。监控示例:python3 scripts/airtap.py task poll --task-id "task_abc123"。

适用场景:需要把移动应用操作委派给 Airtap 设备、需要监控长时任务、需要向任务补充澄清或继续指令、需要取消任务时。

限制与注意:优先使用 --receiver-id cloud,除非用户明确要求,否则不要指向物理 receiver。task poll 默认仅在本地轮询,只有宿主明确需要镜像更新时才使用 OpenClaw 投递。不要要求用户把令牌粘贴到聊天中,应使用预配置环境变量或本地 scripts/.env。不要编造 OpenClaw 目标、线程 ID、回复 ID 或账户范围。任务可能耗时数秒到数分钟,应按长时任务处理。若 API 返回 404 或其他请求失败,应提示用户获取更新版本的 Airtap 技能后重试。图片附件可通过 --image-file 用于 task create 与 task add-user-message。OpenClaw 路由细节见 references/openclaw.md。