| 说明 | 创建一个按 cron 表达式定期运行 Kit 的定时任务 |
| 用法 | sbx schedule create KIT [flags] |
描述
创建一个定时任务：每个 cron 时点都从 KIT 启动一个云端沙箱，并在其中 执行 --prompt 或 --command 中的一个。
KIT 可以是 claude 这样的智能体名称，也可以是 oci:// 形式的 Kit 引用。每次运行的沙箱 除 Kit 自身和 --allow-network 之外，拒绝所有出站流量。
选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--allow-network | 每次运行的沙箱可以访问的网络规则（可重复传入）；其余出站流量一律拒绝 | |
--command | 每次运行执行的 shell 命令 | |
--cpus | 0 | 每次运行的沙箱使用的 CPU 数量（默认取 Kit 的设置） |
--cron | 控制运行开始时间的五段 cron 表达式，例如 "0 9 * * 1-5" | |
--deny-network | 在 --allow-network 范围内要拒绝的网络规则（可重复传入） | |
--description | 定时任务的描述 | |
--enabled | true | 按 cron 表达式定期启动运行；--enabled=false 会暂停该定时任务 |
-e, --env | 为每次运行设置环境变量（可重复传入）：KEY=VALUE | |
--env-file | 从文件读取环境变量（可重复传入）。--env 的优先级高于任何文件；多个文件时，后传入的优先 | |
--max-run-duration | 0s | 单次运行的最长时长，至少 1h，例如 2h30m（默认 1h） |
-m, --memory | 每次运行的沙箱使用的内存，例如 8g（默认取 Kit 的设置） | |
--name | 定时任务的名称 | |
--platform | 每次运行的沙箱使用的平台：linux/amd64 或 linux/arm64 | |
--prompt | 每次运行传给 Kit 智能体的提示词 | |
--static-mcp | 每次运行的沙箱使用的云端 MCP gateway 服务器，逗号分隔或重复传入 | |
--timezone | 计算 cron 表达式时使用的 IANA 时区，例如 Europe/Berlin | |
--working-dir | 运行提示词或命令时所在的工作目录 |
全局选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--cloud | 改为调用 Docker Cloud Sandboxes API，而不是本地 sandboxd（支持的动词正在逐步增加，运行 sbx --cloud --help 查看当前列表） | |
-D, --debug | 启用调试日志 | |
--no-input | 从不提示；需要应答的命令会直接失败，并给出应当运行的命令 |
示例
console
sbx --cloud schedule create claude --name nightly-tests --cron "0 2 * * *" --prompt "Run the tests and fix failures"
sbx --cloud schedule create shell --name cleanup --cron "*/30 * * * *" --timezone Europe/Berlin --command "make clean"参见
sbx schedule— 管理定时运行的云端沙箱（仅云端）