@honor-claw/yoyo 1.2.0 → 1.2.1-beta.0

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@honor-claw/yoyo",
3
- "version": "1.2.0",
3
+ "version": "1.2.1-beta.0",
4
4
  "description": "OpenClaw Honor Yoyo connection plugin",
5
5
  "keywords": [
6
6
  "ai",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: yoyo_phone_control
3
3
  version: 1.0.0
4
- description: 通过YOYO操作手机系统用机功能,包括打开/关闭/卸载应用、发送/查找短信、拨打电话、搜索联系人、搜索通话记录、创建/打开/查询/关闭/删除闹钟、创建/添加/新建日程、录音、截屏、屏幕录制、调节音量、屏幕亮度调节、切换响铃/静音/勿扰/护眼/深色模式、管理移动数据或热点或蓝牙或WLAN、进行本地内容搜索、文件发送、调用相机拍照/录像、电池状态/电量查询与、开启/关闭定位服务、开启/关闭NFC功能、开启/关闭自动亮屏功能、USB共享网络、设备电源状态与屏幕状态控制、状态栏显示信息管理与控制等。
4
+ description: 通过YOYO操作手机系统用机功能,包括打开/关闭/卸载应用、发送/查找短信、拨打电话、搜索联系人、搜索通话记录、创建/打开/查询/关闭/删除闹钟、创建/添加/新建日程、录音、截屏、屏幕录制、调节音量、屏幕亮度调节、切换响铃/静音/勿扰/护眼/深色/飞行模式、管理移动数据或热点或蓝牙或WLAN、进行本地内容搜索、文件发送、调用相机拍照/录像、电池状态/电量查询与、开启/关闭定位服务、开启/关闭NFC功能、开启/关闭自动亮屏功能、USB共享网络、设备电源状态与屏幕状态控制、状态栏显示信息管理与控制、进行扫码操作、控制手机的手电筒、清理和维护设备扬声器、机票监控、查快递等。
5
5
  metadata: { "openclaw": { "emoji": "📱", "always": true } }
6
6
  ---
7
7
 
@@ -14,6 +14,8 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
14
14
  3. 使用正确的节点标识符、命令和参数调用节点方法
15
15
  4. 展示结果并确认操作是否成功
16
16
 
17
+ [MANDATORY] 在Windows环境下,无论遇到什么错误,**严禁使用** `openclaw gateway stop` 或 `openclaw gateway start` 或 `openclaw gateway restart`命令关闭/启动/重启网关,这些操作会导致手机执行任务失败。
18
+
17
19
  ## 步骤 1:确定目标设备
18
20
 
19
21
  **Command**: `openclaw nodes status`
@@ -107,7 +109,7 @@ Before executing any device control operation, you **MUST** consult the correspo
107
109
  | `schedule` | `references/schedule-search.md` | 日程查询工具。用于查询设备上已创建的日程安排,支持按时间、内容等多维度检索。 当用户询问"查看/查询/搜索日程"等意图时调用。用于搜索日程的工具。当用户意图涉及查找日程/安排时,属于查询日程。 |
108
110
  | `schedule` | `references/schedule-delete.md` | 日程删除工具。用于删除设备上已创建的日程安排,支持删除指定日程。当用户询问"删除/移除/取消日程"等意图时调用。用于删除日程的工具。当用户意图涉及移除日程/安排时,属于删除日程。 |
109
111
  | `schedule` | `references/schedule-update.md` | 日程编辑修改工具。用于修改设备上已创建日程的属性,支持修改时间、内容、地点等。当用户询问"修改/编辑/更改日程"等意图时调用。用于更新日程的工具。当用户意图涉及修改日程/安排属性时,属于编辑修改日程。 |
110
- | `wlan` | `references/wlan.md` | WLAN(无线网络、WiFi)管理工具。提供对WLAN及其相关能力的统一管理与控制,支持WLAN的开启与关闭、参数设置与状态查询,并可对WLAN使用的流量与流量提醒进行管理。 |
112
+ | `wlan` | `references/wlan.md` | WLAN(无线网络、WiFi)管理工具。提供对WLAN及其相关能力的统一管理与控制,支持WLAN的开启与关闭、参数设置与状态查询,支持连接到指定WLAN网络,并可对WLAN使用的流量与流量提醒进行管理。 |
111
113
  | `bluetooth` | `references/bluetooth.md` | 蓝牙设备管理工具。提供蓝牙设备的统一管理与控制,支持蓝牙的打开/关闭、参数设置、状态查询、设备搜索与配对,并能管理已接收的蓝牙文件。 |
112
114
  | `location-service` | `references/location-service.md` | 设备定位服务管理工具。支持开启/关闭定位、设置相关权限或策略,并查询当前定位服务状态。 |
113
115
  | `nfc` | `references/nfc.md` | 设备 NFC 管理与控制工具。支持开启/关闭、设置使用策略与参数、查询当前状态,以及基于 NFC 的刷卡感应操作。 |
@@ -121,6 +123,13 @@ Before executing any device control operation, you **MUST** consult the correspo
121
123
  | `battery` | `references/battery.md` | 设备电量与模式管理工具。支持设置、查询、打开或关闭电量相关功能,包括电量使用情况与剩余电量查询、性能/省电/超级省电模式切换、进入各类与电量相关的设置页面,以及电量百分比显示位置配置。支持多种设备的电量查询与模式切换,如蓝牙设备。 |
122
124
  | `audio-record` | `references/audio-record.md` | 统一管理设备音频录制功能,支持录音、通话录音、播放与文件管理;可执行录制启停、播放控制及内容增删等操作。 |
123
125
  | `camera` | `references/camera.md` | 相机控制工具。支持拍照、录像、自拍与模式的设置/查询/开启/关闭,使用时需明确动作类型、目标对象,并按需指定模式与摄像头。 |
126
+ | `scan-code` | `references/scan-code.md` | 扫码工具。调用系统相机或指定应用内的扫码功能,适用于扫描二维码/条形码以实现信息获取、登录、支付、页面跳转等操作。 |
127
+ | `flashlight` | `references/flashlight.md` | 手电筒控制工具。支持开启/关闭、设置闪光灯模式、查询当前状态,并可结合指定应用执行。 |
128
+ | `airplane-mode` | `references/airplane-mode.md` | 飞行模式管理工具。支持开启/关闭、设置与查询,并可结合指定应用执行。 |
129
+ | `clean-dirty` | `references/clean-dirty.md` | 扬声器清理维护工具。通过播放特定音频振动清除扬声器孔洞中的灰尘或水分,改善音质,支持启动、停止两类操作。 |
130
+ | `flight-monitor` | `references/flight-monitor-create.md` | 创建机票价格监控任务。支持设置目的地、出发地、监控时间段与目标价格,缺省或低于最低监控价时给出价格区间与建议价。只支持飞机票价的监控任务创建,其余票务类型(如酒店、机票联程、火车票等)暂不支持。 |
131
+ | `flight-monitor` | `references/flight-monitor-search.md` | 查询用户已创建的机票价格监控任务,支持按出发地、目的地、监控日期与任务状态筛选。只支持飞机票价的监控任务查询,其余票务类型(如酒店、机票联程、火车票等)暂不支持。 |
132
+ | `express` | `references/express-logistics-search.md` | 快递查询工具。支持查询指定城市的快递信息,包括快递单号、快递公司、快递状态、送达时间、送达地址。 |
124
133
 
125
134
 
126
135
  ### Command and Parameters Construction Workflow
@@ -282,6 +291,7 @@ Before executing any command, you **MUST** detect the current platform and use t
282
291
  | **Connection Error** | Network or gateway issue | Verify gateway running; check network connectivity | ✅ YES | 3 |
283
292
  | **Timeout** | Operation took too long | Wait 2 seconds before retry | ✅ YES | 3 |
284
293
  | **Temporary Failure** | Transient device error | Wait 1 second before retry | ✅ YES | 3 |
294
+ | **Unsupported Node's Caps** | Node does not support the command | Re-verify node status with `openclaw nodes status` | ✅ YES | 1 |
285
295
 
286
296
  ### Retry Protocol
287
297
 
@@ -0,0 +1,197 @@
1
+ ---
2
+ name: airplane_mode
3
+ description: >
4
+ 飞行模式统一管理工具。支持开启、关闭、查询与设置,并可在指定应用场景下联动控制飞行模式的开启与关闭操作。
5
+ ---
6
+
7
+ # Airplane Mode 飞行模式
8
+
9
+ ## Tool Provider
10
+ ```bash
11
+ com.hihonor.magicvoice
12
+ ```
13
+
14
+ ## Tool Command
15
+ ```bash
16
+ airplane_mode
17
+ ```
18
+
19
+ ## 集成工作流
20
+
21
+ ### Step 1: 意图解析与参数组装
22
+ ```
23
+ ┌─────────────────────────────────────────────────────────────┐
24
+ │ 意图识别与参数提取 │
25
+ │ - 识别操作类型: 设置/查询/打开/关闭 │
26
+ │ - 判断是否涉及应用场景: 当 query 提及具体应用时 │
27
+ │ - 提取修饰词: 应用名称 │
28
+ │ - 特殊处理: "飞行模式/飞机模式/乘机模式"等同义词统一识别 │
29
+ │ - 特殊处理: "开启/打开/启用"→打开,"关闭/停用/退出/不再使用"│
30
+ └─────────────────────────────────────────────────────────────┘
31
+
32
+ ┌─────────────────────────────────────────────────────────────┐
33
+ │ 消歧与槽位填充 │
34
+ │ - 未指定 app 时,默认为系统全局设置生效 │
35
+ │ - 未出现明确动词且难以推断时,需追问确认 actionType │
36
+ │ - app 仅当 query 含具体应用名时填写 │
37
+ │ - "查看/查一下/看看" → 映射为 查询 │
38
+ │ - "设置/调整/改一下" → 映射为 设置 │
39
+ │ - 验证应用名称有效性(如需对特定应用联动) │
40
+ └─────────────────────────────────────────────────────────────┘
41
+
42
+ ┌─────────────────────────────────────────────────────────────┐
43
+ │ 生成工具调用 │
44
+ │ - 组装 actionType 及可选参数(app) │
45
+ │ - 生成平台特定的命令格式 │
46
+ └─────────────────────────────────────────────────────────────┘
47
+ ```
48
+
49
+ ### Step 2: 执行调用
50
+ - 根据操作系统选择对应的命令格式
51
+ - Windows: Cmd 格式(双引号需转义)
52
+ - Linux: Bash 格式(单引号包裹)
53
+
54
+ ## 参数定义
55
+ ```json
56
+ {
57
+ "actionType": {
58
+ "type": "string",
59
+ "enum": ["设置", "查询", "打开", "关闭"],
60
+ "description": "必填参数,飞行模式相关操作的动作类型,用于明确本次指令的主要行为。当涉及调整飞行模式相关配置或联动策略时使用设置;当获取当前飞行模式开启状态或配置信息时使用查询;当要求启用飞行模式功能时使用打开;当要求停用飞行模式功能时使用关闭。"
61
+ },
62
+ "app": {
63
+ "type": "string",
64
+ "description": "指定执行飞行模式相关操作的应用名称。当用户明确要求在某个特定应用场景下开启、关闭或调整飞行模式行为时填写。"
65
+ }
66
+ }
67
+ ```
68
+
69
+ ### 参数注意事项
70
+ 1. **默认值或缺省行为**: 未指定 app 时,默认作用于系统全局飞行模式设置。
71
+ 2. **可选参数填写条件**: 仅当用户明确提及具体应用或应用场景时填写 app,否则不填写。
72
+ 3. **格式/原样保留要求**: app 建议使用用户提及的应用展示名或常用名称,避免自行改写或扩展。
73
+
74
+ ## Query 示例及输出
75
+
76
+ ### 示例 1: 开启飞行模式
77
+
78
+ **用户输入**: "打开飞行模式"
79
+
80
+ **工具**: "airplane_mode"
81
+
82
+ **JSON 参数**:
83
+ ```json
84
+ {
85
+ "actionType": "打开"
86
+ }
87
+ ```
88
+
89
+ **Windows (Cmd) 执行命令**:
90
+ ```bash
91
+ cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"airplane_mode\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"打开\"}}"'
92
+ ```
93
+
94
+ **Linux (Bash) 执行命令**:
95
+ ```bash
96
+ openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"airplane_mode","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"打开"}}'
97
+ ```
98
+
99
+ ---
100
+
101
+ ### 示例 2: 关闭飞行模式
102
+
103
+ **用户输入**: "关闭飞行模式"
104
+
105
+ **工具**: "airplane_mode"
106
+
107
+ **JSON 参数**:
108
+ ```json
109
+ {
110
+ "actionType": "关闭"
111
+ }
112
+ ```
113
+
114
+ **Windows (Cmd) 执行命令**:
115
+ ```bash
116
+ cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"airplane_mode\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"关闭\"}}"'
117
+ ```
118
+
119
+ **Linux (Bash) 执行命令**:
120
+ ```bash
121
+ openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"airplane_mode","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"关闭"}}'
122
+ ```
123
+
124
+ ---
125
+
126
+ ### 示例 3: 打开设置页或调整配置
127
+
128
+ **用户输入**: "进入飞行模式设置页面"
129
+
130
+ **工具**: "airplane_mode"
131
+
132
+ **JSON 参数**:
133
+ ```json
134
+ {
135
+ "actionType": "设置"
136
+ }
137
+ ```
138
+
139
+ **Windows (Cmd) 执行命令**:
140
+ ```bash
141
+ cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"airplane_mode\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"设置\"}}"'
142
+ ```
143
+
144
+ **Linux (Bash) 执行命令**:
145
+ ```bash
146
+ openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"airplane_mode","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"设置"}}'
147
+ ```
148
+
149
+ ---
150
+
151
+ ### 示例 4: 查询当前状态
152
+
153
+ **用户输入**: "查看飞行模式状态"
154
+
155
+ **工具**: "airplane_mode"
156
+
157
+ **JSON 参数**:
158
+ ```json
159
+ {
160
+ "actionType": "查询"
161
+ }
162
+ ```
163
+
164
+ **Windows (Cmd) 执行命令**:
165
+ ```bash
166
+ cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"airplane_mode\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"查询\"}}"'
167
+ ```
168
+
169
+ **Linux (Bash) 执行命令**:
170
+ ```bash
171
+ openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"airplane_mode","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"查询"}}'
172
+ ```
173
+
174
+ ---
175
+
176
+ ### 示例 5: 同义表达的关闭意图
177
+
178
+ **用户输入**: "不再使用乘机模式"
179
+
180
+ **工具**: "airplane_mode"
181
+
182
+ **JSON 参数**:
183
+ ```json
184
+ {
185
+ "actionType": "关闭"
186
+ }
187
+ ```
188
+
189
+ **Windows (Cmd) 执行命令**:
190
+ ```bash
191
+ cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"airplane_mode\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"关闭\"}}"'
192
+ ```
193
+
194
+ **Linux (Bash) 执行命令**:
195
+ ```bash
196
+ openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"airplane_mode","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"关闭"}}'
197
+ ```
@@ -3,7 +3,7 @@ name: capture-screenshot
3
3
  description: >
4
4
  截屏功能管理与触发工具。提供对截屏功能的管理与触发能力,
5
5
  支持将当前手机屏幕内容以图片的形式保存,
6
- 仅支持普通截屏操作。
6
+ 支持普通截屏与滚动截屏操作。
7
7
  ---
8
8
 
9
9
  # Capture Screenshot 截屏管理
@@ -21,16 +21,18 @@ capture-screenshot
21
21
  ```
22
22
  ┌─────────────────────────────────────────────────────────────┐
23
23
  │ 意图识别与参数提取 │
24
- │ - 识别操作类型: 截屏
24
+ │ - 识别操作类型: 截屏/滚动截屏
25
25
  │ - 提取修饰词: 应用名称 │
26
+ │ - 判断是否需要滚动长图: 提到长图/滚动则选择滚动截屏 │
26
27
  │ - 特殊处理: "保存屏幕/屏幕截图/截图" → 映射为截屏 │
27
- │ - 特殊处理: "长截图/滚动截图/长图/滚动截屏" → 不支持,提示用户
28
+ │ - 特殊处理: "长截图/滚动截图/长图/滚动截屏" → 映射为滚动截屏
28
29
  └─────────────────────────────────────────────────────────────┘
29
30
 
30
31
  ┌─────────────────────────────────────────────────────────────┐
31
32
  │ 消歧与槽位填充 │
32
33
  │ - 应用级操作需验证应用名称有效性 │
33
- │ - 如用户请求滚动截屏,应友好提示当前仅支持普通截屏
34
+ │ - app仅当query含特定应用名称时填写
35
+ │ - "长截图/长图/滚动截图" → 映射为滚动截屏 │
34
36
  └─────────────────────────────────────────────────────────────┘
35
37
 
36
38
  ┌─────────────────────────────────────────────────────────────┐
@@ -51,7 +53,7 @@ capture-screenshot
51
53
  | 用户意图 | 关键词示例 | actionType | 可选参数 | 备注 |
52
54
  | :----------- | :---------------------------- | :--------- | :------- | :----------------- |
53
55
  | **普通截屏** | 截屏/截图/保存屏幕/屏幕截图 | `截屏` | `app` | 支持 |
54
- | **滚动截屏** | 滚动截屏/长截图/滚动截图/长图 | - | - | 不支持,需提示用户 |
56
+ | **滚动截屏** | 滚动截屏/长截图/滚动截图/长图 | `滚动截屏` | `app` | 支持 |
55
57
 
56
58
  ## 参数定义
57
59
 
@@ -59,8 +61,8 @@ capture-screenshot
59
61
  {
60
62
  "actionType": {
61
63
  "type": "string",
62
- "enum": ["截屏"],
63
- "description": "必填参数,截屏相关操作的动作类型,用于明确本次指令的主要行为。不支持滚动截屏!!"
64
+ "enum": ["截屏", "滚动截屏"],
65
+ "description": "必填参数,截屏相关操作的动作类型,用于明确本次指令的主要行为。当需要对当前屏幕内容进行一次性截图保存时使用截屏;当需要对可上下滚动的长页面内容进行连续截图并合成为长图时使用滚动截屏。"
64
66
  },
65
67
  "app": {
66
68
  "type": "string",
@@ -71,9 +73,7 @@ capture-screenshot
71
73
 
72
74
  ### 参数注意事项
73
75
 
74
- 1. **仅支持普通截屏**: 当前仅支持普通截屏操作,不支持滚动截屏
75
- 2. **滚动截屏处理**: 当用户请求滚动截屏、长截图、长图等相关操作时,应友好提示用户当前仅支持普通截屏功能
76
- 3. **同义词映射**: "截图"、"保存屏幕"、"屏幕截图"等表述均应映射为截屏操作
76
+ 1. **同义词映射**:用户口语如"截图"、"屏幕截图"、"保存屏幕",则将`actionType`统一映射为"截屏";"长截图"、"长图"、"滚动截图"、"滚动截屏",则将`actionType`统一映射为"滚动截屏"。
77
77
 
78
78
  ## Query 示例及输出
79
79
 
@@ -105,13 +105,26 @@ openclaw nodes invoke --node <ID> --command capture-screenshot --params '{"actio
105
105
 
106
106
  ---
107
107
 
108
- ### 示例 2: 滚动截屏(不支持)
108
+ ### 示例 2: 滚动截屏(直接指令)
109
109
 
110
110
  **用户输入**: "滚动截屏"
111
111
 
112
- **处理方式**: 提示用户当前仅支持普通截屏,询问是否执行普通截屏
112
+ **工具**: "capture-screenshot"
113
+
114
+ **JSON 参数**:
115
+ ```json
116
+ {"actionType":"滚动截屏"}
117
+ ```
118
+
119
+ **Windows (Cmd) 执行命令**:
120
+ ```bash
121
+ cmd /c 'openclaw nodes invoke --node <ID> --command capture-screenshot --params "{\"actionType\":\"滚动截屏\"}"'
122
+ ```
113
123
 
114
- **系统响应**: 抱歉,当前不支持滚动截屏功能,仅支持普通截屏。是否需要为您执行普通截屏?
124
+ **Linux (Bash) 执行命令**:
125
+ ```bash
126
+ openclaw nodes invoke --node <ID> --command capture-screenshot --params '{"actionType":"滚动截屏"}'
127
+ ```
115
128
 
116
129
  ---
117
130
 
@@ -143,15 +156,12 @@ openclaw nodes invoke --node <ID> --command capture-screenshot --params '{"actio
143
156
 
144
157
  ---
145
158
 
146
- ### 示例 4: 长截图请求(不支持)
159
+ ### 示例 4: 长截图请求
147
160
 
148
161
  **用户输入**: "我想要长截图"
149
162
 
150
- **处理方式**: 提示用户当前仅支持普通截屏,询问是否执行普通截屏
163
+ **工具**: "capture-screenshot"
151
164
 
152
- <<<<<<< Updated upstream
153
- **系统响应**: 抱歉,当前不支持长截图(滚动截屏)功能,仅支持普通截屏。是否需要为您执行普通截屏?
154
- =======
155
165
  **JSON 参数**:
156
166
 
157
167
  ```json
@@ -172,8 +182,6 @@ cmd /c 'openclaw nodes invoke --node <ID> --command capture-screenshot --params
172
182
  openclaw nodes invoke --node <ID> --command capture-screenshot --params '{"actionType":"滚动截屏"}'
173
183
  ```
174
184
 
175
- > > > > > > > Stashed changes
176
-
177
185
  ---
178
186
 
179
187
  ### 示例 5: 描述性截屏指令
@@ -0,0 +1,163 @@
1
+ ---
2
+ name: clean_dirty
3
+ description: >
4
+ 扬声器清理维护工具。通过播放特定音频振动清除扬声器孔洞中的灰尘或水分,改善音质,
5
+ 支持启动、停止两类操作。
6
+ ---
7
+
8
+ # Clean Dirty 扬声器清理
9
+
10
+ ## Tool Provider
11
+ ```bash
12
+ com.hihonor.magicvoice
13
+ ```
14
+
15
+ ## Tool Command
16
+ ```bash
17
+ clean_dirty
18
+ ```
19
+
20
+ ## 集成工作流
21
+
22
+ ### Step 1: 意图解析与参数组装
23
+ ```
24
+ ┌─────────────────────────────────────────────────────────────┐
25
+ │ 意图识别与参数提取 │
26
+ │ - 识别操作类型: 打开/关闭 │
27
+ │ - 提取修饰词: 应用名称 │
28
+ │ - 特殊处理: "清灰/清理灰尘/排水/清理话筒" → 映射为打开 │
29
+ │ - 特殊处理: "停止/结束/关闭清灰/停一下" → 映射为关闭 │
30
+ └─────────────────────────────────────────────────────────────┘
31
+
32
+ ┌─────────────────────────────────────────────────────────────┐
33
+ │ 消歧与槽位填充 │
34
+ │ - 未指定操作类型时,需根据动词意图推断;无法判定时追问用户 │
35
+ │ - app仅当用户明确指定具体应用/系统工具时填写 │
36
+ │ - "切换/启用/开始" → 映射为打开 │
37
+ │ - "停止/关闭/退出" → 映射为关闭 │
38
+ │ - 应用级操作需验证应用名称有效性 │
39
+ └─────────────────────────────────────────────────────────────┘
40
+
41
+ ┌─────────────────────────────────────────────────────────────┐
42
+ │ 生成工具调用 │
43
+ │ - 组装 actionType 及可选参数(app) │
44
+ │ - 生成平台特定的命令格式 │
45
+ └─────────────────────────────────────────────────────────────┘
46
+ ```
47
+
48
+ ### Step 2: 执行调用
49
+ - 根据操作系统选择对应的命令格式
50
+ - Windows: Cmd 格式(双引号需转义)
51
+ - Linux: Bash 格式(单引号包裹)
52
+
53
+ ## 参数定义
54
+ ```json
55
+ {
56
+ "actionType": {
57
+ "type": "string",
58
+ "enum": ["打开", "关闭"],
59
+ "description": "必填参数,扬声器清理相关操作的核心动作类型。当开始执行扬声器清理或排水流程时使用打开;当停止当前清理流程或结束声音播放时使用关闭。"
60
+ },
61
+ "app": {
62
+ "type": "string",
63
+ "description": "指定执行扬声器清理相关操作的应用名称。当明确要求在某个系统维护工具或特定应用中启动清灰功能时填写。"
64
+ }
65
+ }
66
+ ```
67
+
68
+ ### 参数注意事项
69
+ 1. 同义词/间接表述映射: 常见口语到`actionType`的映射示例——“清灰/清理灰尘/排水/清理话筒/一键清灰/激活清灰”→ 打开;“停止/结束/关闭清灰/停一下”→ 关闭。
70
+ 2. 可选参数填写条件: `app`仅当用户明确提及具体系统维护工具或应用时填写,不做主观推断;未提及时不填写`app`。
71
+ 3. **用户特殊要求**:当用户要求加大清洁力度或使用更大力度时,提醒用户当前已经是最大马力了;如果用户要求减弱清洁力度或使用更轻力度时,提醒用户当前暂不支持清洁力度调节。
72
+
73
+ ## Query 示例及输出
74
+
75
+ ### 示例 1: 启动清灰流程
76
+
77
+ **用户输入**: "清理灰尘"
78
+
79
+ **工具**: "clean_dirty"
80
+
81
+ **JSON 参数**:
82
+ ```json
83
+ {"actionType":"打开"}
84
+ ```
85
+
86
+ **Windows (Cmd) 执行命令**:
87
+ ```bash
88
+ cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"clean_dirty\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"打开\"}}"'
89
+ ```
90
+
91
+ **Linux (Bash) 执行命令**:
92
+ ```bash
93
+ openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"clean_dirty","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"打开"}}'
94
+ ```
95
+
96
+ ---
97
+
98
+ ### 示例 2: 一键清灰启动
99
+
100
+ **用户输入**: "一键清灰"
101
+
102
+ **工具**: "clean_dirty"
103
+
104
+ **JSON 参数**:
105
+ ```json
106
+ {"actionType":"打开"}
107
+ ```
108
+
109
+ **Windows (Cmd) 执行命令**:
110
+ ```bash
111
+ cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"clean_dirty\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"打开\"}}"'
112
+ ```
113
+
114
+ **Linux (Bash) 执行命令**:
115
+ ```bash
116
+ openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"clean_dirty","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"打开"}}'
117
+ ```
118
+
119
+ ---
120
+
121
+ ### 示例 3: 清理麦克风/话筒部位的异物
122
+
123
+ **用户输入**: "清理话筒"
124
+
125
+ **工具**: "clean_dirty"
126
+
127
+ **JSON 参数**:
128
+ ```json
129
+ {"actionType":"打开"}
130
+ ```
131
+
132
+ **Windows (Cmd) 执行命令**:
133
+ ```bash
134
+ cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"clean_dirty\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"打开\"}}"'
135
+ ```
136
+
137
+ **Linux (Bash) 执行命令**:
138
+ ```bash
139
+ openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"clean_dirty","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"打开"}}'
140
+ ```
141
+
142
+ ---
143
+
144
+ ### 示例 4: 切换为清灰激活状态
145
+
146
+ **用户输入**: "将清灰模式切换为不可用状态"
147
+
148
+ **工具**: "clean_dirty"
149
+
150
+ **JSON 参数**:
151
+ ```json
152
+ {"actionType":"关闭"}
153
+ ```
154
+
155
+ **Windows (Cmd) 执行命令**:
156
+ ```bash
157
+ cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"clean_dirty\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"关闭\"}}"'
158
+ ```
159
+
160
+ **Linux (Bash) 执行命令**:
161
+ ```bash
162
+ openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"clean_dirty","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"关闭"}}'
163
+ ```