Skyvern CLI 上手指南：从启动到任务管理，只用终端搞定

Skyvern CLI 上手指南：从启动到任务管理，只用终端搞定

【免费下载链接】skyvernAutomate browser based workflows with AI项目地址: https://gitcode.com/GitHub_Trending/sk/skyvern

不打开网页，在终端敲几条命令，Skyvern 就能自己打开浏览器、点页面、提取数据。Skyvern 是 AI 驱动的浏览器自动化项目，而 Skyvern CLI 是它的命令行入口，装好之后从起服务到跑工作流全在终端里完成。

先跑起来

Skyvern CLI 的 Docker 路径需要本机装好 Docker 并在运行。最短路径：

git clone https://gitcode.com/GitHub_Trending/sk/skyvern cd skyvern skyvern quickstart

skyvern quickstart会检查 Docker、初始化环境（装 Chromium、配 LLM）、然后拉起 Postgres 和后端服务。中途提示是否立即启动服务，按回车确认即可。如果只想要 API 不想带 UI，加--server-only；已有自己的数据库就加--database-string跳过 Postgres 容器。初始化逻辑在 skyvern/cli/quickstart.py，遇到卡住时顺着它排查最快。

日常怎么用

一条命令启动所有服务

首次之后，服务用run家族管理：

skyvern run all # API（8000）+ UI（8080） skyvern run server # 只起 API skyvern run ui # 只起 UI

run all内部并行拉起两个进程（skyvern/cli/run_commands.py），run ui会先查端口占用，冲突时提示你处理。

怎么跑一次工作流

先看自己有哪些工作流，再带参数跑起来：

skyvern workflow list skyvern workflow run --id wpid_xxx --params '{"url": "https://example.com"}' --wait

--id传工作流的 wpid_ 前缀 ID；--wait让命令阻塞到跑完再返回，方便脚本化。不想要终端里等结果，就换--webhook给个回调地址。

怎么盯一个正在跑的任务

skyvern workflow status --run-id wr_xxx skyvern tasks list --workflow-run-id wr_xxx

前者查整次运行的状态，后者列出这次运行拆出的各个任务。run ID 是wr_开头、任务 ID 是tsk_v2_开头，别混了。

怎么取消跑偏的工作流

skyvern workflow cancel --run-id wr_xxx skyvern stop server --port 8000

前者只停某次运行，后者直接杀 API 服务进程（默认 8000 端口，逻辑在 skyvern/cli/stop_commands.py）。skyvern stop all会把 8000、8080、9090 上的服务一次清干净。

参数速查

再进一步 🚀

跑 Python 脚本：skyvern run code my_script.py -p name=value，三种传参方式（-p、--paramsJSON 字符串、--params-file文件）按文件 > 字符串 >-p的优先级合并。

起 MCP 服务器：skyvern run mcp，默认 stdio 传输，把它接进 Claude 等 MCP 客户端，就能用自然语言驱动浏览器自动化。

收尾

核心流程就是 quickstart → run → workflow run → status/cancel，其余子命令按需查skyvern <子命令> --help。想深入看：

• 项目文档：README.md
• CLI 源码目录：skyvern/cli/
• 开发者文档：docs/developers/

【免费下载链接】skyvernAutomate browser based workflows with AI项目地址: https://gitcode.com/GitHub_Trending/sk/skyvern