@honor-claw/yoyo 1.5.1-beta.1 → 1.5.1-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  //#region src/utils/version.ts
2
2
  var e = null, t = null;
3
3
  function n() {
4
- return e === null && (e = "1.5.1-beta.1".includes("beta") || "1.5.1-beta.1".includes("alpha")), !!e;
4
+ return e === null && (e = "1.5.1-beta.2".includes("beta") || "1.5.1-beta.2".includes("alpha")), !!e;
5
5
  }
6
6
  function r(e) {
7
7
  if (!e) return 0;
@@ -10,7 +10,7 @@ function r(e) {
10
10
  }
11
11
  function i() {
12
12
  if (t !== null) return t;
13
- let [e, n, i] = "1.5.1-beta.1".split("-", 1)[0].split("."), a = r(e), o = r(n), s = r(i);
13
+ let [e, n, i] = "1.5.1-beta.2".split("-", 1)[0].split("."), a = r(e), o = r(n), s = r(i);
14
14
  return t = a * 1e6 + o * 1e3 + s, t;
15
15
  }
16
16
  //#endregion
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@honor-claw/yoyo",
3
- "version": "1.5.1-beta.1",
3
+ "version": "1.5.1-beta.2",
4
4
  "description": "OpenClaw Honor Yoyo connection plugin",
5
5
  "keywords": [
6
6
  "ai",
@@ -3,6 +3,7 @@ name: yoyo_phone_control
3
3
  description: >
4
4
  通过YOYO操作手机系统用机功能,包括打开/关闭/卸载应用、发送/查找短信、拨打电话、搜索联系人、搜索通话记录、创建/打开/查询/关闭/删除闹钟、创建/添加/新建日程、计时器管理、录音、截屏、屏幕录制、调节音量、屏幕亮度调节、切换响铃/静音/勿扰/护眼/深色/飞行模式、管理移动数据或热点或蓝牙或WLAN、进行本地内容搜索、文件发送、调用相机拍照/录像、电池状态/电量查询与、开启/关闭定位服务、开启/关闭NFC功能、开启/关闭自动亮屏功能、USB共享网络、设备电源状态与屏幕状态控制、状态栏显示信息管理与控制、进行扫码操作、控制手机的手电筒、清理和维护设备扬声器、机票监控、查快递等。
5
5
  支持与手机系统用机交互的相关操作。
6
+ 此外,还支持完成在用户指定App应用内进行GUI操作。
6
7
  metadata: { "openclaw": { "emoji": "📱", "always": true } }
7
8
  ---
8
9
 
@@ -35,6 +36,7 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
35
36
  - 参数必须为合法 JSON,枚举值区分大小写,数值在定义范围内
36
37
  - 当工具执行错误时,必须确认下发的指令是否存在格式问题,尤其是单双引号的使用问题
37
38
  - 如果执行失败,必须重新读取 `SKILL.md` 和对应的工具定义文件,然后重新执行
39
+ - 禁止使用GUI工具作为兜底工具,除非用户明确要求在指定 App 内执行指定动作
38
40
  - 绝对不能使用任何其他设备的工具
39
41
  - 不要尝试任何其他方式完成任务,不要提供替代方案
40
42
  - **Never try a different approach**
@@ -82,6 +84,7 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
82
84
  4. **如果 Sub-Skill 和 MCP 均无匹配**:
83
85
  - 告知用户暂不支持该功能
84
86
  - 终止本次操作
87
+ - 严禁使用 GUI 工具作为备选工具
85
88
 
86
89
  #### Sub-Skill 工具参考表
87
90
 
@@ -129,6 +132,9 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
129
132
  | `battery` | `references/battery.md` | 电量与省电模式管理 |
130
133
  | `audio-record` | `references/audio-record.md` | 录音管理 |
131
134
  | `camera` | `references/camera.md` | 相机控制(拍照/录像),不支持手电筒相关的操作。 |
135
+ | `gui` | `references/gui-task-create.md` | 启动 GUI 操作任务(UI Agent),只有当用户明确要求在指定 App 内执行指定动作时才使用。如果用户没有提供应用名,严禁使用本工具。|
136
+ | `gui` | `references/gui-task-terminate.md` | 取消 GUI 任务 |
137
+ | `gui` | `references/gui-task-pause.md` | 暂停 GUI 任务 |
132
138
  | `scan-code` | `references/scan-code.md` | 扫码(二维码/条形码) |
133
139
  | `flashlight` | `references/flashlight.md` | 手电筒控制 |
134
140
  | `airplane-mode` | `references/airplane-mode.md` | 飞行模式管理 |
@@ -0,0 +1,222 @@
1
+ ---
2
+ name: gui.create
3
+ description: >
4
+ 启动基于 GUI 的应用操作任务(UI Agent)。用于在手机上对指定 App 发起一次独立的操控流程;多 App 或含条件的流程需拆分为多次调用,续办需携带上次任务的 task_id。
5
+ ---
6
+
7
+ # Gui Task Create GUI 任务创建
8
+
9
+ ## Tool Command
10
+ ```bash
11
+ gui.create
12
+ ```
13
+
14
+ ## 3. 业务规则
15
+
16
+ ### 适用场景及操作流程
17
+ 1. 针对单一 App 的一次性 GUI 操作任务,直接发起调用
18
+ 2. 涉及多个 App 的连续操作需拆分为多个独立任务,逐个调用
19
+ 3. 涉及条件判断(如“若…则…”)时,将条件判断与执行任务拆分为两次调用
20
+ 4. 若为对未结束任务的补充/修改/继续,需在请求中补充对应的 task_id
21
+
22
+ ### 特定交互
23
+ - 当用户表达“继续/接着/沿用上次”等续办意图时,应查找并填写上一未结束任务的 task_id
24
+ - 用户 query 中提及多个 App 时需与用户确认目标 App 后再调用
25
+ - task_query 应尽量保持用户原始指令表述,避免改写
26
+
27
+ ## 集成工作流
28
+
29
+ ### Step 1: 意图解析与参数组装
30
+ ```
31
+ ┌─────────────────────────────────────────────────────────────┐
32
+ │ 意图识别与参数提取 │
33
+ │ - 识别操作意图: 创建/发起 + GUI 应用操作任务 │
34
+ │ - 提取应用名称: 官方名/通用别称/拼音 │
35
+ │ - 提取任务指令: 包含明确操作步骤或目标 │
36
+ │ - 判断是否为续办: 根据“继续/接着/上次”等上下文 │
37
+ │ - 特殊处理: query 含多个App时确定目标应用 │
38
+ └─────────────────────────────────────────────────────────────┘
39
+
40
+ ┌─────────────────────────────────────────────────────────────┐
41
+ │ 消歧与槽位填充 │
42
+ │ - 未指定应用名称时,需向用户追问app_name │
43
+ │ - 未提供任务指令时,需向用户追问task_query │
44
+ │ - 多个应用候选时,需追问或让用户选择其一 │
45
+ │ - task_id仅当为未结束任务的更新/补充时填写 │
46
+ │ - "继续/接着/上次那个" → 映射为续办并查找task_id │
47
+ │ - 验证应用名称有效性(是否可被唤起) │
48
+ └─────────────────────────────────────────────────────────────┘
49
+
50
+ ┌─────────────────────────────────────────────────────────────┐
51
+ │ 生成工具调用 │
52
+ │ - 组装 app_name, task_query 及可选参数(task_id) │
53
+ │ - 生成平台特定的命令格式 │
54
+ └─────────────────────────────────────────────────────────────┘
55
+ ```
56
+
57
+ ### Step 2: 执行调用
58
+ - 根据操作系统选择对应的命令格式
59
+ - Windows: Cmd 格式(双引号需转义)
60
+ - Linux: Bash 格式(单引号包裹)
61
+
62
+ ## 参数定义
63
+ ```json
64
+ {
65
+ "app_name": {
66
+ "type": "string",
67
+ "description": "必填参数,需要执行该任务的app名称"
68
+ },
69
+ "task_query": {
70
+ "type": "string",
71
+ "description": "必填参数,需要让GUI执行的任务的明确query,通常为一个包含app名称的指令性query"
72
+ },
73
+ "task_id": {
74
+ "type": "string",
75
+ "description": "任务id,当前query为gui执行,且是对上一个未结束的gui任务的更新、补充,那么则将上一个未结束的gui任务的task_id填入"
76
+ }
77
+ }
78
+ ```
79
+
80
+ ### 参数注意事项
81
+ 1. `task_query` 应尽量保持用户原始意图,并将其改写成包含app名称的指令性query,或明确的gui操作指令。
82
+ 2. **同义词/间接表述映射**: “用X/在X里/打开X然后…”均映射为识别 `app_name`=X;“继续/接着/上次那个”映射为续办语义,需要填写 `task_id`。
83
+ 3. **默认值或缺省行为**: `app_name` 与 `task_query` 为必填,无默认值,如果缺失则需要追问用户;新增任务场景下 `task_id` 留空或不填写。
84
+ 4. **参数间关联/依赖**: `task_query` 通常包含 App 名称,但仍须单独提供 `app_name`;续办场景中 `task_id` 与所指任务保持一致。
85
+ 5. **可选参数填写条件**: 仅当用户明确为未结束任务的更新/补充/继续时才填写 `task_id`,否则不传。
86
+
87
+ ## Query 示例及输出
88
+
89
+ ### 示例 1: 在携程查询最便宜的机票(新增任务)
90
+
91
+ **用户输入**: "帮我在携程查询一下从上海去北京最便宜的机票"
92
+
93
+ **工具**: "gui.create"
94
+
95
+ **JSON 参数**:
96
+ ```json
97
+ {
98
+ "app_name": "携程",
99
+ "task_query": "帮我在携程查询一下从上海去北京最便宜的机票"
100
+ }
101
+ ```
102
+
103
+ **Windows (Cmd) 执行命令**:
104
+ ```bash
105
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"携程\",\"task_query\":\"帮我在携程查询一下从上海去北京最便宜的机票\"}"'
106
+ ```
107
+
108
+ **Linux (Bash) 执行命令**:
109
+ ```bash
110
+ openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"携程","task_query":"帮我在携程查询一下从上海去北京最便宜的机票"}'
111
+ ```
112
+
113
+ ---
114
+
115
+ ### 示例 2: 用汽水音乐识别当前音乐(新增任务)
116
+
117
+ **用户输入**: "用汽水音乐帮我识别一下这个是什么音乐"
118
+
119
+ **工具**: "gui.create"
120
+
121
+ **JSON 参数**:
122
+ ```json
123
+ {
124
+ "app_name": "汽水音乐",
125
+ "task_query": "使用汽水音乐听歌识曲,识别当前的音乐"
126
+ }
127
+ ```
128
+
129
+ **Windows (Cmd) 执行命令**:
130
+ ```bash
131
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"汽水音乐\",\"task_query\":\"使用汽水音乐听歌识曲,识别当前的音乐\"}"'
132
+ ```
133
+
134
+ **Linux (Bash) 执行命令**:
135
+ ```bash
136
+ openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"汽水音乐","task_query":"使用汽水音乐听歌识曲,识别当前的音乐"}'
137
+ ```
138
+
139
+ ---
140
+
141
+ ### 示例 3: 继续上次在高德地图的导航并修改目的地(续办,带 task_id)
142
+
143
+ **用户输入**: "接着刚才在高德地图的导航,把目的地改成北京南站"
144
+
145
+ **工具**: "gui.create"
146
+
147
+ **JSON 参数**:
148
+ ```json
149
+ {
150
+ "app_name": "高德地图",
151
+ "task_query": "继续在高德地图进行导航,将目的地改为北京南站",
152
+ "task_id": "prev-task-id-001"
153
+ }
154
+ ```
155
+
156
+ **Windows (Cmd) 执行命令**:
157
+ ```bash
158
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"高德地图\",\"task_query\":\"继续在高德地图进行导航,将目的地改为北京南站\",\"task_id\":\"prev-task-id-001\"}"'
159
+ ```
160
+
161
+ **Linux (Bash) 执行命令**:
162
+ ```bash
163
+ openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"高德地图","task_query":"继续在高德地图进行导航,将目的地改为北京南站","task_id":"prev-task-id-001"}'
164
+ ```
165
+
166
+ ---
167
+
168
+ ### 示例 4: 在淘宝将指定商品加入购物车(新增任务)
169
+
170
+ **用户输入**: "在淘宝把羽绒服加入购物车"
171
+
172
+ **工具**: "gui.create"
173
+
174
+ **JSON 参数**:
175
+ ```json
176
+ {
177
+ "app_name": "淘宝",
178
+ "task_query": "在淘宝将“羽绒服”加入购物车"
179
+ }
180
+ ```
181
+
182
+ **Windows (Cmd) 执行命令**:
183
+ ```bash
184
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"淘宝\",\"task_query\":\"在淘宝将“羽绒服”加入购物车\"}"'
185
+ ```
186
+
187
+ **Linux (Bash) 执行命令**:
188
+ ```bash
189
+ openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"淘宝","task_query":"在淘宝将“羽绒服”加入购物车"}'
190
+ ```
191
+
192
+ ---
193
+
194
+ ### 示例 5: 在系统设置中关闭蓝牙(新增任务)
195
+
196
+ **用户输入**: "打开设置把蓝牙关闭"
197
+
198
+ **工具**: "gui.create"
199
+
200
+ **JSON 参数**:
201
+ ```json
202
+ {
203
+ "app_name": "设置",
204
+ "task_query": "在设置中关闭蓝牙"
205
+ }
206
+ ```
207
+
208
+ **Windows (Cmd) 执行命令**:
209
+ ```bash
210
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"设置\",\"task_query\":\"在设置中关闭蓝牙\"}"'
211
+ ```
212
+
213
+ **Linux (Bash) 执行命令**:
214
+ ```bash
215
+ openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"设置","task_query":"在设置中关闭蓝牙"}'
216
+ ```
217
+
218
+ ---
219
+
220
+ **注意**:
221
+ - 返回给用户的回复话术严禁包含完整的 `task_id`,以免泄露隐私。
222
+ - 回复话术使用简短的task_id,且task_id不能被特殊字符包裹,例如:成功创建了任务55cd5faf-2871-468c-86bc-415b24ee0cc4,应该返回的回复话术为:✅ GUI 任务已启动,正在规划中。\n📋 任务 ID:55cd5faf
@@ -0,0 +1,188 @@
1
+ ---
2
+ name: gui.pause
3
+ description: >
4
+ GUI 任务暂停工具。用于暂停由 gui_task_create 创建且正在执行中的 GUI 任务(UI Agent 接口)。
5
+ ---
6
+
7
+ # Gui Task Pause GUI任务暂停
8
+
9
+ ## Tool Command
10
+ ```bash
11
+ gui.pause
12
+ ```
13
+
14
+ ## 集成工作流
15
+
16
+ ### Step 1: 意图解析与参数组装
17
+ ```
18
+ ┌─────────────────────────────────────────────────────────────┐
19
+ │ 意图识别与参数提取 │
20
+ │ - 识别操作意图: 暂停 + GUI任务 │
21
+ │ - 提取任务标识: 从会话上下文获取上一个未结束的 task_id │
22
+ │ - 判断任务上下文: 如无未结束任务需提示或追问 │
23
+ │ - 提取修饰词: 用户表述中的时间性短语不影响暂停意图 │
24
+ │ - 特殊处理: "暂停/先停一下/稍后继续/先别动"等同义词统一识别 │
25
+ └─────────────────────────────────────────────────────────────┘
26
+
27
+ ┌─────────────────────────────────────────────────────────────┐
28
+ │ 消歧与槽位填充 │
29
+ │ - 未指定 task_id 时,默认为上一个未结束的 GUI 任务 │
30
+ │ - 无可用任务时,需向用户追问具体 task_id 或返回不可暂停 │
31
+ │ - "先暂停一下/停一停" → 映射为暂停操作 │
32
+ │ - 验证任务状态: 仅当任务处于执行中方可暂停 │
33
+ │ - 特殊约束: query 保持用户原始输入,严禁改写 │
34
+ └─────────────────────────────────────────────────────────────┘
35
+
36
+ ┌─────────────────────────────────────────────────────────────┐
37
+ │ 生成工具调用 │
38
+ │ - 组装 task_id 及可选参数(无) │
39
+ │ - 生成平台特定的命令格式 │
40
+ └─────────────────────────────────────────────────────────────┘
41
+ ```
42
+
43
+ ### Step 2: 执行调用
44
+ - 根据操作系统选择对应的命令格式
45
+ - Windows: Cmd 格式(双引号需转义)
46
+ - Linux: Bash 格式(单引号包裹)
47
+
48
+ ## 参数定义
49
+ ```json
50
+ {
51
+ "task_id": {
52
+ "type": "string",
53
+ "description": "必填参数,任务id,当前query为gui执行,且是对上一个未结束的gui任务的更新、补充,那么则将上一个未结束的gui任务的task_id填入"
54
+ }
55
+ }
56
+ ```
57
+
58
+ ### 参数注意事项
59
+ 1. **同义词/间接表述映射**: 用户表述如`“暂停”/“先暂停一下”/“停一下”/“稍后继续”/“先别动”`均识别为暂停操作,对应调用本工具并填充`task_id`。
60
+ 2. **默认值或缺省行为**: 未显式提供`task_id`时,默认使用“上一个未结束的 GUI 任务”的`task_id`;若不存在此类任务,应向用户追问或返回不可暂停。
61
+ 3. **参数间关联/依赖**: 仅可暂停由`gui_task_create`创建且处于执行中的任务;`task_id`若对应已完成或已取消的任务,应进行状态校验并提示无法暂停。
62
+ 4. **格式/原样保留要求**: `task_id`需精确传递为系统返回的原始字符串,不得改写、截断或格式化。
63
+
64
+ ## Query 示例及输出
65
+
66
+ ### 示例 1: 暂停后台执行中的任务(已知任务ID)
67
+ **用户输入**: "暂停后台的应用操作"
68
+
69
+ **工具**: "gui.pause"
70
+
71
+ **JSON 参数**:
72
+ ```json
73
+ {
74
+ "task_id": "1234567890"
75
+ }
76
+ ```
77
+
78
+ **Windows (Cmd) 执行命令**:
79
+ ```bash
80
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"1234567890\\"}"'
81
+ ```
82
+
83
+ **Linux (Bash) 执行命令**:
84
+ ```bash
85
+ openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"1234567890"}'
86
+ ```
87
+
88
+ ---
89
+
90
+ ### 示例 2: 暂停当前GUI执行(使用上一个未结束任务)
91
+ **用户输入**: "先暂停当前的GUI执行"
92
+
93
+ **工具**: "gui.pause"
94
+
95
+ **JSON 参数**:
96
+ ```json
97
+ {
98
+ "task_id": "gui-20240408-01"
99
+ }
100
+ ```
101
+
102
+ **Windows (Cmd) 执行命令**:
103
+ ```bash
104
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"gui-20240408-01\\"}"'
105
+ ```
106
+
107
+ **Linux (Bash) 执行命令**:
108
+ ```bash
109
+ openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"gui-20240408-01"}'
110
+ ```
111
+
112
+ ---
113
+
114
+ ### 示例 3: 暂停自动化点按流程
115
+ **用户输入**: "把刚才的自动化点按流程停一下"
116
+
117
+ **工具**: "gui.pause"
118
+
119
+ **JSON 参数**:
120
+ ```json
121
+ {
122
+ "task_id": "task_98765"
123
+ }
124
+ ```
125
+
126
+ **Windows (Cmd) 执行命令**:
127
+ ```bash
128
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"task_98765\\"}"'
129
+ ```
130
+
131
+ **Linux (Bash) 执行命令**:
132
+ ```bash
133
+ openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"task_98765"}'
134
+ ```
135
+
136
+ ---
137
+
138
+ ### 示例 4: 暂停,待命令再继续
139
+ **用户输入**: "先别动,等我说继续再跑"
140
+
141
+ **工具**: "gui.pause"
142
+
143
+ **JSON 参数**:
144
+ ```json
145
+ {
146
+ "task_id": "t-001"
147
+ }
148
+ ```
149
+
150
+ **Windows (Cmd) 执行命令**:
151
+ ```bash
152
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"t-001\\"}"'
153
+ ```
154
+
155
+ **Linux (Bash) 执行命令**:
156
+ ```bash
157
+ openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"t-001"}'
158
+ ```
159
+
160
+ ---
161
+
162
+ ### 示例 5: 暂停指定应用场景的GUI任务
163
+ **用户输入**: "暂停抖音店铺浏览任务"
164
+
165
+ **工具**: "gui.pause"
166
+
167
+ **JSON 参数**:
168
+ ```json
169
+ {
170
+ "task_id": "9f2a1c3e"
171
+ }
172
+ ```
173
+
174
+ **Windows (Cmd) 执行命令**:
175
+ ```bash
176
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"9f2a1c3e\\"}"'
177
+ ```
178
+
179
+ **Linux (Bash) 执行命令**:
180
+ ```bash
181
+ openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"9f2a1c3e"}'
182
+ ```
183
+
184
+ ---
185
+
186
+ **注意**:
187
+ - 返回给用户的回复话术严禁包含完整的 `task_id`,以免泄露隐私。
188
+ - 回复话术使用简短的task_id,且task_id不能被特殊字符包裹,例如:成功暂停了任务55cd5faf-2871-468c-86bc-415b24ee0cc4,应该返回的回复话术为:✅ GUI 任务(55cd5faf)已暂停。
@@ -0,0 +1,192 @@
1
+ ---
2
+ name: gui.terminate
3
+ description: >
4
+ GUI 任务取消工具。用于通过 UI Agent 取消由 gui_task_create 创建且正在执行的 GUI 任务。
5
+ ---
6
+
7
+ # Gui Task Terminate GUI 任务取消
8
+
9
+ ## Tool Command
10
+ ```bash
11
+ gui.terminate
12
+ ```
13
+
14
+ ## 集成工作流
15
+
16
+ ### Step 1: 意图解析与参数组装
17
+ ```
18
+ ┌─────────────────────────────────────────────────────────────┐
19
+ │ 意图识别与参数提取 │
20
+ │ - 识别操作意图: 取消 + GUI 任务 │
21
+ │ - 提取任务ID: 从上下文获取上一个未结束 GUI 任务的 task_id │
22
+ │ - 判断场景: 当前是否为对上一个未结束 GUI 任务的更新/补充 │
23
+ │ - 特殊处理: "取消/停止/终止/结束/中止/打断/别做了" 等同义词│
24
+ │ 统一识别 │
25
+ └─────────────────────────────────────────────────────────────┘
26
+
27
+ ┌─────────────────────────────────────────────────────────────┐
28
+ │ 消歧与槽位填充 │
29
+ │ - 未指定task_id且存在唯一未结束任务时,默认为该任务 │
30
+ │ - task_id缺失且无法从上下文确定时,需向用户追问要取消的任务│
31
+ │ - "停止/终止/结束/打断/不要了" → 映射为取消操作 │
32
+ │ - task_id需为非空字符串,若无效需提示用户 │
33
+ │ - query保持用户原始输入,严禁改写 │
34
+ └─────────────────────────────────────────────────────────────┘
35
+
36
+ ┌─────────────────────────────────────────────────────────────┐
37
+ │ 生成工具调用 │
38
+ │ - 组装 task_id 及可选参数(无) │
39
+ │ - 生成平台特定的命令格式 │
40
+ └─────────────────────────────────────────────────────────────┘
41
+ ```
42
+
43
+ ### Step 2: 执行调用
44
+ - 根据操作系统选择对应的命令格式
45
+ - Windows: Cmd 格式(双引号需转义)
46
+ - Linux: Bash 格式(单引号包裹)
47
+
48
+ ## 参数定义
49
+ ```json
50
+ {
51
+ "task_id": {
52
+ "type": "string",
53
+ "description": "必填参数,任务id,当前query为gui执行,且是对上一个未结束的gui任务的更新、补充,那么则将上一个未结束的gui任务的task_id填入"
54
+ }
55
+ }
56
+ ```
57
+
58
+ ### 参数注意事项
59
+ 1. **同义词/间接表述映射**: 用户口语化表述如“取消/停止/终止/结束/中止/打断/别做了/不要了”均视为取消当前 GUI 任务,映射到填写`task_id`并调用本工具。
60
+ 2. **默认值或缺省行为**: 当存在唯一未结束的 GUI 任务且用户未显式提供`task_id`时,默认使用该任务的`task_id`进行取消。
61
+ 3. **参数依赖与来源**: `task_id`通常来源于由`gui_task_create`创建的最近未结束任务的上下文;如有多个未结束任务,必须让用户明确指定目标任务。
62
+
63
+ ## Query 示例及输出
64
+
65
+ ### 示例 1: 取消正在进行的后台应用操作
66
+
67
+ **用户输入**: "取消后台的应用操作"
68
+
69
+ **工具**: "gui.terminate"
70
+
71
+ **JSON 参数**:
72
+ ```json
73
+ {
74
+ "task_id": "1234567890"
75
+ }
76
+ ```
77
+
78
+ **Windows (Cmd) 执行命令**:
79
+ ```bash
80
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"1234567890\"}"'
81
+ ```
82
+
83
+ **Linux (Bash) 执行命令**:
84
+ ```bash
85
+ openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"1234567890"}'
86
+ ```
87
+
88
+ ---
89
+
90
+ ### 示例 2: 用户切换任务,终止上个 GUI 操作
91
+
92
+ **用户输入**: "直接做下一个任务"
93
+
94
+ **工具**: "gui.terminate"
95
+
96
+ **JSON 参数**:
97
+ ```json
98
+ {
99
+ "task_id": "1234567890"
100
+ }
101
+ ```
102
+
103
+ **Windows (Cmd) 执行命令**:
104
+ ```bash
105
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"1234567890\"}"'
106
+ ```
107
+
108
+ **Linux (Bash) 执行命令**:
109
+ ```bash
110
+ openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"1234567890"}'
111
+ ```
112
+
113
+ ---
114
+
115
+ ### 示例 3: 口语化表达终止操作
116
+
117
+ **用户输入**: "把刚才的 GUI 操作停一下"
118
+
119
+ **工具**: "gui.terminate"
120
+
121
+ **JSON 参数**:
122
+ ```json
123
+ {
124
+ "task_id": "9876543210"
125
+ }
126
+ ```
127
+
128
+ **Windows (Cmd) 执行命令**:
129
+ ```bash
130
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"9876543210\"}"'
131
+ ```
132
+
133
+ **Linux (Bash) 执行命令**:
134
+ ```bash
135
+ openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"9876543210"}'
136
+ ```
137
+
138
+ ---
139
+
140
+ ### 示例 4: 指代“上个任务”的场景
141
+
142
+ **用户输入**: "中止上个图形化任务"
143
+
144
+ **工具**: "gui.terminate"
145
+
146
+ **JSON 参数**:
147
+ ```json
148
+ {
149
+ "task_id": "task-abc-001"
150
+ }
151
+ ```
152
+
153
+ **Windows (Cmd) 执行命令**:
154
+ ```bash
155
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"task-abc-001\"}"'
156
+ ```
157
+
158
+ **Linux (Bash) 执行命令**:
159
+ ```bash
160
+ openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"task-abc-001"}'
161
+ ```
162
+
163
+ ---
164
+
165
+ ### 示例 5: 结束刚才的自动执行
166
+
167
+ **用户输入**: "结束刚才的自动操作"
168
+
169
+ **工具**: "gui.terminate"
170
+
171
+ **JSON 参数**:
172
+ ```json
173
+ {
174
+ "task_id": "last-gui-0001"
175
+ }
176
+ ```
177
+
178
+ **Windows (Cmd) 执行命令**:
179
+ ```bash
180
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"last-gui-0001\"}"'
181
+ ```
182
+
183
+ **Linux (Bash) 执行命令**:
184
+ ```bash
185
+ openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"last-gui-0001"}'
186
+ ```
187
+
188
+ ---
189
+
190
+ **注意**:
191
+ - 返回给用户的回复话术严禁包含完整的 `task_id`,以免泄露隐私。
192
+ - 回复话术使用简短的task_id,且task_id不能被特殊字符包裹,例如:成功终止了任务55cd5faf-2871-468c-86bc-415b24ee0cc4,应该返回的回复话术为:✅ GUI 任务(55cd5faf)已终止。