影刀 CLI 工具使用指南
目录
前言
在影刀 6月份的版本更新 中,就说明下一个大版本会有 CLI 技能工具。其实当时的版本在安装目录中就已经有了cli工具,如图所示,可以搜到对应的文件。

当时工具可能处在开发阶段,没有正式上线。现在 最新版的更新记录 说明工具已变成可用状态,所以我们来看一下都能实现哪些功能。

该工具是 6.3 版本正式推出的。如果你的影刀 RPA 还没有自动更新,可以下载该链接进行手动升级。不同版本的功能效果可能会有差异,以最新版为准。
安装并试用
首先检查 CLI 工具是否存在。打开影刀安装目录,在地址栏中输入 cmd,输入以下命令:
shadowbot.shell-cli system health
输出示例:
PS C:\Program Files\ShadowBot\shadowbot-6.3.6> shadowbot.shell-cli system health
{
"ok": true,
"command": "health",
"timestamp": "2026-08-19T07:32:47Z",
"httpStatus": 200,
"apiCode": 0,
"message": "ok",
"data": {
"service": "console-restapi",
"status": "ready"
}
}
输出以上信息说明 CLI 工具正常。
认识区别

在影刀 CLI 的 帮助文档 中,它区分了 Agent 技能和 CLI 工具,同时对 Agent 技能的调用次数限制为 5 次。
- Agent 技能:通过 WorkBuddy 以对话的形式调用 CLI 工具。
- CLI 工具:自己打开黑窗口手动输入命令。
虽然官方限制 5 次,但我们可以通过 CLI 工具获取命令列表,自行组装相对应的命令,实现想要的功能。
经过测试:这 5 次说的是运行应用的限制,不论是 Agent 调用还是自行调用都会触发。

智能体使用
以 WorkBuddy 为例,第 1 步先进行安装技能。后续就可以以对话的形式调用影刀 RPA 程序。这里不做详细演示,大家可以自行体验。

安装成功后,可以使用对话的形式进行调用。官方虽然有限制,但我经过多次调用发现:
- 查询类指令:没有限制
- 运行应用次数:有限制

CLI 命令行使用
为了支持命令组合,我们先要获取 CLI 的所有命令列表。
获取 CLI 功能列表
第一步可以先获取该 CLI 支持的功能列表,这里借助本地 Agent 让他把功能列表提取为 MD 文档,提示词如下:
在 C:\Program Files\ShadowBot\shadowbot-6.3.6 目录中有个cli工具: shadowbot.shell-cli.exe,
帮我运行 shadowbot.shell-cli.exe -h命令发现该cli的功能, 需要递归获取所有功能子项.
生成中文命令文档到 {md文件路径} 文件中.
…等待 AI 运行…
获取到的命令很多,相关的功能和描述都比较全:

