命令行

CLI 是公开 REST API 的客户端，安装后有两个等价命令：embodiflow 和 ef。标准输出不是终端时输出 JSON；可加 --json 强制 JSON，或用 --output table 输出表格。所有命令都支持 --api-base-url <url> 和 --profile <name>。

安装

包名为 @embodiflow/cli，发布在组织的 GitHub Packages 仓库，需要有读取权限。

npm install --global @embodiflow/cli --registry=https://npm.pkg.github.com
embodiflow --help

登录

auth login 打开浏览器登录。--pat 粘贴个人访问令牌，--pat-stdin 在自动化中从标准输入读取。默认 API 地址指向开发环境，请传入你自己的地址。

embodiflow auth login --base-url https://api.embodiflow.com
embodiflow whoami --json

whoami 显示邮箱、当前团队、令牌类型、权限范围和过期时间。embodiflow auth logout 删除已保存的凭据，embodiflow config doctor 检查连通性。

主要命令

项目

embodiflow projects list --json

embodiflow projects create --name "Pick and place"

上传

embodiflow uploads create --project-id <project-id> --source-path ./recordings

uploads plan 使用相同的 --source-path，只输出只读计划。recordings upload <path> --project <team>/<project> 创建一条命名录制。

工作流运行

embodiflow workflow runs list --project-id <project-id>

embodiflow workflow runs wait <run-id>

导出与下载

embodiflow exports create --project-id <project-id> --version-number 1

embodiflow versions download <team>/<project>@1 --format lerobot-v3

exports status、exports wait、exports download 需要 --project-id、--version-number 和 --export-id。resolve <ref> 把 team/project@n 引用解析成 ID。

训练

embodiflow training jobs list --project-id <project-id>

Webhook

embodiflow webhook-endpoints create --url https://example.com/hooks --event-types workflow.run.succeeded

签名密钥只显示一次。校验投递的方法见「签名校验」。

查看更多

embodiflow schema commands --json
embodiflow <command> --help

schema commands 输出机器可读的命令注册表，本页即以它为准。

退出码

• 0 成功。
• 1 命令失败：API 错误、校验失败、未找到或未登录。
• 2 用法错误：未知命令或缺少参数。