如果你的个人账号运行提示失败,说明当前的影刀 RPA 不是最新版,请升级:
C:\Program Files\ShadowBot\shadowbot-6.2.23> shadowbot.shell-cli console app --page 1 --page-size 10
{
"ok": false,
"command": "apps",
"timestamp": "2026-08-18T13:59:33Z",
"httpStatus": 200,
"apiCode": 5010,
"message": "当前账号不是企业账号,API 不可用"
}
运行一个应用
使用获取到的指令实现手动运行一个应用的效果。
1. 获取账号登录状态
shadowbot.shell-cli.exe auth current
输出:
{
"ok": true,
"command": "account",
"timestamp": "2026-08-18T14:26:08Z",
"httpStatus": 200,
"apiCode": 0,
"message": "ok",
"data": {
"accountType": "PersonalBasic",
"accountTypeCode": "free",
"displayName": "patacc50",
"isEnterprise": false,
"loggedIn": true,
"userId": "7550xxxxxxxx562",
"userName": "patacc50"
}
}
2. 获取应用列表
shadowbot.shell-cli.exe console app
输出:
PS C:\Program Files\ShadowBot\shadowbot-6.3.6> shadowbot.shell-cli.exe console app
{
"ok": true,
"command": "apps",
"timestamp": "2026-08-19T07:46:46Z",
"httpStatus": 200,
"apiCode": 0,
"message": "ok",
"data": {
"appType": "developed",
"items": [
{
"appId": "0dfeb70f-80f6-4507-babd-e4783bcdb3da",
"appName": "初级考试-题型F-可复制",
"appType": "developed",
"flowParamInfo": [],
"groupId": null,
"ownerName": "",
"updateTime": "2026-08-19T15:45:25",
"versionId": "0b0161b6-0190-442c-997a-cbd71e63f846"
},
{
"appId": "3d4571dd-0231-401e-96b3-bf327746bbea",
"appName": "ai测试",
"appType": "developed",
"flowParamInfo": [],
"groupId": null,
"ownerName": "",
"updateTime": "2026-08-19T15:38:29",
"versionId": "5631b073-06de-4ef2-a0e8-618c925a5e9e"
}
],
"page": 1,
"pageSize": 20
}
}
3. 运行一个应用
PS C:\Program Files\ShadowBot\shadowbot-6.3.6> shadowbot.shell-cli.exe console task run --app-id 3d4571dd-0231-401e-96b3-bf327746bbea
[task-log] 2026-08-19 15:47:43.755 [信息] 开始执行...
[task-log] 2026-08-19 15:47:43.755 [信息] 及格
[task-log] 2026-08-19 15:47:43.757 [信息] 执行结束
[task-summary] taskId=6400c173-bb34-4bc0-915f-18fd8fa78a5f durationMs=3066 success=true
在没有触发5条限制之前运行应用,可以在控制台中查看相对应的状态和日志,还是比较方便的。
切换账号
使用账号登录命令之前,需要先退出当前账号,同时关闭影刀程序。
// 使用指定账户密码登录
shadowbot.shell-cli auth login --username alice --password 123456
// 使用已登录过的账号登录
shadowbot.shell-cli auth login --username melancholyst44735
// 如果未退出会提示:
{
"ok": true,
"command": "login",
"timestamp": "2026-08-19T09:12:58Z",
"message": "当前账号已登录",
"data": {
"userName": "码上RPA_演示"
}
}
自制工作台
既然本地调用 CLI 工具不限次数,同时我们也有了工具文档,那么我们可以让 AI 帮我们生成一个符合自己业务的工作台。
提示词如下:
阅读 cli技能列表.md 这个文件 我需要根据这个文档,用 Python 制作一个 exe 程序。具体需求如下:
1. 启动与配置:
程序打开后的第一步,需要输入该 CLI 命令的绝对位置(支持选择)。
2. 界面布局与功能调度:
按照主功能区域在页面上划分不同的展示风格,点击后展示不同的主命令。该 exe 程序需针对不同的按钮实现不同的调度功能。具体分类如下:
(a) 账号类:展示当前账号、登录账号、账号列表。
(b) 应用分类:展示搜索应用、获取应用、获取应用详情、运行应用。
(c) 技能列表:里面有数百条命令,只需挑选核心的数十条进行实现即可。
3. 界面美化:
需保证 exe 程序符合影刀 RPA 的审美风格,使用界面美化技术,让界面易用。
生成效果如下:

工作台的内容可以根据自己业务需求做自定义。比如对运维人员,可以偏重于日志查看、错误处理、运行次数等功能。
AI 对话功能
同时这个版本也更新了 AI 对话。之前的 AI 创建流程我是没用过的,这次它放到了右边栏,每次打开应用就会自动弹出。我写了一个简单的指令,运行结果如图。

指令:
帮我用影刀浏览器打开 https://shop.yingdao.com/list/table-list 页面, 进行判断是否需要登录.
用可视化指令的方式实现
可以看到,目前还有以下问题:
- 我让他用影刀浏览器生成可视化指令,但最终结果用的却是默认浏览器。
- 第一次我没跟他说用可视化指令的方式实现,他只是给我做了一个答复。就相当于你问了他一个问题,他给你一个回答,并没有生成代码。
目前简单指令消耗的积分并不高,现在每周有 600 积分,一般够用。
结束
相关文件和提示词已放入评论区中.


55

被折叠的 条评论
为什么被折叠?



